Exceptionトレースログは,メソッド実行時に障害が発生した場合に障害要因を分析するためのトレース情報です。障害発生時の問題個所の切り分けをするときに有効です。メソッドの呼び出し情報,メソッドの戻り値の情報,および例外(Exception)の情報が,製品名称などが出力されたヘッダと合わせて出力されます。
Exceptionトレースログとして出力される情報を次に示します。
表F-9 Exceptionトレースログとして出力される情報
情報の種類 | 内容 |
---|---|
ヘッダ | 出力情報の通番 |
製品名称 | |
メソッドの呼び出し情報 | ログの取得時間 |
スレッド識別情報 | |
メソッドの呼び出し識別情報 | |
クラス名,オブジェクトID,メソッド名 | |
コネクションハンドル | |
セクションID(カーソルIDと同じことを表現しています) | |
メソッドの引数 | |
メソッドの戻り情報 | ログの取得時間 |
スレッド識別情報 | |
メソッドの戻り識別情報 | |
クラス名,オブジェクトID,メソッド名 | |
コネクションハンドル | |
セクションID(カーソルIDと同じことを表現しています) | |
メソッドの引数 | |
Exceptionの情報 | ログの取得時間 |
スレッド識別情報 | |
Exceptionのスタックトレース |
Exceptionトレースログは,SQLException,BatchUpdateException,またはXAExceptionが発生したときに,環境変数に設定した設定情報を基に,Exceptionがthrowされる前にファイルに出力されます。Exceptionトレースを出力するメソッドと,ログ出力に関連する環境変数については,「付録E.1 Cosminexus DABroker Libraryで取得できるログの種類と出力先」を参照してください。
Exceptionトレースログの出力形式を,トレース取得レベル5の場合の出力例を基に説明します。
出力される内容について次の表で示します。項番は出力例中の番号と対応しています。
表F-10 Exceptionトレースログの出力項目
項番 | 区分 | 表示 | 意味 |
---|---|---|---|
1 | ヘッダ | [XXXX] | 出力情報の通番を示します。 |
2 | Cosminexus DABroker for Java , DABroker for Java Version 2 XX-XX-XX | Cosminexus DABroker Libraryのログであることを示します。 | |
3 | 共通 | XXXX/XX/XX XX:XX:XX.XXX | ログの取得時間を示します。 |
4 | Thread[XXXX,XXXXX,XXXX]@XXXX | スレッド識別情報を示します。 | |
5 | [JdbcDbpsvXXXX@XXXX.XXXX] | クラス名,オブジェクトID,メソッド名を示します。 | |
6 | HANDLE(XXXX) | ConnectionHandleを示します。 | |
7 | SID(XXX) | セクションID(カーソルIDと同じことを表現しています)を示します。 | |
8 | メソッドの呼び出し情報 | [E] | メソッドの呼び出し識別情報を示します。 |
9 | XXXX=XXXX | メソッドの引数を示します。 | |
10 | メソッドの戻り情報 | [R] | メソッドからの戻り識別情報を示します。 |
11 | Return=XXXX | メソッドの戻り値を示します。 | |
12 | Exception情報 | JP.co.Hitachi.soft.DBPSV_Driver.XXXXException:XXXX | Exceptionのスタックトレースを表示します。 |
ここでは,(1)で示した出力例を使用して,Exceptionトレースログの解析方法について説明します。
Exceptionトレースログは,次の手順で解析します。
時間 | スレッド1 | スレッド2 | スレッド3 | スレッド4 |
---|---|---|---|---|
Thread[main,5,main] @1259414 | Thread[Thread-0,5,main] @30090737 | Thread[Thread-1,5,main] @5462872 | Thread[Thread-2,5,main] @25253977 | |
2004/07/06 23:07:09.129 | JdbcDbpsvConnection @82c01f.createStatement(1) | - | - | - |
2004/07/06 23:07:09.160 | JdbcDbpsvStatement @1e4cbc4.execute | - | - | - |
2004/07/06 23:07:14.285 | JdbcDbpsvConnection @82c01f.commit | - | - | - |
2004/07/06 23:07:14.301 | JdbcDbpsvConnection @82c01f.prepareStatement(1) | - | - | - |
2004/07/06 23:07:26.567 | JdbcDbpsvConnection @82c01f.commit | - | - | - |
2004/07/06 23:07:26.567 | JdbcDbpsvStatement @1e4cbc4.executeQuery | - | - | - |
2004/07/06 23:07:26.567 | JdbcDbpsvStatement @1e4cbc4.execute | - | - | - |
2004/07/06 23:07:28.332 | JdbcDbpsvResultSet @3eca90.close | JdbcDbpsvConnection @82c01f.prepareStatement(1) | - | - |
2004/07/06 23:07:28.332 | JdbcDbpsvConnection @82c01f.commit | - | - | - |
2004/07/06 23:07:28.348 | - | - | JdbcDbpsvConnection @82c01f.prepareStatement(1) | - |
2004/07/06 23:07:30.332 | - | - | - | JdbcDbpsvConnection @82c01f.rollback |
2004/07/06 23:07:42.098 | - | - | - | JdbcDbpsvConnection @82c01f.close |
2004/07/06 23:07:42.535 | - | - | SQLException発生 KFDJ00002-E Statement or Connection is closed. | - |
トレース取得レベルごとの出力例を次に示します。
[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D |
[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D |
[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D |
[1] Cosminexus DABroker for Java , DABroker for Java Version 2 02-11-/D |