Hitachi

uCosminexus Application Runtime for Apache Tomcat ユーザーズガイド


13.3.1 Tomcatトレースログ

uCARTのトレース機能は,Tomcatの動作状況を示すトレース情報をログファイルに出力します。ログファイルのヘッダ,およびログファイルに出力されるトレース情報の詳細について説明します。なお,ログファイルに書き込む文字コードは,プラットフォームのデフォルトエンコーディングを使用します。

〈この項の構成〉

(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行で出力

  • 日時は,プラットフォームのデフォルトタイムゾーンを使用

トレース情報の出力内容

トレース情報の出力内容と値の範囲を次の表に示します。

表13‒4 トレース情報の出力内容と値の範囲

トレース情報のヘッダ

出力内容

値の範囲

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のIPアドレス形式(a.b.c.d)で出力されます。

ClientAP PID

トレース情報を取得したクライアントアプリケーションのプロセスID※3

10進数形式で出力されます。

ClientAP CommNo.

トレース情報を取得したクライアントアプリケーションの通信番号※4

0xで始まる16進数形式で出力されます。

RootAP IP

トレース情報を取得したルートアプリケーションのIPアドレス※2

IPv4のIPアドレス形式(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項目を””で囲んだもの。

出力文字数に制限はありません。

OPR

各トレース取得ポイントに記載したOPR項目を””で囲んだもの。

出力文字数に制限はありません。

LookupName

ルックアップ名。

****だけが出力されます。

OPT

取得ポイントごとの付加情報。

空文字("")だけが出力されます。

ASCII

取得ポイントごとの付加情報をASCII文字形式で出力。

空文字("")だけが出力されます。

注※1

スレッドダンプのjid項目と一致します。この項目を利用してスレッドダンプと突き合わせを実施してください。

注※2

情報がない場合(IPv4アドレスが取得できなかった場合も含む),0.0.0.0を出力します。

注※3

情報がない場合は,0を出力します。

注※4

情報がない場合は,0x0000000000000000を出力します。