Comme son nom l'indique, un Logger permet de définir une destination (et d'autres paramètres) pour l'enregistrement des informations de debug, de log et d'erreurs dans Tomcat. On peut définir un Logger à trois niveaux différents, par ordre d'importance : Engine, Host et Context. Sachant que les Logger sont hérités dans les niveaux inférieurs (les Context héritent par exemple des Logger de l'Host correspondant), à moins d'être écrasés explicitement (dans notre exemple, si le Context définit son propore Logger).
Engine, Host ou Context.
Aucune.
Nom |
Description |
className |
La classe (chemin complet, packages puis nom de la classe) à utiliser comme Logger. Elle doit implémenter l'inteface org.apache.catalina.Logger. Cet attribut doit être obligatoirement spécifié car il n'y pas de valeur par défaut. Ou plus exactement il y en a plusieurs. Voir à la fin de la page. |
Nom |
Description |
verbosity |
Niveau de log, de 0 à 4 . 0 n'inscrira que les erreurs fatales, 1 toutes les erreurs, 2 les warnings, 3 les informations, et 4 les éléments de debug. Il va sans dire qu'un niveau élevé écrit implicitement les niveaux plus bas. Par exemple, si le niveau est de 2, les warnings, les erreurs, et les erreurs fatales seront loggés. La valeur par défaut est 1. |
Implémentation par défaut |
Trois implémentations standard de Logger cohabitent.
Nom |
Description |
directory |
Répertoire où enregistrer les logs. Le chemin peut être absolu, ou relatif au répertoire de base de Tomcat. Si aucun répertoire n'est spécifié, le répertoire "logs" de Tomcat sera utilisé par défaut. |
prefix |
Le préfixe à utiliser lors de la création des noms de fichiers. Si le préfixe est "myapp." et le suffixe ".log", les fichiers auront pour nom myapp.2004-01-20.log.txt. Le préfixe par défaut est "catalina". Donc, pour un préfixe vide, utiliser la chaîne de caractères "" (vide). |
suffix |
Le suffixe à utiliser lors de la création des noms de fichiers. Si le préfixe est "myapp." et le suffixe ".log", les fichiers auront pour nom myapp.2004-01-20.log.txt. Le suffixe par défaut est ".log". Donc, pour un préfixe vide, utiliser la chaîne de caractères "" (vide). |
timestamp |
Par défaut à false. Permet d'enregistrer un timestamp (date et heure précise, à la milliseconde près) pour chaque message loggé. |
|