Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

12.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 journal 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 ule 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 une catégorie de journalisation
Utiliser l'opération add avec la syntaxe suivante. Remplacer CATEGORY par la catégorie à ajouter.
Copy to Clipboard Toggle word wrap 
 /subsystem=logging/logger=CATEGORY:add

Exemple 12.7. Ajouter une nouvelle catégorie de journalisation

Copy to Clipboard Toggle word wrap 
[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.
Copy to Clipboard Toggle word wrap 
/subsystem=logging/logger=CATEGORY:read-resource

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

Copy to Clipboard Toggle word wrap 
[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.
Copy to Clipboard Toggle word wrap 
/subsystem=logging/logger=CATEGORY:write-attribute(name="level", value="LEVEL")

Exemple 12.9. Définir un niveau de journalisation

Copy to Clipboard Toggle word wrap 
[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.
Copy to Clipboard Toggle word wrap 
/subsystem=logging/logger=CATEGORY:write-attribute(name="use-parent-handlers", value="BOOLEAN")

Exemple 12.10. Configurer use-parent-handlers

Copy to Clipboard Toggle word wrap 
[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.
Copy to Clipboard Toggle word wrap 
/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 12.11. Ajouter un Log Handler

Copy to Clipboard Toggle word wrap 
[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.
Copy to Clipboard Toggle word wrap 
/subsystem=logging/logger=CATEGORY:remove-handler(name="HANDLER")

Exemple 12.12. Supprimer un Log Handler

Copy to Clipboard Toggle word wrap 
[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.
Copy to Clipboard Toggle word wrap 
/subsystem=logging/logger=CATEGORY:remove

Exemple 12.13. Supprimer une catégorie de journalisation

Copy to Clipboard Toggle word wrap 
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:remove   
{"outcome" => "success"}
[standalone@localhost:9999 /]
Rapporter un bogue
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat, Inc.