Configuration de la journalisation
La journalisation constitue un important aspect de toutes les applications serveur. Agent
Controller permet la journalisation pour le débogage et la génération de rapports. Ceci s'effectue via l'utilisation d'un fichier journal unique, servicelog.log, qui est placé par défaut dans le répertoire config où le contrôleur d'agent est installé.
Vous pouvez configurer la journalisation en :
Modification du répertoire de journalisation par défaut
Dans certaines situations, il est nécessaire de modifier le répertoire de journalisation par défaut. Par exemple, cette modification est nécessaire sur les systèmes sur lesquels le contrôleur d'agent est installé dans un système de fichiers en lecture seule.
Pour modifier le répertoire de journalisation par défaut, procédez comme suit :
- Recherchez le fichier de configuration serviceconfig.xml. Reportez-vous à la tâche connexe.
- Ouvrez le fichier dans un éditeur, puis recherchez l'élément <Logging>.
- Définissez le nouveau répertoire de journalisation sous forme de valeur de l'attribut directory de cet élément.
Modification des filtres de journalisation
Vous pouvez indiquer que seuls les messages d'un niveau de journalisation défini ou supérieur doivent être consignés dans le fichier à l'aide d'un filtre de journalisation simple. Les différents niveaux de journalisation sont les suivants :
- ELEVE : Permet de consigner uniquement les messages d'erreur irrémédiables.
- CRITIQUE : (valeur par défaut) Reprend ce qui est mentionné ci-dessus, plus les messages qui indiquent que des opérations normales ont été interrompues en raison d'une erreur.
- AVERTISSEMENT : Reprend ce qui est mentionné ci-dessus, plus les messages concernant les événements inattendus qui ne doivent pas interférer avec le fonctionnement du système.
- INFORMATION : Reprend ce qui est mentionné ci-dessus, plus les messages concernant des événements normaux qui peuvent présenter un intérêt pour l'utilisateur.
- DEBOGAGE : Reprend ce qui est mentionné ci-dessus, plus les messages concernant le flux détaillé des opérations internes permettant l'identification des incidents.
Pour modifier les filtres de journalisation, procédez comme suit :
- Dans le fichier serviceconfig.xml, recherchez l'élément <Logging>.
- Remplacez la valeur de l'attribut level par l'un des niveaux de journalisation ci-dessus, en fonction de vos besoins.
Modification du format des messages journalisés
Vous pouvez définir le format des messages journalisés : texte normal ou CBE. Les spécifications de format sont les suivantes :
- CBE :
(valeurs par défaut) Les messages sont journalisés à l'aide du format CBE (Common Base Event).
Ce format inclut des informations détaillées concernant le contexte et l'origine de chaque message. Pour lire plus facilement les messages, utilisez un utilitaire de lecture de journaux CBE.
- Simple (ou normal) : les messages sont journalisés sous forme de texte simple.
Pour modifier le format de journalisation, procédez comme suit :
- Dans le fichier serviceconfig.xml, recherchez l'élément <Logging>.
- Remplacez la valeur de l'attribut de formatage par l'un des formats de journalisation ci-dessus, en fonction de vos besoins.
Tâches connexes
Localisation des fichiers de configuration
Gestion du contrôleur d'agent