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 :
| Niveau | Contenu |
|---|---|
| ERROR | Exceptions Java uniquement |
| WARN | Avertissements + ERROR |
| INFO | Actions utilisateurs + WARN |
| DEBUG | Appels de méthodes + INFO |
| TRACE | Ré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