管理者はトレース出力を使用して、アプリケーション・サーバー内のプロセスを検査し、さまざまな問題点を診断することができます。
アプリケーション・サーバーでは、
トレース出力はファイルまたはメモリー内の循環バッファーのいずれかに送ることができます。
トレース出力をメモリー内の循環バッファーに送る場合は、
ファイルにダンプしなければ表示することはできません。
アプリケーション・クライアントやスタンドアロン・プロセスでは、
トレース出力はファイルまたはプロセス・コンソール・ウィンドウのいずれかに送ることができます。
常に、トレース出力は、ユーザーの指定に従って、
基本フォーマット、拡張フォーマット、
またはログ・アナライザー・フォーマットのいずれかで、
プレーン・テキストとして生成されます。
トレース出力の基本フォーマットと拡張フォーマットは、
JVM メッセージ・ログで使用可能な基本フォーマットと拡張フォーマットに似ています。
基本フォーマットおよび拡張フォーマットのフィールド
基本フォーマットと拡張フォーマットでは、
多くの場合、同じフィールドや同じフォーマット設定の手法が使用されます。
これらのフォーマットで使用されるフィールドには、次のようなものがあります。
- TimeStamp
- タイム・スタンプのフォーマット設定には、
それをフォーマット設定するプロセスのロケールが使用されます。
ここには、完全修飾の日付 (YYMMDD)、
24 時間表示の時刻 (ミリ秒までの精度)、および時間帯が含まれます。
- ThreadId
- 8 文字の 16 進値。
トレース・イベントを発行したスレッドのハッシュ・コードから生成されます。
- ThreadName
- メッセージ・イベントまたはトレース・イベントを発行した Java スレッドの名前。
- ShortName
- トレース・イベントを発行したロギング・コンポーネントの省略名。
これは通常は、WebSphere Application Server の内部コンポーネントのクラス名ですが、
ユーザー・アプリケーション用のその他の ID である場合もあります。
- LongName
- トレース・イベントを発行したロギング・コンポーネントの絶対パス名。
これは通常は、WebSphere Application Server の内部コンポーネントの完全修飾クラス名ですが、
ユーザー・アプリケーション用のその他の ID である場合もあります。
- EventType
- トレース・イベントのタイプを示す 1 文字のフィールド。
トレース・タイプは小文字で表されます。
次のような値があります。
- >
- タイプ・メソッド項目のトレース項目。
- <
- タイプ・メソッド出口のトレース項目。
- 1
- タイプ fine またはイベントのトレース項目。
- 2
- タイプ finer のトレース項目。
- 3
- タイプ finest、デバッグ、またはダンプのトレース項目。
- Z
- トレース・タイプが認識されなかったことを示すプレースホルダー。
- ClassName
- メッセージ・イベントまたはトレース・イベントを発行したクラス。
- MethodName
- メッセージ・イベントまたはトレース・イベントを発行したメソッド。
- Organization
- メッセージ・イベントまたはトレース・イベントを発行したアプリケーションを所有する組織。
- Product
- メッセージ・イベントまたはトレース・イベントを発行した製品。
- Component
- メッセージ・イベントまたはトレース・イベントを発行した製品内のコンポーネント。
基本フォーマット
基本フォーマットで表示されるトレース・イベントは、
以下のフォーマットを使用します。
<timestamp><threadId><shortName><eventType>[className][methodName]<textmessage>
[parameter 1]
[parameter 2]
拡張フォーマット
拡張フォーマットで表示されるトレース・イベントは、
以下のフォーマットを使用します。
<timestamp><threadId><eventType><UOW><source=longName>[className][methodName]
<Organization><Product><Component>[thread=threadName]
<textMessage>[parameter 1=parameterValue][parameter 2=parameterValue]
ログ・アナライザー・トレース・フォーマット
Showlog ツールが生成するフォーマットと同じフォーマットでトレース情報を保存します。