第10章 JBoss EAP を用いたロギング
JBoss EAP は、内部使用とデプロイされたアプリケーションの両方で設定可能なロギング機能を提供します。logging サブシステムは JBoss LogManager を基盤とし、JBoss Logging だけでなくサードパーティーアプリケーションのロギングフレームワークを複数サポートします。
10.1. JBoss EAP のロギングメカニズム リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP は、サーバー環境の監視、トラブルシューティング、および管理をサポートするさまざまなロギングメカニズムを提供します。これらのメカニズムを理解すると、JBoss EAP の設定の維持およびデバッグに役立ちます。
10.1.1. JBoss EAP でのサーバーロギング リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP では、サーバーロギングは主にすべてのログエントリーが記録される server.log ファイルから管理されます。
このログファイルの場所は操作モードによって異なります。
-
スタンドアロンサーバーの場合:
EAP_HOME/standalone/log/server.log -
マネージドドメインの場合:
EAP_HOME/domain/servers/SERVER_NAME/log/server.log
このファイルは一般的にサーバーログとして知られています。
10.1.2. JBoss EAP での起動時のロギング リンクのコピーリンクがクリップボードにコピーされました!
起動中に JBoss EAP は Java 環境と各サービスの起動に関する情報をログに記録します。このログはトラブルシューティングに役立ち、デフォルトでは サーバーログ に書き込まれます。
起動時のロギングは、JBoss EAP の logging サブシステムが起動するまで logging.properties ファイルで設定されます。
ファイルの場所は操作モードによって異なります。
-
スタンドアロンサーバーの場合:
EAP_HOME/standalone/configuration/logging.properties 管理対象ドメイン:ドメインコントローラーと各サーバーの両方に
logging.propertiesファイルがあります。-
ドメインコントローラー:
EAP_HOME/domain/configuration/logging.properties サーバー:
EAP_HOME/domain/servers/SERVER_NAME/data/logging.properties警告必要な場合を除き、
logging.propertiesファイルを直接編集しないでください。特定のユースケースがある場合は、変更する前に Red Hat カスタマーポータル を参照してください。logging.propertiesファイルに手動で変更すると、起動時に上書きされます。
-
ドメインコントローラー:
10.1.2.1. 起動時のエラーの表示 リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP をトラブルシューティングする場合、起動時のエラーを確認することが重要なステップになります。この情報を使用して、エラーを診断し、解決できます。必要に応じて、起動時のエラーのトラブルシューティングについてサポートが必要な場合はサポートケースを作成してください。
以下の方法で、起動時のエラーを表示できます。
-
server.logファイルでの起動エラーの確認 - 管理 CLI コマンドでの起動エラーの読み取り
それぞれの方法には、要件に応じて独自の利点があります。
10.1.2.1.1. server.log ファイルでの起動エラーの確認 リンクのコピーリンクがクリップボードにコピーされました!
server.log ファイルを開いて起動中に発生したエラーを確認します。
このメソッドは、エラーメッセージと関連情報を提供し、エラーの原因を理解するのに役立ちます。エラーメッセージがプレーンテキスト形式で表示されます。
前提条件
- JBoss EAP サーバーのファイルシステムにアクセスできる。
-
確認のために
server.logファイルにアクセスできます。
手順
-
ファイルビューアーで
server.logファイルを開きます。 - ファイルの最後に移動します。
-
最新の起動シーケンスの開始を示す
WFLYSRV0049メッセージ ID を後方検索します。 ログのその位置から
ERRORを前方検索します。各検索一致箇所には、エラーの説明が示され、関連するモジュールがリストされます。以下は、
server.logログファイルのエラー説明の例です。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.2.1.2. 管理 CLI コマンドでの起動エラーの読み取り リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP のトラブルシューティング時に、read-boot-errors 管理 CLI コマンドを使用して、ブートアップ中に報告されるエラーを表示できます。
この方法は、サーバーのファイルシステムへのアクセスできず、スクリプトによるリモート監視およびエラーチェックを有効にする場合に便利です。管理 CLI コマンドを使用すると、ブートエラーを特定し、対処できます。たとえば、複数の JBoss EAP インスタンスを起動し、起動エラーをチェックするスクリプトを作成できます。
前提条件
- JBoss EAP が実行中である。
- 管理 CLI にアクセスできる。
手順
管理 CLI を起動します。
<EAP_HOME>/bin/jboss-cli.sh
$ <EAP_HOME>/bin/jboss-cli.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次の管理 CLI コマンドを実行します。
/core-service=management:read-boot-errors
/core-service=management:read-boot-errorsCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力を確認し、起動時に発生したエラーの一覧を表示します。
- 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.3. JBoss EAP でのガベッジコレクションのロギング リンクのコピーリンクがクリップボードにコピーされました!
ガベッジコレクションロギングは、すべてのガベッジコレクションのアクティビティーをプレーンテキストのログファイルに記録します。これらのログは診断を行う場合に役立ちます。
ガベッジコレクションのログは EAP_HOME/standalone/log/gc.log.DIGIT.current にあります。各ログファイルは 3 MB に制限され、最大 5 つのファイルがローテーションされます。
トラブルシューティングに役立ち、オーバーヘッドを最小限に抑えるため、ガベッジコレクションのロギングを有効にすることを推奨します。ただし、スタンドアロンサーバーでは、サーバーを起動する前に GC_LOG 変数を false に設定することで無効にできます。以下に例を示します。
export GC_LOG=false EAP_HOME/bin/standalone.sh
$ export GC_LOG=false
$ EAP_HOME/bin/standalone.sh
10.1.4. JBoss EAP におけるデフォルトのログファイルの場所 リンクのコピーリンクがクリップボードにコピーされました!
以下のログファイルは、デフォルトのロギング設定に基づいて作成されます。これらの設定は Periodic ログハンドラーを使用してサーバーログファイルを書き込みます。
| ログファイル | 説明 |
|---|---|
|
| 起動メッセージを含むサーバーログメッセージが含まれます。 |
|
| ガベージコレクションの詳細が含まれます。 |
| ログファイル | 説明 |
|---|---|
|
| ホストコントローラーの起動に関連するログメッセージが含まれます。 |
|
| プロセスコントローラーの起動に関連するログメッセージが含まれます。 |
|
| 起動メッセージを含む、名前付きサーバーのログメッセージが含まれます。 |
10.1.5. JBoss EAP でのサーバーのデフォルトのロケール設定 リンクのコピーリンクがクリップボードにコピーされました!
JVM プロパティーを起動設定ファイルに設定すると、デフォルトのロケールを設定できます。起動設定ファイルは、スタンドアロンサーバーの場合は EAP_HOME/bin/standalone.conf、管理対象ドメインの場合は EAP_HOME/bin/domain.conf になります。
Windows サーバーでは、JBoss EAP 起動設定ファイルは standalone.conf.bat および domain.conf.bat になります。
国際化または現地化されたログメッセージはこのデフォルトロケールを使用します。
前提条件
- JBoss EAP が実行中である。
- サーバーモードの起動設定ファイルへのアクセスがある。
手順
user.languageプロパティーをJAVA_OPTS変数に追加して言語を設定します。たとえば、ロケールをフランス語に設定するには、以下の行を起動設定ファイルに追加します。JAVA_OPTS="$JAVA_OPTS -Duser.language=fr"
JAVA_OPTS="$JAVA_OPTS -Duser.language=fr"Copy to Clipboard Copied! Toggle word wrap Toggle overflow user.languageおよびuser.countryプロパティーを追加して、言語と国を設定します。たとえば、ロケールをブラジル語ポルトガル語に設定するには、以下の行を追加します。JAVA_OPTS="$JAVA_OPTS -Duser.language=pt -Duser.country=BR"
JAVA_OPTS="$JAVA_OPTS -Duser.language=pt -Duser.country=BR"Copy to Clipboard Copied! Toggle word wrap Toggle overflow o'rg.jboss.logging.locale' プロパティーを使用してサーバーロケールを設定し、ログメッセージに別のロケールを指定します。これにより、ロギング用のデフォルトのロケールが上書きされます。たとえば、サーバーロケールをブラジル語ポルトガル語に設定するには、以下の行を追加します。
JAVA_OPTS="$JAVA_OPTS -Dorg.jboss.logging.locale=pt-BR"
JAVA_OPTS="$JAVA_OPTS -Dorg.jboss.logging.locale=pt-BR"Copy to Clipboard Copied! Toggle word wrap Toggle overflow このプロパティーは、JBoss Logging を使用するログメッセージとその依存関係にのみ影響します。Jakarta Server Faces などの他の依存関係ではロケールをオーバーライドできません。
注記システムデフォルト以外のロケールで JBoss EAP を起動するには、スタンドアロンモードの場合は
EAP_HOME/bin/standalone.confを編集するか、管理対象ドメインモードの場合はEAP_HOME/bin/domain.confを編集します。org.jboss.logging.localeプロパティーを使用して、BCP 47 形式でロケールを設定します。