12.3.8. CLI での非同期ログハンドラーの設定
非同期ログハンドラーは、CLI で追加、削除、および編集できます。
非同期ログハンドラーを設定するために実行するタスクは以下のとおりです。
- 新しい非同期ログハンドラーの追加
- 非同期ログハンドラーの設定表示
- ログレベルの変更
- キューの長さの設定
- オーバーフローアクションの設定
- サブハンドラーの追加
- サブハンドラーの削除
- 非同期ログハンドラーの削除
これらの各タスクについては以下で説明されています。
重要
ログハンドラーをスタンドアロンシステムのロギングプロファイルに設定する場合、設定パスのルートは
/subsystem=logging/ ではなく /subsystem=logging/logging-profile=NAME/ になります。
管理対象ドメインでは、使用するプロファイルを指定する必要があります。管理対象ドメインの設定パスの先頭にプロファイル名を追加する必要があります。
/subsystem=logging/ は /profile=NAME/subsystem=logging/ に置き換えます。
- 新しい非同期ログハンドラーの追加
- 以下の構文で add 操作を使用します。
/subsystem=logging/async-handler=HANDLER:add(queue-length="LENGTH")HANDLER をログハンドラーの名前に置き換えます。LENGTH を、キューに保持できるログリクエストの最大数に置き換えます。例12.67 新しい非同期ログハンドラーの追加
[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add(queue-length="10") {"outcome" => "success"} - 非同期ログハンドラーの設定表示
- 以下の構文で read-resource 操作を使用します。
/subsystem=logging/async-handler=HANDLER:read-resourceHANDLER をログハンドラーの名前に置き換えます。例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" => "10", "subhandlers" => undefined }, "response-headers" => {"process-state" => "reload-required"} } - ログレベルの変更
- 次の構文で write-attribute 操作を使用します。
/subsystem=logging/async-handler=HANDLER:write-attribute(name="level", value="LOG_LEVEL_VALUE")HANDLER をログハンドラーの名前に置き換えます。LOG_LEVEL_VALUE を設定するログレベルに置き換えます。例12.69 ログレベルの変更
[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="level", value="INFO") {"outcome" => "success"} - キューの長さの設定
- 次の構文で write-attribute 操作を使用します。
/subsystem=logging/async-handler=HANDLER:write-attribute(name="queue-length", value="LENGTH")HANDLER をログハンドラーの名前に置き換えます。LENGTH を、キューに保持できるログリクエストの最大数に置き換えます。この変更を反映するには、JBoss EAP 6 を再起動する必要があります。例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" } } - オーバーフローアクションの設定
- 次の構文で write-attribute 操作を使用します。
/subsystem=logging/async-handler=HANDLER:write-attribute(name="overflow-action", value="ACTION")HANDLER をログハンドラーの名前に置き換えます。ACTION は、DISCARD または BLOCK に置き換えます。例12.71 オーバーフローアクションの設定
[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="overflow-action", value="DISCARD") {"outcome" => "success"} - サブハンドラーの追加
- 次の構文で add-handler 操作を使用します。
/subsystem=logging/async-handler=HANDLER:add-handler(name="SUBHANDLER")HANDLER をログハンドラーの名前に置き換えます。SUBHANDLER を、この非同期ハンドラーのサブハンドラーとして追加するログハンドラーの名前に置き換えます。例12.72 サブハンドラーの追加
[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add-handler(name="NFS_FILE") {"outcome" => "success"} - サブハンドラーの削除
- 次の構文で remove-handler 操作を使用します。
/subsystem=logging/async-handler=HANDLER:remove-handler(name="SUBHANDLER")HANDLER をログハンドラーの名前に置き換えます。SUBHANDLER を、削除するサブハンドラーの名前に置き換えます。例12.73 サブハンドラーの削除
[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:remove-handler(name="NFS_FILE") {"outcome" => "success"} - 非同期ログハンドラーの削除
- 以下の構文で remove 操作を使用します。
/subsystem=logging/async-handler=HANDLER:removeHANDLER をログハンドラーの名前に置き換えます。例12.74 非同期ログハンドラーの削除
[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:remove {"outcome" => "success"}