Aller au contenu principal
Version: Any 26

Journalisation (logback)

Any utilise logback pour la gestion des journaux d'application.

Fichier de configuration​

Le fichier logback.xml se trouve dans :

$TOMCAT_HOME/webapps/any/WEB-INF/classes/logback.xml

Vous pouvez l'externaliser dans any.configurationPath.

Emplacement des fichiers journaux​

Paramètre :

<appender name="file" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>./../../logs/any.log</file>

Le chemin peut être relatif ou absolu.

Exemples :

  • Relatif : ./../../logs/any.log
  • Absolu : /var/log/tomcat/any.log

Stratégie d'archivage​

Par défaut, un nouveau fichier est créé chaque jour et les anciens sont archivés (zip) pendant 5 jours.

<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>./../../logs/any-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
<maxHistory>5</maxHistory>
</rollingPolicy>

Paramètres :

  • fileNamePattern : Format du nom avec date
  • maxHistory : Nombre de jours à conserver

Niveaux de journalisation​

Par défaut : INFO

<root>
<level value="INFO"/>
<appender-ref ref="console"/>
<appender-ref ref="file"/>
</root>

Niveaux disponibles :

NiveauContenu
ERRORExceptions Java uniquement
WARNAvertissements + ERROR
INFOActions utilisateurs + WARN
DEBUGAppels de méthodes + INFO
TRACERésultats détaillés + DEBUG

Format du pattern​

Par défaut :

%date %-5level %8.8(%X{threadIndex}) %-42.42(%X{requestURI}) %-10.10(%X{user}) %-32logger{0} - %message%n

Composants :

  • %date : Date/heure
  • %-5level : Niveau (ERROR, WARN, INFO, etc.)
  • %X{threadIndex} : ID du thread
  • %X{requestURI} : URL du service REST appelé
  • %X{user} : Utilisateur qui a appelé
  • %logger{0} : Classe Java qui enregistre
  • %message : Message de log

Appenders supplémentaires​

Vous pouvez ajouter des appenders pour envoyer les logs par email, par exemple :

<appender name="mail" class="ch.qos.logback.classic.net.SMTPAppender">
<filter class="ch.qos.logback.core.filter.EvaluatorFilter">
<evaluator class="ch.qos.logback.classic.boolex.OnErrorEvaluator"/>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>

<smtpHost>smtp.server.com</smtpHost>
<smtpPort>587</smtpPort>
<SSL>true</SSL>
<username>account@mail.com</username>
<password>password</password>

<from>any-errors@company.com</from>
<to>support@company.com</to>
<subject>[ERROR] %logger{20} - %m</subject>

<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>%date %-5level %8.8(%X{threadIndex}) %-42.42(%X{requestURI}) %-10.10(%X{user}) %-32logger{0} - %message%n</pattern>
</layout>
</appender>

Pour plus de détails : Documentation Logback