13.3.2. CLI でのログカテゴリ設定
ログカテゴリは CLI で追加/削除/編集することができます。
ログカテゴリーを設定するために実行する主なタスクは次のとおりです。
- 新しいログカテゴリーを追加します。
- ログカテゴリーの設定を表示します。
- ログレベルを設定します。
- ログハンドラーをログカテゴリーへ追加します。
- ログカテゴリーからログハンドラーを削除します。
- ログカテゴリーを削除します。
重要
ログカテゴリーをロギングプロファイルに設定する場合、設定パスのルートは
/subsystem=logging/
ではなく /subsystem=logging/logging-profile=NAME/
になります。
- ログカテゴリの追加
- 次の構文で
add
操作を使用します。CATEGORY は追加するカテゴリに置き換えます。/subsystem=logging/logger=CATEGORY:add
例13.5 新規カテゴリの追加
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add {"outcome" => "success"} [standalone@localhost:9999 /]
- ログカテゴリーの設定の表示
- 次の構文で
read-resource
操作を使用します。CATEGORY はカテゴリー名に置き換えます。/subsystem=logging/logger=CATEGORY:read-resource
例13.6 ログカテゴリーの read-resource 操作
[standalone@localhost:9999 /] /subsystem=logging/logger=org.apache.tomcat.util.modeler:read-resource { "outcome" => "success", "result" => { "filter" => undefined, "handlers" => undefined, "level" => "WARN", "use-parent-handlers" => true } } [standalone@localhost:9999 /]
- ログレベルの設定
- 次の構文で
write-attribute
操作を使用します。CATEGORY の箇所はログカテゴリー名に、LEVEL は設定するログレベルに置き換えます。/subsystem=logging/logger=CATEGORY:write-attribute(name="level", value="LEVEL")
例13.7 ログレベルの設定
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="level", value="DEBUG") {"outcome" => "success"} [standalone@localhost:9999 /]
- ルートロガーのログハンドラーを使用するためのログカテゴリの設定
- 次の構文で
write-attribute
操作を使用します。CATEGORY はログカテゴリ名に置き換えます。root ロガーのハンドラーを使用するためのこのログカテゴリには、BOOLEAN を true に置き換えます。独自の割り当てられたハンドラーのみを使用する場合には false に置き換えてください。/subsystem=logging/logger=CATEGORY:write-attribute(name="use-parent-handlers", value="BOOLEAN")
例13.8 use-parent-handlers の設定
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="use-parent-handlers", value="true") {"outcome" => "success"} [standalone@localhost:9999 /]
- ログカテゴリへのログハンドラ追加
- 次の構文で
assign-handler
操作を使用します。CATEGORY はカテゴリ名に、HANDLER は追加するハンドラーの名前に置き換えます。/subsystem=logging/logger=CATEGORY:assign-handler(name="HANDLER")
ログハンドラーを作成してから、ログハンドラーをルートロガーへ追加する必要があります。例13.9 ログハンドラーの追加
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:assign-handler(name="AccountsNFSAsync") {"outcome" => "success"} [standalone@localhost:9999 /]
- ログカテゴリからのログハンドラの削除
- 次の構文で
unassign-handler
操作を使用します。CATEGORY はカテゴリ名に、HANDLER は削除するログハンドラーの名前に置き換えます。/subsystem=logging/logger=CATEGORY:unassign-handler(name="HANDLER")
例13.10 ログハンドラーの削除
[standalone@localhost:9999 /] /subsystem=logging/root-logger=ROOT:root-logger-unassign-handler(name="AccountsNFSAsync") {"outcome" => "success"} [standalone@localhost:9999 /]
- カテゴリーの削除
- 次の構文で
remove
操作を使用します。CATEGORY は削除するカテゴリーの名前に置き換えます。/subsystem=logging/logger=CATEGORY:remove
例13.11 ログカテゴリの削除
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:remove {"outcome" => "success"} [standalone@localhost:9999 /]