13.3.3. Configurer un Log Handler de console dans le CLI
Les Log Handlers de console peuvent être ajoutés, supprimés ou modifiés dans le CLI.
Voici les tâches principales qui vous reviendront pour configurer un Log Handler de console :
- Ajouter un nouveau Log Handler de console.
- Afficher la configuration d'un Log Handler de console.
- Définir le niveau de journalisation du handler.
- Définir la cible de la sortie du handler.
- Définir la codification utilisée pour la sortie du handler.
- Définir le formateur utilisé pour la sortie du handler.
- Définir si le handler utilise autoflush ou non.
- Supprimer un handler de journalisation de console.
Important
Pour la configuration d'un handler 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 un Log Handler de console
- Utiliser l'opération
add
avec la syntaxe suivante. Remplacer HANDLER par le nom du gestionnaire de journalisation (Log Hangler) de la console à ajouter./subsystem=logging/console-handler=HANDLER:add
Exemple 13.12. Ajouter un Log Handler de console
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:add {"outcome" => "success"} [standalone@localhost:9999 /]
- Afficher une configuration de Log Handler de journalisation de la console
- Utiliser l'opération
read-resource
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console./subsystem=logging/console-handler=HANDLER:read-resource
Exemple 13.13. Afficher une configuration de Log Handler de journalisation de la console
[standalone@localhost:9999 /] /subsystem=logging/console-handler=CONSOLE:read-resource { "outcome" => "success", "result" => { "autoflush" => true, "encoding" => undefined, "filter" => undefined, "formatter" => "%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n", "level" => "INFO", "target" => "System.out" } } [standalone@localhost:9999 /]
- Définir le Niveau de journalisation
- Utiliser l'opération
change-log-level
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console et LEVEL par le niveau de journalisation à définir./subsystem=logging/console-handler=HANDLER:change-log-level(level="LEVEL")
Exemple 13.14. Définir le Niveau de journalisation
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:change-log-level(level="TRACE") {"outcome" => "success"} [standalone@localhost:9999 /]
- Définir la cible
- Utiliser l'opération
write-attribute
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console et TARGET parSystem.err
ouSystem.out
pour le flux Erreurs système ou le flux Standard out./subsystem=logging/console-handler=HANDLER:write-attribute(name="target", value="TARGET")
Exemple 13.15. Définir la cible
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="target", value="System.err") {"outcome" => "success"} [standalone@localhost:9999 /]
- Définir le Codage
- Utiliser l'opération
write-attribute
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console et ENCODING par le nom de codification du caractère qui convient./subsystem=logging/console-handler=HANDLER:write-attribute(name="encoding", value="ENCODING")
Exemple 13.16. Définir le Codage
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="encoding", value="utf-8") {"outcome" => "success"} [standalone@localhost:9999 /]
- Définir Formateur
- Utiliser l'opération
write-attribute
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console et FORMAT par le string de formateur requis./subsystem=logging/console-handler=HANDLER:write-attribute(name="formatter", value="FORMAT")
Exemple 13.17. Définir Formateur
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="formatter", value="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n") {"outcome" => "success"} [standalone@localhost:9999 /]
- Définir Auto Flush
- Utiliser l'opération
write-attribute
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console et BOOLEAN partrue
si le handler doit écrite sa sortie immédiatement./subsystem=logging/console-handler=HANDLER:write-attribute(name="autoflush", value="BOOLEAN")
Exemple 13.18. Définir Auto Flush
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="autoflush", value="true") {"outcome" => "success"} [standalone@localhost:9999 /]
- Supprimer un Log Handler de console
- Utiliser l'opération
remove
avec la syntaxe suivante. Remplacer HANDLER par le nom du Log Handler de la console à supprimer./subsystem=logging/console-handler=HANDLER:remove
Exemple 13.19. Supprimer un Log Handler de console
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:remove {"outcome" => "success"} [standalone@localhost:9999 /]