13.3.3. CLI でのコンソールログハンドラー設定
コンソールログハンドラーは CLI で追加、削除、および編集できます。
コンソールログハンドラーを設定するために実行する主なタスクは次のとおりです。
- 新しいコンソールログハンドラーの追加
- コンソールログハンドラーの設定表示
- ハンドラーのログレベルの設定
- ハンドラーの出力のターゲットを設定
- ハンドラーの出力に使用されるエンコーディングの設定
- ハンドラーの出力に使用されるフォーマッターの設定
- ハンドラーによる自動フラッシュ使用の有無を設定
- コンソールログハンドラーの削除
重要
ログハンドラーをロギングプロファイルに設定する場合、設定パスのルートは
/subsystem=logging/ ではなく /subsystem=logging/logging-profile=NAME/ になります。
- コンソールログハンドラーの追加
- 次の構文で
add操作を使用します。HANDLER は追加するコンソールログハンドラーに置き換えます。/subsystem=logging/console-handler=HANDLER:add例13.12 コンソールログハンドラーの追加
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:add {"outcome" => "success"} [standalone@localhost:9999 /] - コンソールログハンドラーの設定表示
- 次の構文で
read-resource操作を使用します。HANDLERはコンソールログハンドラーの名前に置き換えます。/subsystem=logging/console-handler=HANDLER:read-resource例13.13 コンソールログハンドラーの設定表示
[standalone@localhost:9999 /] /subsystem=logging/console-handler=CONSOLE:read-resource { "outcome" => "success", "result" => { "autoflush" => true, "encoding" => undefined, "filter" => undefined, "formatter" => "%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n", "level" => "INFO", "target" => "System.out" } } [standalone@localhost:9999 /] - ログレベルの設定
- 次の構文で
change-log-level操作を使用します。HANDLER はコンソールログハンドラーの名前に、LEVEL は設定するログレベルに置き換えてください。/subsystem=logging/console-handler=HANDLER:change-log-level(level="LEVEL")例13.14 ログレベルの設定
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:change-log-level(level="TRACE") {"outcome" => "success"} [standalone@localhost:9999 /] - ターゲットの設定
- 次の構文で
write-attribute操作を使用します。HANDLER はコンソールログハンドラーの名前に置き換えます。TARGET は、システムエラーストリームの場合にはSystem.errに、標準出力ストリームの場合にはSystem.outに置き換えてください。/subsystem=logging/console-handler=HANDLER:write-attribute(name="target", value="TARGET")例13.15 ターゲットの設定
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="target", value="System.err") {"outcome" => "success"} [standalone@localhost:9999 /] - エンコーディングの設定
- 次の構文で
write-attribute操作を使用します。HANDLER をコンソールログハンドラーの名前に置き換え、ENCODING を必要な文字エンコーディングシステムの名前に置き換えます。/subsystem=logging/console-handler=HANDLER:write-attribute(name="encoding", value="ENCODING")例13.16 エンコーディングの設定
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="encoding", value="utf-8") {"outcome" => "success"} [standalone@localhost:9999 /] - フォーマッターの設定
- 次の構文で
write-attribute操作を使用します。HANDLER はコンソールログハンドラーの名前に置き換えます。FORMAT は必要なフォーマッターの文字列に置き換えます。/subsystem=logging/console-handler=HANDLER:write-attribute(name="formatter", value="FORMAT")例13.17 フォーマッターの設定
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="formatter", value="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n") {"outcome" => "success"} [standalone@localhost:9999 /] - 自動フラッシュの設定
- 次の構文で
write-attribute操作を使用します。HANDLER はコンソールログハンドラーの名前に置き換えます。このハンドラーが出力を直ちに書き込むようにするには、BOOLEAN をtrueに置き換えます。/subsystem=logging/console-handler=HANDLER:write-attribute(name="autoflush", value="BOOLEAN")例13.18 自動フラッシュの設定
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="autoflush", value="true") {"outcome" => "success"} [standalone@localhost:9999 /] - コンソールログハンドラーの削除
- 次の構文で
remove操作を使用します。HANDLER は削除するコンソールログハンドラーの名前に置き換えます。/subsystem=logging/console-handler=HANDLER:remove例13.19 コンソールログハンドラーの削除
[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:remove {"outcome" => "success"} [standalone@localhost:9999 /]