Appender RollingFile "transfer-log"

Cet appender gère les logs des transferts de fichiers avec rotation automatique des fichiers.

Exemple de configuration :

<RollingFile name="transfer-log" fileName="logs/transfers.log" filePattern="logs/transfers-%d{yyyy-MM-dd}.log">
    <ThresholdFilter level="INFO"/>
    <PatternLayout pattern="%d %-5p %m%n"/>
    <Policies>
        <SizeBasedTriggeringPolicy size="1000KB"/>
    </Policies>
    <DefaultRolloverStrategy max="100"/>
</RollingFile>

Exemple de log :

2025-02-06 15:28:15,342 INFO  a9d4ff0b-c88c-4291-b11d-6f9470666f9b Upload ready from my-user to my-user. Document name: /seattle.jpg, size: 191307

Détail des sections :

1. 2025-02-06 15:28:15,342 : Date et heure du log
2. INFO : Niveau de log
3. a9d4ff0b-c88c-4291-b11d-6f9470666f9b : Identifiant de session utilisateur (depuis le MDC)
4. Upload ready from my-user to my-user. Document name: /seattle.jpg, size: 191307 : Message du log

Ce journal est associé à l'extension "Transfer Log". Il ne sera pas rempli sans que l'extension soit activée dans l'application.

Configuration de base

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

Format des logs

Le pattern %d %-5p %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
• %m : Message du log
• %n : Retour à la ligne

Politique de rotation

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

Filtre

• ThresholdFilter: Niveau minimum INFO
• Seuls les messages de niveau INFO ou supérieurs (WARN, ERROR, FATAL) seront enregistrés
• Les messages de niveau DEBUG seront ignorés
• Format minimaliste particulièrement adapté pour :
  • Le suivi des opérations de transfert de fichiers
  • L'analyse rapide des évènements de transfert
  • La conservation d'un historique conséquent (100 fichiers)

Références

• Log4j2 RollingFile Appender