10.4. ログカテゴリーの設定
管理 CLI を使用すると、JBoss EAP でログカテゴリーを設定できます。または、管理コンソールから設定 > サブシステム > ログ > 設定 を選択し、表示 をクリックして Categories を選択します。
次のタスクを実行して、ログカテゴリーを設定できます。
ロギングプロファイルにこのログカテゴリーを設定する場合は、/subsystem=logging/ ではなく /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ を指定してコマンドを開始します。
さらに、マネージドドメインで実行している場合はコマンドの前に /profile=PROFILE_NAME を付けます。
10.4.1. 管理 CLI を使用したログカテゴリーの追加および設定 リンクのコピーリンクがクリップボードにコピーされました!
ログカテゴリー名は通常、元の Java パッケージです。ただし、ロガーは要件に基づいて任意の文字列名を使用できます。詳細は、Java ロギング API のドキュメントを参照してください。そのパッケージのクラスからのメッセージは、ログレベルなどの他の設定を満たす場合にキャプチャーされます。
前提条件
- JBoss EAP が実行中である。
- 管理 CLI にアクセスできる。
手順
以下のコマンドを使用してログカテゴリーを追加します。
/subsystem=logging/logger=LOG_CATEGORY:add必要に応じて、以下のログカテゴリー属性を 1 つ以上設定できます。
次のコマンドを使用して、ログカテゴリーのログレベルを設定します。
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=level,value=LEVEL)デフォルトは
ALLです。以下のコマンドを使用して、このカテゴリーがルートロガーのログハンドラーを使用するかどうかを設定します。
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=use-parent-handlers,value=USE_PARENT_HANDLERS)デフォルトでは、ログカテゴリーは独自のハンドラーに加えてルートロガーのハンドラーを使用します。
use-parent-handlers属性をfalseに設定して、ログカテゴリーが割り当てられたハンドラーのみを使用するようにします。次のコマンドを使用してフィルター式を設定します。
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)ログカテゴリーのログメッセージをフィルターするための式を指定します。コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、
FILTER_EXPRESSION変数を"not (match (\"WFLY\")) "に置き換え、not (match ("WFLY"))のフィルター式を設定します。
次のステップ
10.4.2. ログハンドラーの割り当ておよびログカテゴリーの管理 リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP のログハンドラーは、ログカテゴリーに対するログメッセージの処理および記録方法を制御します。ログハンドラーを特定のログカテゴリーに割り当て、アプリケーションのニーズに合わせてロギングの動作をカスタマイズします。不要になったログカテゴリーを削除し、ロギング設定を整理して効率的にすることもできます。
前提条件
- JBoss EAP が実行中である。
- 管理 CLI にアクセスできる。
手順
以下のコマンドを使用してログハンドラーをログカテゴリーに割り当てます。
/subsystem=logging/logger=LOG_CATEGORY:add-handler(name=LOG_HANDLER_NAME)必要に応じて、
remove操作を使用してログカテゴリーを削除できます。/subsystem=logging/logger=LOG_CATEGORY:remove注記ロギング設定にログカテゴリーが必要なくなったら、ログカテゴリーを削除できます。