14.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 »

Rapporter un bogue

14.3.1. Configurer le root logger par le CLI

La configuration du root logger peut s'afficher ou être modifiée par le 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, la racine (root) du chemin de configuration est /subsystem=logging/logging-profile=NAME/ au lieu de /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 14.1. 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 14.2. 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 14.3. 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 14.4. Supprimer un log handler

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