Journaux de l'application

Cet outil vous permet de consulter les journaux (logs) de l'application et de modifier leurs niveaux directement.

Le sommaire situé à droite, permet d'accéder aux sections Visualisation et Configuration

Visualisation

Par défaut, une application Ametys publie un fichier de journalisation quotidiennement. Dans l'écran Visualisation, les logs sous groupés par types puis classé par date. Cet ordre peut être modifié à la volée en cliquant sur les colonnes du tableau.

Après avoir sélectionné un journal dans cette vue, une liste d'actions de gestion apparait:

  • Voir le fichier : Le fichier est téléchargé sous forme textuelle (taille < 1Mo) ou zippé (taille > 1Mo)
  • Télécharger le(s) fichier(s) : La sélection multiple permet de télécharger un ensemble de journaux dans un fichier zip.
  • Effacer le(s) fichier(s) : Permet de supprimer les fichiers de journalisation sélectionnés.
  • Purger les journaux : Supprimer les journaux de plus de 12 jours pour économiser l'espace disque.

L'action de suppression des journaux récents n'est pas recommandée. Une telle action reste cependant permise.

L'écran de Visualisation des journaux ne prend en compte que les fichiers situés dans le dossier WEB-INF/logs

Configuration

Cette écran vous permet de définir des niveaux de journalisation pour les différentes catégories de journaux. Les modifications auront lieu en temps réels mais sont non persistantes (elles ne seront plus prises en compte après un redémarrage de l'application).

Les catégories des journaux disponibles dépendent de la configuration du fichier log4j.xml de votre application.

Si vous souhaitez faire des mofications persistances, il faut modifier directement le fichier log4j.xml. Consultez au besoin la documentation de log4j.

Les icônes de l'arbre représentent les niveaux associés à chacune des catégories de journalisation. Un icône translucide est affichée pour les catégories ne possédant pas de niveau mais héritant du niveau de leur parent. Par exemple, le catégorie InitExtensionPoint possède le niveau INFO par héritage, car sa catégorie parente Cocoon a été affectée au niveau INFO.

Après avoir sélectionné la catégorie de votre choix, les actions de gestion suivantes deviennent disponibles :

  • Passer en DEBUG
  • Passer en INFO
  • Passer en WARNING
  • Passer en ERROR
  • Hériter le mode : La catégorie sélectionnée héritera alors du niveau de son parent.
  • Forcer l'héritage : Force l'ensemble des enfants du noeud courant à hériter de la catégorie du noeud.

Par exemple, pour passer entièrement l'application au niveau de journalisation INFO vous devez simplement :

  • Sélectionner le noeud racine
  • Effectuer l'action"Passer en INFO"
  • Effectuer l'action "Forcer l'héritage" pour s'assurer que les sous-catégories dont le niveau a précédemment été modifié, soient bien affectées au niveau INFO.