第4章 開発者向けのロギング

4.1. はじめに

4.1.1. ロギング

ロギングとは、アプリケーションの活動の記録 (またはログ) を提供するアプリケーションより一連のメッセージを記録することです。
ログメッセージは、アプリケーションをデバッグする開発者や実稼働環境のアプリケーションを維持するシステム管理者に対して重要な情報を提供します。
最新の Java のロギングフレームワークの多くには、正確な時間やメッセージの起源など他の詳細も含まれています。

4.1.2. JBoss LogManager でサポートされるアプリケーションロギングフレームワーク

JBoss LogManager は、以下のロギングフレームワークをサポートします。

4.1.3. ログレベルとは

ログレベルとは、ログメッセージの性質と重大度を示す列挙値の順序付けされたセットです。 特定のログメッセージのレベルは、そのメッセージを送信するために選択したロギングフレームワークの適切なメソッドを使用して開発者が指定します。
JBoss Enterprise Application Platform 6 では 6 つのログレベルを使用します (低から高の順): TRACE、DEBUG、INFO、WARN、ERROR、FATAL
ログレベルはログカテゴリとログハンドラーによって使用され、それらが担当するメッセージを限定します。ログカテゴリとログハンドラーは、そのレベル以上の受信メッセージを処理します。たとえば、WARN レベルのログハンドラーは、WARN、ERROR、および FATAL のレベルのメッセージのみを記録します。

4.1.4. サポートされているログレベル

表4.1 サポートされているログレベル

ログレベル 説明
FATAL
クリティカルなサービス障害やアプリケーションのシャットダウンをもたらしたり、JBoss Enterprise Application Platform 6 のシャットダウンを引き起こす可能性があるイベントを表示するのに使用します。
ERROR
発生したエラーの中で、現在のアクティビティや要求の完了を妨げる可能性があるが、アプリケーション実行の妨げにはならないエラーを表示するのに使用します。
WARN
エラーではないが、理想的とは見なされない状況を表示するのに使用します。将来的にエラーをもたらす可能性のある状況を示す場合もあります。
INFO
アプリケーションの全体的な進捗状況を示すメッセージに使用します。多くの場合、アプリケーションの起動、シャットダウン、およびその他の主要なライフサイクルイベントに使用されます。
DEBUG
アプリケーションの個別の要求またはアクティビティの進捗状況を表示するメッセージに使用します。DEBUG のログメッセージは通常アプリケーションのデバッグ時のみにキャプチャーされます。
TRACE
アプリケーションの実行状態に関する詳細情報を提供するメッセージに使用します。通常、TRACE のログメッセージはアプリケーションのデバッグ時のみにキャプチャーされます。

4.1.5. デフォルトログファイルの場所

これらは、デフォルトのロギング設定に対して作成されたログファイルです。デフォルトの設定では、周期的なログハンドラーを使用してサーバーログファイルが書き込まれます。

表4.2 スタンドアローンサーバー用デフォルトログファイル

ログファイル 説明
EAP_HOME/standalone/log/boot.log
サーバーブートログには、サーバーの起動に関するログメッセージが含まれます。
EAP_HOME/standalone/log/server.log
サーバーログには、サーバーが起動された後のすべてのログメッセージが含まれます。

表4.3 管理対象ドメイン用デフォルトログファイル

ログファイル 説明
EAP_HOME/domain/log/host-controller/boot.log
ホストコントローラーブートログには、ホストコントローラーの起動に関するログメッセージが含まれます。
EAP_HOME/domain/log/process-controller/boot.log
プロセスコントローラーブートログには、ホストコントローラーの起動に関するログメッセージが含まれます。
EAP_HOME/domain/servers/SERVERNAME/log/boot.log
指定されたサーバーのサーバーブートログには、指定されたサーバーの起動に関するログメッセージが含まれます。
EAP_HOME/domain/servers/SERVERNAME/log/server.log
指定されたサーバーのサーバーログには、指定されたサーバーが起動された後のすべてのログメッセージが含まれます。