Red Hat Training

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

12.3.8. Configurer un log handler async dans le CLI

Les log handlers async peuvent être ajoutés, supprimés ou modifiés dans le CLI.
Les tâches que vous allez effectuer pour configurer un log handler async sont les suivantes :
  • Ajouter un nouveau log handler async
  • Afficher la configuration d'un log handler async
  • Modifier le niveau de journalisation
  • Définir la longueur de la file d'attente
  • Définir l'action de dépassement
  • Ajouter les sous-handlers
  • Supprimer les sous-handlers
  • Supprimer un sous-handler async
Chacune de ces tâches sont décrites ci-dessous.

Important

Pour la configuration d'un gestionnaire 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 un nouveau log handler async
Utiliser l'opération add avec la syntaxe suivante.
 /subsystem=logging/async-handler=HANDLER:add(queue-length="LENGTH") 
Remplacer HANDLER par le nom du log handler et LENGTH par la valeur du nombre maximum de requêtes de journalisation pouvant tenir dans une file d'attente.

Exemple 12.67. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add(queue-length="10")
{"outcome" => "success"}
Afficher la configuration d'un log handler async
Utiliser l'opération read-resource avec la syntaxe suivante.
 /subsystem=logging/async-handler=HANDLER:read-resource 
Remplacer HANDLER par le nom du log handler.

Exemple 12.68. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:read-resource
{
    "outcome" => "success",
    "result" => {
        "enabled" => true,
        "encoding" => undefined,
        "filter" => undefined,
        "filter-spec" => undefined,
        "formatter" => "%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n",
        "level" => "ALL",
        "name" => "NFS_LOGS"
        "overflow-action" => "BLOCK",
        "queue-length" => "50",
        "subhandlers" => undefined
    }
}
[standalone@localhost:9999 /]
Modifier le niveau de journalisation
Utiliser l'opération write-attribute avec la syntaxe suivante.
 /subsystem=logging/async-handler=HANDLER:write-attribute(name="level", value="LOG_LEVEL_VALUE") 
Remplacer HANDLER par le nom du log handler et LOG_LEVEL_VALUE par le niveau de journalisation à définir.

Exemple 12.69. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="level", value="INFO")
{"outcome" => "success"}
[standalone@localhost:9999 /]
Définir la longueur de la file d'attente
Utiliser l'opération write-attribute avec la syntaxe suivante.
 /subsystem=logging/async-handler=HANDLER:write-attribute(name="queue-length", value="LENGTH") 
Remplacer HANDLER par le nom du log handler et LENGTH par la valeur du nombre maximum de requêtes de journalisation pouvant tenir dans une file d'attente.
JBoss EAP 6 doit démarrer à nouveau pour prendre effet.

Exemple 12.70. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="queue-length", value="150")
{
    "outcome" => "success",
    "response-headers" => {
        "operation-requires-reload" => true,
        "process-state" => "reload-required"
    }
}
Définir l'action de dépassement
Utiliser l'opération write-attribute avec la syntaxe suivante.
 /subsystem=logging/async-handler=HANDLER:write-attribute(name="overflow-action", value="ACTION") 
Remplacer HANDLER par le nom du log handler et ACTION par DISCARD ou BLOCK.

Exemple 12.71. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="overflow-action", value="DISCARD")
{"outcome" => "success"}
[standalone@localhost:9999 /]
Ajouter les sous-handlers
Utiliser l'opération add-handler avec la syntaxe suivante.
 /subsystem=logging/async-handler=HANDLER:add-handler(name="SUBHANDLER") 
Remplacer HANDLER par le nom du log handler et SUBHANDLER par le nom du log handler qui doit être ajouté comme sous-handler de ce handler asynch.

Exemple 12.72. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add-handler(name="NFS_FILE")       
{"outcome" => "success"}
[standalone@localhost:9999 /]
Supprimer les sous-handlers
Utiliser l'opération remove-handler avec la syntaxe suivante.
/subsystem=logging/async-handler=HANDLER:remove-handler(name="SUBHANDLER")
Remplacer HANDLER par le nom du log handler et SUBHANDLER par le nom du log handler qui doit être supprimé.

Exemple 12.73. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:remove-handler(name="NFS_FILE")       
{"outcome" => "success"}
[standalone@localhost:9999 /]
Supprimer un sous-handler async
Utiliser l'opération remove avec la syntaxe suivante.
/subsystem=logging/async-handler=HANDLER:remove 
Remplacer HANDLER par le nom du log handler.

Exemple 12.74. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:remove       
{"outcome" => "success"}
[standalone@localhost:9999 /]