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 /]