Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

12.3. Configuration de logging dans le CLI

Conditions préalables

L'interface CLI doit exécuter et est connectée à l'instance JBoss EAP qui convient. Pour plus d'informations, voir Section 3.5.2, « Lancement de l'interface CLI »

12.3.1. Configurer le root logger par le CLI

La configuration du Root Logger peut s'afficher ou être modifiée par l'interface CLI.
Les tâches principales à effectuer pour configurer le root logger sont les suivantes :
  • Ajouter des log handler au root logger.
  • Afficher la configuration du root logger.
  • Modifier le niveau de journalisation.
  • Supprimer des log handler du root logger.

Important

Pour la configuration du Root Logger dans un profil de journalisation de système autonome, la racine (root) du chemin de configuration est /subsystem=logging/logging-profile=NAME/ au lieu de /subsystem=logging/.
Dans un domaine géré, vous devez spécifier quel profil utiliser. Vous devez ajouter le nom de profil en début de chemin de configuration pour un domaine géré, et remplacer /subsystem=logging/ par /profile=NAME/subsystem=logging/.
Ajouter un log handler au root logger
Utiliser l'opération add-handler avec la syntaxe suivante HANDLER dans le nom du gestionnaire de journalisation (Log Hangler) à ajouter.
/subsystem=logging/root-logger=ROOT:add-handler(name="HANDLER")
Le log handler doit déjà avoir été créé avant de l'ajouter au root handler.

Exemple 12.3. Opération root logger add-handler

[standalone@localhost:9999 /] /subsystem=logging/root-logger=ROOT:add-handler(name="FILE")
{"outcome" => "success"}
Afficher le contenu de la configuration du root logger
Utiliser l'opération read-resource avec la syntaxe suivante.
/subsystem=logging/root-logger=ROOT:read-resource

Exemple 12.4. Opération root logger «read-resource»

[standalone@localhost:9999 /] /subsystem=logging/root-logger=ROOT:read-resource                                  
{
   "outcome" => "success",
   "result" => {
        "filter" => undefined,
        "filter-spec" => undefined,
        "handlers" => [
            "CONSOLE",
            "FILE"
      ],
      "level" => "INFO"
   }
}
Définir le niveau de journalisation du root logger
Utiliser l'opération write-attribute avec la syntaxe suivante avec LEVEL indiquant les niveaux de journalisation pris en charge.
/subsystem=logging/root-logger=ROOT:write-attribute(name="level", value="LEVEL")

Exemple 12.5. L'opération «write-attribute» du root logger pour définir le niveau de journalisation

[standalone@localhost:9999 /] /subsystem=logging/root-logger=ROOT:write-attribute(name="level", value="DEBUG")
{"outcome" => "success"}
Supprimer un log handler du root logger
Utiliser remove-handler avec la syntaxe suivante, avec HANDLER comme nom du gestionnaire de journalisation à supprimer.
/subsystem=logging/root-logger=ROOT:remove-handler(name="HANDLER")

Exemple 12.6. Supprimer un log handler

[standalone@localhost:9999 /] /subsystem=logging/root-logger=ROOT:remove-handler(name="FILE")
{"outcome" => "success"}