Gestion des logs

Documentation de référence Shibboleth :

Documentation logback :

Le fichier de configuration logback.xml permet de définir le niveau de log du servlet Shibboleth. On peut aussi y configurer la politique de rotation des logs, suivant le format de configuration de logback. L'appender RollingFileAppender de logback détermine la politique de rotation des logs. Vous définissez le format du fichier archivé, logback en déduira la fréquence de rotation.

Voici un exemple de configuration des appenders dans IDP_ROOT_DIR/conf/logging.xml :

IDP_ROOT_DIR/conf/logback.xml
    <appender name="IDP_PROCESS" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <File>${idp.home}/logs/idp-process.log</File>
 
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${idp.home}/logs/old/idp-process-%d{yyyy-MM-dd}.log.gz</fileNamePattern>
            <maxHistory>180</maxHistory>
        </rollingPolicy>
 
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <charset>UTF-8</charset>
            <Pattern>%date{ISO8601} - %level [%logger:%line] - %msg%n%ex{short}</Pattern>
        </encoder>
    </appender>
  • <File> : il s'agit de la localisation du fichier de log concerné.
  • <Append>false</Append> : lors de la rotation, le fichier de log source sera tronqué.
  • <RollingPolicy class=“ch.qos.logback.core.rolling.TimeBasedRollingPolicy”> : on choisi un mode de rotation temporelle.
  • <FileNamePattern>IDP_ROOT_DIR/logs/old/idp-process-%d{yyyy-MM-dd}.log.gz</FileNamePattern> : on indique le chemin de destination du log archivé. La variable : -%d{yyyy-MM-dd} indique que l'on souhaite une rotation quotidienne (Année-Mois-Jour). En suffixant le nom du fichier avec .gz, on indique que l'on souhaite compresser les logs qui ont subi une rotation (le format zip est supporté également).
  • <MaxHistory>180</MaxHistory> : cette option indique le nombre d'archive conservées (ici 100 jours). Dans la version 0.9.18 de logback cette option est buggée.
Fichiers de configuration édités dans ce chapitre :
  • /opt/shibboleth-idp/conf/logback.xml