9.3.3 メソッドトレース
メソッドトレースには,メソッドの入口情報,出口情報,デバッグ情報およびエラー情報が出力されます。
-
出力先ディレクトリ
<Application Serverのインストールディレクトリ>/CC/server/public/ejb/<サーバ名称>/logs/RM/maintenance
-
出力トレースファイル名
ラップアラウンド形式ローテーションの場合 mtd_<Reliable Messagingの表示名>_<面番号>.log シフト形式ローテーションの場合
-
最新ファイル名
mtd_<Reliable Messagingの表示名>_.log
-
バックアップファイル名
mtd_<Reliable Messagingの表示名>_<面番号>.log
-
-
コントロールファイル名※
mtd_<Reliable Messagingの表示名>_.conf
Reliable Messagingの表示名については,永続版リソースアダプタの場合は「3.4.4(1) キュー定義ファイルの記述形式」を,非永続版リソースアダプタの場合は「3.5.2(1) キュー定義ファイルの記述形式」を参照してください。
面番号はRMLogTraceFileNumプロパティ指定値が最大数です。また,トレースファイル(拡張子がlogのファイル)サイズはRMLogTraceFileSizeプロパティ指定値が最大長(単位:バイト)です。
- 注※
-
ログライブラリが使用するバイナリ形式のファイルを出力先ディレクトリに出力します。ファイルサイズは固定で256バイトです。
-
出力形式
メソッドトレースの出力形式を次の図に示します。
図9‒3 メソッドトレースの出力形式 メソッドトレースの出力項目を次の表に示します。
表9‒5 メソッドトレースの出力項目 項番
出力項目
長さ
(バイト)
説明
1
番号
4
メソッドトレースの出力通番です。
2
日付
10
yyyy/mm/dd形式の出力日付です。
3
時刻
12
hh:mm:ss.sss形式の出力時刻です。
ローカル時刻でミリ秒単位の時刻です。
4
製品ID
16
製品を識別するための識別子です。
Reliable Messagingを表す"RM"が出力されます。
5
pid
8
プロセスIDです。
6
tid
8
スレッドIDです。
7
ID
11
空白が出力されます。
8
ハッシュコード
1〜11
トレースを出力するオブジェクトのハッシュコード(16進数)です。
9
コンポーネントID
3
トレースを出力するコンポーネントを識別するための識別子です。
10
クラス名
1〜25※1
(可変長)
トレースを出力するクラスの名前です。
11
メソッド名
1〜25※1
(可変長)
トレースを出力するメソッドの名前です。
12
目的識別子
3
トレースの出力目的を表す識別子※2です。
13
トレース
0〜512※1
(可変長)
次に示す情報が出力されます。
-
メソッド入口または出口情報
メソッドの引数または戻り値の値です。
-
他製品呼び出し情報
Application Serverまたは他製品のクラス名,メソッド名および引数です。
-
エラー情報
障害要因となったエラー情報です。
なお,他製品から例外が発生した場合は,スタックトレース※3が出力されます。
-
デバッグ情報
デバッグ情報です。メソッド内の処理分岐では,分岐の要因となった情報が出力されます。
RMMethodTraceLevelプロパティに指定する出力レベル※4によって出力情報は異なります。
14
CRLF
2
終端記号です。
- 注※1
-
長さの上限は目安となる値です。上限値を超えて出力されることがあります。ただし,メソッドトレース1行の長さは4185バイトが上限であり,これを超える情報は切り捨てられます。
- 注※2
-
目的識別子の一覧を次の表に示します。
表9‒6 目的識別子の一覧 項番
目的識別子
意味
1
STA(start)
メソッドの開始
2
END(end)
メソッドの終了
3
CAL(call)
メソッドの呼び出し
4
RET(return)
メソッドの戻り
5
ERR(error)
メソッドの例外
6
DBG(debug)
メソッドのデバッグ情報(分岐など)
7
INF(information)
メソッドの処理情報(注意,警告など)
8
OPR(operation)
メソッドの処理情報(処理実行情報)
- 注※3
-
他製品から例外が発生した場合は,スタックトレースが出力されます。その際,ハッシュコードからトレースまでの出力項目が出力されず,スタックトレースが出力されます。スタックトレースは可変長(0〜512)のデータです。
スタックトレースの出力例を次の図に示します。
図9‒4 スタックトレースの出力例 - 注※4
-
RMMethodTraceLevelプロパティに指定する出力レベルによって,トレースに出力される情報は異なります。出力情報と出力レベルを次の表に示します。
表9‒7 メソッドトレースの出力情報と出力レベル 項番
出力情報
レベル1
レベル2
レベル3
レベル4
レベル5
1
エラー情報
(例外発生原因)
○
○
○
○
○
2
Reliable Messaging内部スレッドの処理の入口/出口情報
(クラス名,メソッド名,引数,戻り値)
○
○
○
○
○
3
Reliable Messagingのユーザインタフェースのメソッド入口/出口情報
(クラス名,メソッド名,引数,戻り値)
×
○
○
○
○
4
他製品のインタフェースの入口/出口情報
(クラス名,メソッド名,引数,戻り値)
×
×
○
○
○
5
Reliable Messaging内部インタフェース間の入口/出口情報
(クラス名,メソッド名,引数,戻り値)
×
×
×
○
○
6
Reliable Messagingのデバッグ情報
(処理の分岐などの情報)
×
×
×
×
○
7
Reliable Messagingの処理情報(注意,警告などを示す情報)
×
×
○
○
○
8
Reliable Messagingの処理情報(処理の実行を示す情報)
○
○
○
○
○
-