Configuration de Tomcat avec logback

• Télécharger la distribution binaire de Tomcat 6.0.18(testé uniquement avec cette version).
• Télécharger les sources de Tomcat 6.0.18.
• Télécharger Ant.
• Télécharger la distribution de SLF4J.
• Télécharger la distribution de LogBack.

Cette partie est directement reprise de la documentation de Tomcat (chapitre Logging).

II-B-1. Installation de Tomcat▲

II-B-2. Compilation des extras▲

II-B-3. « Mise à jour » de Tomcat▲

Copier dans le répertoire lib de Tomcat les jars suivants :

• log4j-over-slf4j-VERSION.jar (distribution de SFL4J) ;
• slf4j-api-VERSION.jar (distribution de SFL4J) ;
• logback-core-VERSION.jar (distribution de LogBack) ;
• logback-classic-VERSION.jar (distribution de LogBack).

Comme cela, cela devrait déjà marcher, mais la configuration basique de logback est en mode DEBUG, ce qui fait que Tomcat génère énormément de log, donc un simple fichier de configuration peut être utilisé : logback.xml (à mettre dans le répertoire lib de Tomcat) :

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <contextName>Tomcat</contextName>
    <jmxConfigurator contextName="Tomcat" />
        <appender name="FILE" class="ch.qos.logback.core.FileAppender">
        <File>${catalina.home}\logs\tomcat.log</File>
        <Append>true</Append>
        <BufferedIO>false</BufferedIO>
        <ImmediateFlush>true</ImmediateFlush>
        <layout class="ch.qos.logback.classic.PatternLayout">
            <Pattern>%d{yyyy-MM-dd HH:mm:ss} [%-5p] - %m%n</Pattern>
        </layout>
    </appender>
    <root>
        <level value="INFO" />
        <appender-ref ref="FILE" />
    </root>
</configuration>

La nouvelle version du fichier qui est mis en place ne contient plus l'« hardcodage » du logger JULI, à la place il propose des interfaces sur org.apache.juli.logging, mais pas d'implémentation.

Ce jar contient une implémentation du LoggerFactory, qui en fait cherche dans le classpath une implémentation de logging JDK ou log4j. Évidemment, s'il cherchait du slf4j, cela simplifierait bien des choses.

C'est justement pour cela que l'on met ces archives. En fait elle remplace une éventuelle bibliothèque log4j.jar, et place l'environnement dans une position : « je choisis le logger que je trouve ». Ce qui est exactement le rôle de slf4j (Standard Logging Facage for Java).

Enfin, notre choix se porte sur l'implémentation LogBack, ce qui nous conduit à l'utilisation de ces deux archives, qui contiennent le code pour écrire finalement nos logs.

• Rajout de -Dlogback.ContextSelector=JNDI dans le lancement de Tomcat.
• Rajout dans le web.xml de chaque application :

<env-entry>
    <env-entry-name>logback/context-name</env-entry-name>
    <env-entry-type>java.lang.String</env-entry-type>
    <env-entry-value>TestLog</env-entry-value>
</env-entry>

• Le fichier de paramétrage devra s'appeler logback-TestLog.xml et être mis dans le répertoire WEB-INF/classes de l'application.
• Le contexte de chaque application doit être nettoyé lorsque l'application s'arrête. Pour cela, il faut rajouter la configuration suivante dans le web.xml :

<listener>
    <listener-class>ch.qos.logback.classic.selector.servlet.ContextDetachingSCL</listener-class>
</listener>

• Lors de la récupération du contexte, la requête JNDI peut être longue. En rajoutant, le filtre suivant dans le web.xml, cette requête est évitée, car le contexte est stocké dans un Thread local à chaque requête http :

<filter>
    <filter-name>LoggerContextFilter</filter-name>
    <filter-class>ch.qos.logback.classic.selector.servlet.LoggerContextFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>LoggerContextFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

L'idée de base est de pouvoir changer en exploitation le niveau de trace des applications. La première version de ce que j'avais imaginé était d'avoir plusieurs fichiers de config, et de proposer une servlet permettant de switcher de fichier de configuration.

Finalement, l'option retenue est d'utiliser les fonctions JMX du serveur Tomcat et de la bibliothèque LogBack. Pour cela, il faut tout d'abord autoriser Tomcat à utiliser JMX. Il suffit de rajouter ces paramètres à la chaîne de lancement de Tomcat :

-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=8888
-Dcom.sun.management.jmxremote.ssl=false
-Dcom.sun.management.jmxremote.authenticate=false

Ensuite dans une commande DOS, il suffit de lancer l'application jconsole, de se connecter en remote sur le port 8888, d'aller sur l'onglet MBeans et de sélectionner la bibliothèque de logging logback. Dans les différents écrans, il est possible de modifier en « live » le niveau de debug des applications.

Pour finir, il faut, comme pour le JNDI, nettoyer la mémoire lorsque l'application est arrêtée. Pour cela, il suffit de créer une classe du style :

package home.devcom.servlet.context;

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

import org.slf4j.LoggerFactory;

import ch.qos.logback.classic.LoggerContext;

public class ContextListener implements ServletContextListener 
{
  public void contextDestroyed(ServletContextEvent sce) 
  {
    System.out.println("ContextListener::contextDestroyed");
    // Code repris de la documentation de logback : 
    //  http://logback.qos.ch/manual/jmxConfig.html
    LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();
    lc.stop();
  }

  public void contextInitialized(ServletContextEvent sce) 
  {}
}

Compiler et transformer en fichier jar et le mettre dans le WEB-INF/lib de vos applications puis de rajouter les lignes suivantes au web.xml :

<listener>
    <listener-class>home.devcom.servlet.context.ContextListener</listener-class>
</listener>