14.3.2. Configurer une Catégorie dans l'interface CLI

Les catégories de journalisation peuvent être ajoutées, supprimées et modifiées dans le CLI.
Les tâches principales à effectuer pour configurer les catégories de journalisation sont les suivantes :
  • Ajouter une nouvelle catégorie de journalisation :
  • Afficher la configuration d'une catégorie de journalisation.
  • Définir un niveau de journalisation.
  • Ajouter des log handlers à une catégorie de journalisation.
  • Supprimer des log handlers d'une catégorie de journalisation.
  • Supprimer une catégorie de journalisation.

Important

Pour la configuration d'une catégorie de journalisation dans un profil de journalisation, la racine (root) du chemin de configuration est /subsystem=logging/logging-profile=NAME/ au lieu de /subsystem=logging/.
Ajouter une catégorie de journalisation
Utiliser l'opération add avec la syntaxe suivante. Remplacer CATEGORY par la catégorie à ajouter. 
 /subsystem=logging/logger=CATEGORY:add

Exemple 14.5. Ajouter une nouvelle catégorie de journalisation

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add   
{"outcome" => "success"}
[standalone@localhost:9999 /]
Afficher une configuration de catégorie de journalisation
Utiliser l'opération read-resource avec la syntaxe suivante. Remplacer CATEGORY par le nom de la catégorie. 
/subsystem=logging/logger=CATEGORY:read-resource

Exemple 14.6. Opération de lecture de ressource de la catégorie de journalisation

[standalone@localhost:9999 /] /subsystem=logging/logger=org.apache.tomcat.util.modeler:read-resource
{
    "outcome" => "success",
    "result" => {
        "category" => "org.apache.tomcat.util.modeler",
        "filter" => undefined,
        "filter-spec" => undefined,
        "handlers" => undefined,
        "level" => "WARN",
        "use-parent-handlers" => true
    }
}
[standalone@localhost:9999 /]
Définir le niveau de journalisation
Utiliser l'opération write-attribute avec la syntaxe suivante. Remplacer CATEGORY par le nom de la catégorie de journalisation et LEVEL par le niveau de journalisation à définir. 
/subsystem=logging/logger=CATEGORY:write-attribute(name="level", value="LEVEL")

Exemple 14.7. Définir un niveau de journalisation

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="level", value="DEBUG")
{"outcome" => "success"}
[standalone@localhost:9999 /]
Définir la Catégorie de journalisation pour utiliser le log handler du root logger.
Utiliser l'opération write-attribute avec la syntaxe suivante. Remplacer CATEGORY par le nom de la catégorie de journalisation. Remplacer BOOLEAN par true pour cette catégorie de journalisation pour utiliser les handlers du root logger. Le remplacer par false s'il doit utiliser ses propres handlers. 
/subsystem=logging/logger=CATEGORY:write-attribute(name="use-parent-handlers", value="BOOLEAN")

Exemple 14.8. Configurer use-parent-handlers

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="use-parent-handlers", value="true")
{"outcome" => "success"}
[standalone@localhost:9999 /]
Ajouter un log handler à une catégorie de journalisation.
Utiliser l'opération add-handler avec la syntaxe suivante. Remplacer CATEGORY par la catégorie à ajouter et HANDLER par le nom du handler à ajouter. 
/subsystem=logging/logger=CATEGORY:add-handler(name="HANDLER")
Le log handler doit déjà avoir été créé avant de l'ajouter au Root Handler.

Exemple 14.9. Ajouter un log handler

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add-handler(name="AccountsNFSAsync")
{"outcome" => "success"}
Supprimer un log handler d'une catégorie de journalisation
Utiliser l'opération remove-handler avec la syntaxe suivante. Remplacer CATEGORY par le nom de la catégorie à HANDLER par le nom du log handler à supprimer. 
/subsystem=logging/logger=CATEGORY:remove-handler(name="HANDLER")

Exemple 14.10. Supprimer un log handler

[standalone@localhost:9999 /] /subsystem=logging/logger=jacorb:remove-handler(name="AccountsNFSAsync")
{"outcome" => "success"}
[standalone@localhost:9999 /]
Supprimer une catégorie
Utiliser l'opération remove avec la syntaxe suivante. Remplacer CATEGORY par le nom de la catégorie à supprimer. 
/subsystem=logging/logger=CATEGORY:remove

Exemple 14.11. Supprimer une catégorie de journalisation

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:remove   
{"outcome" => "success"}
[standalone@localhost:9999 /]
Rapporter un bogue