Appender RollingFile "gui-log"

Cet appender gère les logs de l'interface graphique avec rotation automatique des fichiers.

Exemple de configuration :

<Appenders>
    <RollingFile name="gui-log" fileName="logs/gui.log" filePattern="logs/gui-%d{yyyy-MM-dd}.log">
        <PatternLayout pattern="%d %-5p [%t][%c][%X{MDC_SESSION}] - %m%n"/>
        <Policies>
            <SizeBasedTriggeringPolicy size="256MB"/>
        </Policies>
        <DefaultRolloverStrategy max="10"/>
    </RollingFile>
</Appenders>

Exemple de log :

2025-02-05 17:24:11,914 INFO  [qtp1830190936-44][com.okiok.sfiler.java.gui.web.action.Logout][8ac0740e-9bd7-4f8a-b90c-f864fe583508] - Terminating session for user : my-user

Détail des sections :

1. 2025-02-05 17:24:11,914 : Date et heure du log
2. INFO : Niveau de log
3. [qtp1830190936-44] : Nom du thread
4. [com.okiok.sfiler.java.gui.web.action.Logout] : Nom de la classe qui génère le log
5. [8ac0740e-9bd7-4f8a-b90c-f864fe583508] : Identifiant de session utilisateur (depuis le MDC)
6. - Terminating session for user : my-user : Message du log

Configuration de base

La configuration de ce journal se trouve dans l'arborescence suivante : [répertoire d'installation]/gateway/webapps/sfiler-gui-ajax/WEB-INF/classes/log4j2.xml

• Nom: gui-log
• Fichier de sortie: logs/gui.log
• Pattern des fichiers d'archive: logs/gui-[DATE].log

Format des logs

Le pattern %d %-5p [%t][%c][%X{MDC_SESSION}] - %m%n définit le format suivant :

• %d : Date et heure du log
• %-5p : Niveau de log (DEBUG, INFO, ERROR...) aligné sur 5 caractères
• [%t] : Nom du thread
• [%c] : Nom de la classe qui génère le log
• [%X{MDC_SESSION}] : Identifiant de session utilisateur (depuis le MDC)
• %m : Message du log
• %n : Retour à la ligne

Politique de rotation

• SizeBasedTriggeringPolicy: 256MB par fichier
• DefaultRolloverStrategy: Maximum 10 fichiers d'archive
• La rotation crée un nouveau fichier quand :
  • Le fichier actuel atteint 256MB
  • Une nouvelle journée commence (basé sur le pattern de date)

Caractéristiques

• Format particulièrement adapté pour :

  • Le suivi des actions utilisateur dans l'interface
  • Le diagnostic des problèmes d'interface utilisateur
  • L'analyse des sessions utilisateur
  • La traçabilité des interactions client

Références

• Log4j2 RollingFile Appender