13.3.7. 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 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 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 13.50. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add(queue-length="10")
{"outcome" => "success"}
[standalone@localhost:9999 /]
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 13.51. 

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

Exemple 13.52. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:change-log-level(level="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 Enterprise Application Platform 6 doit démarrer à nouveau pour prendre effet.

Exemple 13.53. 

[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"
    }
}
[standalone@localhost:9999 /]
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 13.54. 

[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 assign-subhandler avec la syntaxe suivante. 
 /subsystem=logging/async-handler=HANDLER:assign-subhandler(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 13.55. 

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

Exemple 13.56. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:unassign-subhandler(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 13.57. 

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