# Gestion des traces

## Emplacements par défaut

L’emplacement des fichiers de traces dépend de la méthode d’installation et du système d’exploitation.

Si Waarp Manager a été installé via l’archive autonome, les logs se situent dans le dossier `logs` à la racine du dossier d’extraction.

Si Waarp Manager a été installé en utilisant les packages, les logs sont envoyés au démon syslog du système.

Ils peuvent être consultés dans Si le système utilise systemd, les logs peuvent être consultées avec le programme journalctl, par exemple avec la commande :

    journalctl -u waarp-manager.service

Dans les autres cas, les traces peuvent être trouvées dans le fichier `/var/log/messages`.

Voir aussi

La documentation de journalctl

## Configuration

Les traces de Waarp Manager sont paramétrés dans la section `[log]` du fichier de configuration.

### Niveau et contenu

Le niveau des messages écrits dans les traces est défini dans le paramètre `LogLevel`. Les valeurs possibles sont `DEBUG`, `INFO` (défaut), `WARNING` et `ERROR`.

Les paramètres `LogSqlStatements` et `LogHttpRequests` permettent d’activer ou de désactiver (respectivement) les requêtes SQL exécutées et les requêtes HTTP servies.

### Destination

La destination des traces est définie dans le paramètre `LogTo`, qui peut avoir les valeurs suivantes : `syslog`, `stdout` (défaut), `stderr`, ou le chemin vers un fichier.

Si `LogTo` est défini à `syslog`, la catégorie est définie par le paramètre `SysLogFacility`. Par défaut, `local0` est utilisé.

## Rotation des logs

La rotation des logs est automatique en utilisant syslog (elle est gérée soit par le système, soit par le journalctl).

Quand Waarp Manager est configuré pour écrire ses traces dans un fichier, il peut être utile de configurer la rotation des traces avec logrotate.

Pour ce faire, créez le fichier `/etc/logrotate.d/waarp-manager` avec par le contenu suivant :

    /path/to/waarp-manager.log {
        missingok
        notifempty
        size 10M
        weekly
        compress
        create 0600 waarp waarp
        postrotate
           /usr/bin/killall -USR1 waarp-manager
    }

Note

L’envoi du signal `USR1` à Waarp Manager est nécessaire pour que le programme ré-ouvre le fichier d’écriture des logs après la rotation.