ログ・レベル設定
このトピックを使用して、ログ・レベル設定を構成および管理します。
この管理コンソール・ページを表示するには、 をクリックします。
ログ・レベルを使用すると、Java™ ロギングによって処理されるイベントを制御できます。 ロガーのレベルを変更すると、その変更はロガーの子に伝搬されます。
- 機密の可能性があるデータのロギングとトレースを使用不可にする
アプリケーション・サーバーには、機密の可能性がある情報をログに書き込み、トレースするためのロガーのリストが含まれています。 例えば、特定の HTTP に関連したロガーを FINEST レベルで使用可能にすると、機密性のある HTTP 要求からのユーザー指定情報がトレース・ファイルに保管される場合があります。 機密情報の可能性があるデータに使用されるレベルで、サーバーがこれらのロガーを使用できないようにするには、「機密の可能性があるデータのロギングとトレースを使用不可にする (Disable logging and tracing of potentially sensitive data)」チェック・ボックスをチェックします。 サーバーが始動すると、あるいはログ詳細レベルの仕様がランタイム時に変更されると、サーバーは、ログ詳細レベルの仕様で指定されたロガーおよびレベルのリストと、機密ロガー・リストのロガーおよびレベルのリストを比較し、必要に応じてログ詳細レベルの仕様を更新します。
- ログ詳細レベルの変更
トレースするコンポーネント、パッケージ、またはグループを指定するログ詳細レベルを入力します。 ログ詳細レベル・ストリングは、このトピックに記載されている特定の文法に準拠していなければなりません。 ログ詳細レベル・ストリングを直接入力するか、 またはグラフィカル・トレース・インターフェースを使用して生成することができます。
Configuration（構成） 」タブを選択し、「 Components and Groups（コンポーネントとグループ） 」を展開すると、よく知られたコンポーネント、パッケージ、グループの静的リストが表示されます。 このリストはすべてを網羅していない場合があります。
Runtime] タブを選択し、[ Components and Groups] を展開すると、コンポーネント、パッケージ、およびグループのリストが表示され、実行中のアプリケーションサーバーに登録されているすべてのコンポーネントが静的リストに表示されます。
ログ詳細レベル仕様の形式は、次のとおりです。<component> = <level>
ここで、 < component> はログ詳細レベルを設定するコンポーネントであり、 < level> は有効なロガー・レベル (off、fatal、severe、warning、audit、info、config、detail、fine、finer、finest、all) のいずれかです。 複数のログ詳細レベル指定はコロン (:) で区切ります。 節を指定しない場合は、 *=info のデフォルトが使用されます。
トラブルの回避: トレース仕様に含まれる節は、ストリングに出現する順序で読み取られます。 したがって、トレース仕様に *=info 文節の複数のバリエーションが含まれている場合、最後に指定された値が、システムが記録したトレース・レベルを決定する値です。 *=info を最後の文節として指定する場合、トレース・ストリングで指定されている他の文節に関係なく、情報レベルでトレースが行われます。 例えば、次のトレース・ストリングを指定したとします。
このトレース・ストリングは、単純に次を指定したのと同等です。*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
最後の節は、ストリング内でその前に指定されたすべての節をオーバーライドするからです。*=allコンポーネントは、Java パッケージおよびクラス、または Java パッケージのコレクションに対応します。 アスタリスク (*) をワイルドカードとして使用して、 指定されたコンポーネントに含まれているすべてのパッケージ内の、 すべてのクラスが含まれているコンポーネントを示します。 以下に例を示します。- *
- 製品システム・コードおよびカスタマー・コードを含め、 アプリケーション・サーバーで稼働しているすべてのトレース可能なコードを指定します。
- com.ibm.ws.*
- パッケージ名が com.ibm.ws で始まるすべてのクラスを指定します。
- com.ibm.ws.classloader.JarClassLoader
- JarClassLoader クラスのみを指定します。
「グループ」および「コンポーネント」の両方のリストから選択した場合、 ログ詳細レベル仕様を管理コンソールから設定する際に、エラーが起こる可能性があります。 場合によっては、あるリストから行われた選択が、 別のリストからの選択を追加するときに失われる場合があります。 この問題に対処するには、ログ詳細レベル仕様を直接、ログ詳細レベル入力フィールドに入力します。
ログ詳細レベルを設定するコンポーネントまたはグループを選択します。 以下の表に、アプリケーション・サーバーの有効なレベルをリストします。トラブルの回避: ロギング・レベルの値は大/小文字が区別され、小文字で始まります。あるロギング・レベルを使用可能にすると、それよりも重大度の高いすべてのレベルが使用可能になります。 例えば、アプリケーション・サーバーで ロギング・レベルを warning に設定した場合、warning、severe、および fatal のイベントが処理されます。表 1. 有効なロギング・レベルは です。 以下の表に、アプリケーション・サーバーの有効なレベルをリストします。 ロギング・レベル 内容/重要度 off ロギングはオフになります。 fatal タスクは継続できず、コンポーネント、アプリケーション、サーバーは機能しません。 severe タスクは継続できませんが、コンポーネント、アプリケーション、 サーバーは機能できます。 このレベルは、リカバリー不能エラーの兆候を示す場合もあります。 warning エラーの可能性があること、またはエラーが起こりそうであることを示します。 このレベルは、 進行性の障害 (例えば、リソースのリークの可能性) を示すこともできます。 audit サーバー状態またはリソースに影響する重大なイベント info 全体的なタスクの進行を概説する一般情報 config 構成の変更または状況 detail サブタスクの進行の詳細を示す一般情報 fine トレース情報 - 一般トレース finer トレース情報 - 詳細トレース(一般トレースと、メソッド・エントリー、終了、および戻り値を含む) finest トレース情報 - 問題をデバッグするために必要な詳細がすべて含まれるより詳細なトレース すべて すべてのイベントがログに記録されます。 カスタム・レベルを作成する場合、 「すべて」はそれらのレベルを含み、「極細」より詳細なトレースを提供します。 [基本モードのロギング] Fine、Finer、および Finest の各レベルのイベントであるトレース情報は、トレース・ログにのみ書き込まれます。 したがって、診断トレースを使用可能にしない場合、 ログ詳細レベルを Fine、Finer、または Finest に設定しても、記録されるデータに影響を与えません。
- 相関
- 有効にする相関設定を指定します。 アプリケーション・サーバーの相関を
有効にする場合は、「ログとトレースの相関を有効にする」チェック・ボックスを
選択します。 アプリケーション・サーバーの相関を
無効にする場合は、「ログとトレースの相関を有効にする」チェック・ボックスを
クリアします。 ログとトレース記録に要求IDを含める、 ログとトレース記録と相関ログ記録に要求IDを含める、またはログとトレース記録に要求IDを含め、相関ログ記録を作成し、データスナップショットをキャプチャするを必要に応じて選択します。ベスト・プラクティス:
- すべてのスレッドおよびアプリケーション・サーバー・プロセス内の どのログ項目およびトレース項目が同じ要求に関連しているか確認する必要がある場合、XCT を有効にして、 要求 ID をログ・ファイルとトレース・ファイルに組み込みます。 要求 ID は、HPEL ログおよび トレース・モードを使用している場合にのみ記録され、logViewer コマンドを使用してフィルタリングするときに 表示したり使用したりできます。
- 要求がスレッドやプロセス間でどのように 分岐しているかログに記録し、各要求についての詳細な情報を確認する必要がある場合、XCT を有効にして、 相関ログ・レコードを作成します。 XCT を有効にして相関ログ・レコードを作成すると、システムのパフォーマンスに大きく 影響する可能性があるため、このオプションはテスト環境や開発環境に最も適しています。
- 要求および応答の本文全体をファイル・システムに 保管する必要がある場合、XCT を有効にして、データ・スナップショットを取り込みます。 XCT を有効にして データ・スナップショットを取り込むと、システムのパフォーマンスに大きく 影響する可能性があるため、このオプションはテスト環境や開発環境に最も適しています。 XCT は、SIBus によって 処理されるメッセージ要求および応答のデータ・スナップショットを取り込みます。
問題の回避: データ・スナップショットがキャプチャーされ、 $SERVER_LOG_ROOT/snapdata ディレクトリーに書き込まれます。 アプリケーション・サーバーは、このディレクトリーのファイルを自動的にクリーンアップしません。 データ・スナップショットの取り込みを有効に している場合は、ユーザーがこのディレクトリーからファイルを定期的に削除する必要があります。 データ・スナップショットは、要求と応答の 内容全体を保管するため、機密情報を含んでいる場合があります。 このオプションは、実稼働環境での使用には適さないことがあります。
- ランタイム変更も構成に保存する
稼働中のサーバーの動的状態とサーバー構成の両方に変更が加えられることを指定します (サーバー構成への変更は次に再始動したときに有効になります)。 このチェック・ボックスを選択しないと、サーバーは設定をサーバー構成にコピーしません。