Le gestionnaire de traces est accessible depuis l'option 'Ouitls -> Gestionnaire de traces' du menu contextuel du bureau Adélia Cloud.

Remarque : Il est possible de supprimer l'option en fixant la balise allowLogManager à false dans le fichier 'desktop.properties'. Si la balise n'est pas présente ou si elle est égale à true l'option est visible.


Le gestionnaire de traces permet de visualiser tous les loggers log4j actifs.

Ils ont été instanciés via la méthode statique  org.apache.log4j.Logger.getLogger ou créés dans le fichier de configuration log4j.

Pour rappel le logger est l'entité de base de la journalisation log4j. L'utilisateur lui donne en général le nom de la classe dans laquelle il est instancié.

Un logger est parent d'un autre si son nom complet est le préfixe du second.

 

  • Vue arborescente

La partie de gauche présente une vue arborescente des loggers. Elle met en évidence le principe de hiérarchisation de log4j.

Chaque logger hérite du niveau de trace de son plus proche parent pour lequel un niveau a été défini excepté si on lui en attribue un explicitement.

Si aucun de ses parents n'a de niveau assigné il hérite du niveau du logger racine.

 

Dans l'arborescence chaque élément représente le nom d'un package Java qui compose le nom des loggers.

L'élément racine représente le rootlogger (logger racine) qui est l'ancêtre de tous les loggers existants.

Les éléments feuilles représentent les loggers qui ont été instanciés. 

Les éléments de couleur rouge  sont les loggers pour lesquels on a explicitement attribué un niveau soit via le gestionnaire de traces soit via le fichier de configuration log4j.lcf.

 

  • Vue liste

La partie droite du gestionnaire de traces liste tous les loggers instanciés dans le package sélectionné.

Elle permet de visualiser le nom du logger, son niveau de trace, si ce denier lui a été explicitement assigné (case assigné cochée) ou si il est hérité d'un parent (case assigné décochée)

et enfin le nom du plus proche logger parent pour lequel un niveau a été attribué.

Si aucun de ses parents n'a explicitement reçu un niveau de trace le logger hérite du niveau du rootlogger.

 

  • Les menus

Un menu contextuel sur l'arborescence et sur la liste permet d'assigner un niveau de trace à un logger.

Ces menus sont visibles uniquement si l'utilisateur fait partie du rôle 'wagon-administrator'.

Les niveaux de trace par gravité décroissante sont :

    • FATAL : utilisé pour tracer une erreur grave pouvant mener à l'arrêt prématuré de l'application
    • ERROR : utilisé pour tracer une erreur qui n'empêche cependant pas l'application de fonctionner
    • WARN : utilisé pour tracer un avertissement, il peut s'agir par exemple d'une incohérence dans la configuration, l'application peut continuer à fonctionner mais pas forcément de la façon attendue
    • INFO : utilisé pour tracer des messages à caractère informatif
    • DEBUG : utilisé pour générer des messages pouvant être utiles au débogage.

Deux niveaux particuliers :

    • OFF : aucun niveau de gravité n'est pris en compte.
    • ALL : tous les niveaux de gravité sont pris en compte.


  • Les options de la barre d'outils

Permet de recharger les loggers actifs et prendre en compte les éventuelles nouvelles instances de logger.

Permet de retourner dans la configuration d'origine. Annule les modifications faites dans le gestionnaire de traces depuis son lancement.

Cette option n'est pas visible si l'utilisateur n'est pas dans le rôle 'wagon-administrator'.

Expanse l'élément sélectionné.

Quitte le gestionnaire de traces.

 

  • Aucune étiquette