19.3.1 トレースログ
本製品のトレース機能は,モニタ対象プロセスの動作状況を示すトレース情報をログファイルに出力します。ログファイルのヘッダ,およびログファイルに出力されるトレース情報の詳細について説明します。なお,ログファイルに書き込む文字コードは,プラットフォームのデフォルトエンコーディングを使用します。
- 〈この項の構成〉
(1) ヘッダの詳細
- ヘッダを出力するタイミング
-
ヘッダを出力するタイミングは,次のとおりです。
-
新規ファイルに書き込むとき
-
既存ファイルに追記するとき
-
ローテーションで次のファイルに書き込むとき
-
- ヘッダの出力内容
-
ヘッダの出力内容は,次のとおりです。
PRF,Process,Thread(hashcode),Trace,ProcessName,Event,Date,Time,Time(msec/usec/nsec),Rc,ClientAP IP,ClientAP PID, ClientAP CommNo.,RootAP IP,RootAP PID,RootAP CommNo.,SendSCD IP,SendSCD PID,ReceiveSCD IP,ReceiveSCD PID,INT,OPR,LookupName,OPT,ASCII
(2) トレース情報の詳細
ログファイルのヘッダを出力したあと,トレース情報を出力します。
- トレース情報の形式
-
トレースの形式は,次のとおりです。
-
1トレース1行で出力
-
日時は,プラットフォームのデフォルトタイムゾーンを使用
-
- トレース情報の出力内容
-
トレース情報の出力内容と値の範囲を次の表に示します。
表19‒5 トレース情報の出力内容と値の範囲 トレース情報のヘッダ
出力内容
値の範囲
PRF
取得したトレース情報の状態。
Recだけが出力されます。Recは「正常」を意味します。
Process
トレース情報を取得したプロセスのプロセスID。
10進数形式で出力されます。
Thread(hashcode)
トレース情報を取得したスレッドの情報。
-
JavaスレッドID
-
トレース情報を取得したスレッドのスレッドオブジェクトのハッシュコード
次の形式で出力されます。
<JavaスレッドID>(<スレッドオブジェクトのハッシュコード※1>)
なお,JavaスレッドIDは10進数,スレッドオブジェクトのハッシュコードは0xで始まる16進数で表記されます。
Trace
トレース情報を取得したプロセス内スレッドでのトレース通番。
10進数形式で出力されます。
ProcessName
トレース情報を取得したプロセスの名前。
javaだけが出力されます。
Event
処理方式の各トレースで記載したイベントID。
0xで始まる16進数形式で出力されます。
Date
トレース情報を取得した日付。
<西暦>/<月>/<日>形式で出力されます。
Time
トレース情報を取得した時刻(時:分:秒)。
<時>:<分>:<秒>形式で出力されます。
Time(msec/usec/nsec)
トレース情報を取得した時刻(ミリ秒/マイクロ秒/ナノ秒)。
<ミリ秒>/<マイクロ秒>/<ナノ秒>形式で出力されます。
Rc
各トレース取得ポイントに記載したRc項目。
16進数形式で出力されます。ただし,0は0で出力されます。
ClientAP IP
トレース情報を取得したクライアントアプリケーションのIPアドレス※2。
IPv4アドレスの形式(a.b.c.d)で出力されます。
ClientAP PID
トレース情報を取得したクライアントアプリケーションのプロセスID※3。
10進数形式で出力されます。
ClientAP CommNo.
トレース情報を取得したクライアントアプリケーションの通信番号※4。
0xで始まる16進数形式で出力されます。
RootAP IP
トレース情報を取得したルートアプリケーションのIPアドレス※2。
IPv4アドレスの形式(a.b.c.d)で出力されます。
RootAP PID
トレース情報を取得したルートアプリケーションのプロセスID※3。
10進数形式で出力されます。
RootAP CommNo.
トレース情報を取得したルートアプリケーションの通信番号※4。
0xで始まる16進数形式で出力されます。
SendSCD IP
リクエスト要求元CTMのIPアドレス。
****だけが出力されます。
SendSCD PID
リクエスト要求元CTMのプロセスID。
****だけが出力されます。
ReceiveSCD IP
リクエスト要求先CTMのIPアドレス。
****だけが出力されます。
ReceiveSCD PID
リクエスト要求先CTMのプロセスID。
****だけが出力されます。
INT
各トレース取得ポイントに記載したINT項目を""で囲んだ※5もの。
出力文字数に制限はありません。
OPR
各トレース取得ポイントに記載したOPR項目を""で囲んだ※5もの。
出力文字数に制限はありません。
LookupName
ルックアップ名。
****だけが出力されます。
OPT
取得ポイントごとの付加情報。
空文字("")だけが出力されます。
ASCII
各トレース取得ポイントに記載したASCII項目を""で囲んだ※5もの。
記載がない場合,空文字("")が出力されます。
- 注※1
-
スレッドダンプのjid項目と一致します。この項目を利用してスレッドダンプと突き合わせを実施してください。
- 注※2
-
情報がない場合(IPv4アドレスが取得できなかった場合も含む),0.0.0.0が出力されます。
- 注※3
-
情報がない場合は,0が出力されます。
- 注※4
-
情報がない場合は,0x0000000000000000が出力されます。
- 注※5
-
各トレース取得ポイントの項目に"-"が記載されている場合,""は出力されず空文字("")が出力されます。項目に含まれるダブルクォーテーション(")はエスケープした文字("")に置き換えて出力されます。
-