Red Hat Training

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

12.3.2. CLI でのログカテゴリー設定

ログカテゴリーは CLI で追加、削除、および編集できます。
ログカテゴリーを設定するために実行する主なタスクは次のとおりです。
  • 新しいログカテゴリーの追加
  • ログカテゴリーの設定表示
  • ログレベルを設定します。
  • ログカテゴリーへのログハンドラーの追加
  • ログカテゴリーからのログハンドラーの削除
  • ログカテゴリーの削除
重要
ログカテゴリーをスタンドアロンシステムのロギングプロファイルに設定する場合、設定パスのルートは /subsystem=logging/ ではなく /subsystem=logging/logging-profile=NAME/ になります。
管理対象ドメインでは、使用するプロファイルを指定する必要があります。管理対象ドメインの設定パスの先頭にプロファイル名を追加する必要があります。/subsystem=logging/ は /profile=NAME/subsystem=logging/ に置き換えます。
ログカテゴリーの追加
以下の構文で add 操作を使用します。CATEGORY を、追加するカテゴリーに置き換えます。 
 /subsystem=logging/logger=CATEGORY:add

例12.7 新規カテゴリーの追加

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add   
{"outcome" => "success"}
ログカテゴリーの設定の表示
以下の構文で read-resource 操作を使用します。CATEGORY をカテゴリーの名前に置き換えます。 
/subsystem=logging/logger=CATEGORY:read-resource

例12.8 ログカテゴリーの read-resource 操作

[standalone@localhost:9999 /] /subsystem=logging/logger=org.apache.tomcat.util.modeler:read-resource
{
    "outcome" => "success",
    "result" => {
        "category" => "org.apache.tomcat.util.modeler",
        "filter" => undefined,
        "filter-spec" => undefined,
        "handlers" => undefined,
        "level" => "WARN",
        "use-parent-handlers" => true
    }
}
ログレベルの設定
次の構文で write-attribute 操作を使用します。CATEGORY はログカテゴリーの名前に、LEVEL は設定するログレベルに置き換えます。 
/subsystem=logging/logger=CATEGORY:write-attribute(name="level", value="LEVEL")

例12.9 ログレベルの設定

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="level", value="DEBUG")
{"outcome" => "success"}
ルートロガーのログハンドラーを使用するためのログカテゴリの設定
次の構文で write-attribute 操作を使用します。CATEGORY はログカテゴリーの名前に置き換えます。ルートロガーのハンドラーを使用するために、このログカテゴリーの BOOLEAN を true に置き換えます。独自の割り当てられたハンドラーのみを使用する場合は false に置き換えます。 
/subsystem=logging/logger=CATEGORY:write-attribute(name="use-parent-handlers", value="BOOLEAN")

例12.10 use-parent-handlers の設定

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="use-parent-handlers", value="true")
{"outcome" => "success"}
ログカテゴリへのログハンドラ追加
次の構文で add-handler 操作を使用します。CATEGORY をカテゴリーの名前に置き換え、HANDLER を追加するハンドラーの名前に置き換えます。 
/subsystem=logging/logger=CATEGORY:add-handler(name="HANDLER")
ログハンドラーを作成してから、ログハンドラーをルートロガーへ追加する必要があります。

例12.11 ログハンドラーの追加

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add-handler(name="AccountsNFSAsync")
{"outcome" => "success"}
ログカテゴリからのログハンドラの削除
次の構文で remove-handler 操作を使用します。CATEGORY をカテゴリーの名前に置き換え、HANDLER を削除するログハンドラーの名前に置き換えます。 
/subsystem=logging/logger=CATEGORY:remove-handler(name="HANDLER")

例12.12 ログハンドラーの削除

[standalone@localhost:9999 /] /subsystem=logging/logger=jacorb:remove-handler(name="AccountsNFSAsync")
{"outcome" => "success"}
カテゴリーの削除
以下の構文で remove 操作を使用します。CATEGORY は削除するカテゴリーの名前に置き換えます。 
/subsystem=logging/logger=CATEGORY:remove

例12.13 ログカテゴリの削除

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:remove   
{"outcome" => "success"}
バグの報告