Logs applicatifs

Fichiers de logs

Par défaut, l’application écrit ses logs dans logs/esup-stage.log (chemin relatif au répertoire d’exécution). La rotation est assurée par Logback :

rotation quotidienne et au-delà de 50 Mo par fichier ;
30 jours d’historique conservés ;
taille totale plafonnée à 2 Go.

Ces valeurs se pilotent par variables d’environnement :

Variable Défaut Description

Variable	Défaut	Description
`ESUP_STAGE_LOG_DIR`	logs	Répertoire des fichiers de logs.
`ESUP_STAGE_LOG_FILE`	`${ESUP_STAGE_LOG_DIR}/esup-stage.log`	Chemin complet du fichier de log actif.
`ESUP_STAGE_LOG_MAX_SIZE`	50MB	Taille maximale d’un fichier avant rotation.
`ESUP_STAGE_LOG_MAX_HISTORY`	30	Nombre de jours d’historique conservés.

ESUP_STAGE_LOG_DIR

logs

Répertoire des fichiers de logs.

ESUP_STAGE_LOG_FILE

${ESUP_STAGE_LOG_DIR}/esup-stage.log

Chemin complet du fichier de log actif.

ESUP_STAGE_LOG_MAX_SIZE

50MB

Taille maximale d’un fichier avant rotation.

ESUP_STAGE_LOG_MAX_HISTORY

Nombre de jours d’historique conservés.

Cas de Docker

Avec Docker, le fichier .env (voir example.env) positionne les logs dans le volume de données pour qu’ils survivent au conteneur et soient visibles depuis l’interface :

DATA_PATH=/usr/local/tomcat/data
ESUP_STAGE_LOG_DIR=${DATA_PATH}/logs
CATALINA_OPTS=-Dlogging.file.name=${ESUP_STAGE_LOG_DIR}/esup-stage.log

Sans le paramètre CATALINA_OPTS ci-dessus, la fonctionnalité de visualisation des logs dans l’interface d’administration ne trouvera pas les fichiers.

Écran « Logs » de l’administration

L’écran « Paramétrage global > Logs » (réservé aux administrateurs) permet, sans accès au serveur :

Consultation en temps réel: Le contenu du fichier de log actif est diffusé en continu dans le navigateur (flux SSE), comme un tail -f.
Navigation dans les fichiers: Liste des fichiers de logs (y compris les fichiers archivés par la rotation) et consultation de leur contenu.
Export: Téléchargement d’un fichier de log, export CSV.
Niveaux de log: Consultation des loggers actifs et modification à chaud du niveau de log (DEBUG, INFO, WARN…) par package, sans redémarrage. Pratique pour diagnostiquer un incident en production.

Pensez à repasser les niveaux de log à leur valeur nominale après un diagnostic : le niveau DEBUG sur un package verbeux peut faire grossir les fichiers très vite.