Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム 開発ガイド 受付・アダプタ定義編
カスタム受付の運用時に障害が発生すると,障害対策に必要な次の情報が出力されます。
ここでは,ログおよび各種トレースの取得方法について説明します。
メッセージログは,次に示すログに出力されます。
メッセージログの取得方法および出力先については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.1 メッセージログ」に関する内容を参照してください。また,詳細は,マニュアル「サービスプラットフォーム メッセージ」の「2. メッセージ一覧」を参照してください。
リクエストトレースは,リクエストの障害要因の解析に使用します。
リクエストトレースの取得ポイントを次の図に示します。
図A-12 リクエストトレースの取得ポイント
詳細位置,およびトレース取得ポイントを次の表に示します。なお,表の「図中の番号」は,図中の番号と対応しています。
表A-5 リクエストトレースの取得ポイント
| 図中の番号 | 詳細位置 | トレース取得ポイント |
|---|---|---|
| 1 | IN | カスタム受付フレームワークの入口 |
| 2 | OUT | カスタム受付フレームワークの出口 |
表A-6 リクエストトレースに出力される内容
| 項目 | 内容 | |
|---|---|---|
| 番号 | トレースレコードの出力通番が出力されます。 | |
| 日付 | トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。 | |
| 時刻 | トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。 | |
| 製品ID | 製品を識別するためのIDが出力されます。
|
|
| pid | プロセスを識別するためのIDが出力されます。 | |
| tid | スレッドを識別するためのIDが出力されます。 | |
| ID | − | |
| メッセージ共通ID | リクエスト識別情報(親ID)が出力されます。 | |
| サービスリクエストID | リクエスト識別情報(子ID)が出力されます。 | |
| 取得ポイント識別情報 | 取得位置 | トレースの取得ポイント情報(取得位置)が出力されます。
|
| プロトコル種別 | トレースの取得ポイント情報(プロトコル種別)が出力されます。
|
|
| 詳細位置 | トレースの取得ポイント情報(詳細位置)が出力されます。
|
|
| 名称 | − | |
| アダプタ種別 | − | |
| 結果 | 応答結果種別が出力されます。ただし,詳細位置がINの場合は,出力されません。
|
|
| 付加情報 | 応答結果の付加情報が出力されます。
|
|
| CRLF | レコード終端符号が出力されます。 | |
リクエストトレースの取得方法と出力先については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.2 リクエストトレース」を参照してください。
性能解析トレース(PRFトレース)は,サービスプラットフォームシステムの性能解析をするためのトレース情報で,それをCSV形式で編集出力したテキストファイルが性能解析トレースファイルです。性能解析トレースは,J2EEアプリケーションを含めた,システム全体の性能ボトルネックを解析するための情報が出力されます。システムの性能ネックや性能トラブルシュートに使用します。性能解析トレース機能については,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7. 性能解析トレースを使用した性能解析」を参照してください。
性能解析トレースの取得ポイントを次の図に示します。
図A-13 性能解析トレースの取得ポイント
イベントID,トレース取得ポイント,および性能解析トレース取得レベルを次の表に示します。なお,表の「図中の番号」は,図中の番号と対応しています。
表A-7 性能解析トレースの取得ポイント
| イベントID | 図中の番号 | トレース取得ポイント | レベル |
|---|---|---|---|
| 0x9860 | 1 | カスタム受付フレームワークの入口 | A |
| 0x9861 | 2 | カスタム受付フレームワークの出口 | A |
| 0x9862 | 3 | データ変換(要求電文)の呼び出し口 | B |
| 0x9863 | 4 | データ変換(要求電文)の応答受信口 | B |
| 0x9864 | 5 | HCSCメッセージ配送制御の呼び出し口 | A |
| 0x9865 | 6 | HCSCメッセージ配送制御の応答受信口 | A |
| 0x9866 | 7 | データ変換(応答電文)の呼び出し口 | B |
| 0x9867 | 8 | データ変換(応答電文)の応答受信口 | B |
| 0x986e※ | 9 | カスタム受付フレームワークのJSON-XML変換(要求電文)の呼び出し口 | B |
| 0x986f※ | 10 | カスタム受付フレームワークのJSON-XML変換(応答電文)の応答受信口 | B |
表A-8 性能解析トレースファイルに出力される内容
| 項目 | 内容 |
|---|---|
| イベントID | 取得ポイントのイベントIDが出力されます。 |
| リターンコード | 取得ポイント種別が出力されます。
|
| インターフェース名 | クラス名が出力されます。 パッケージ名は表示されません。 |
| オペレーション名 | メソッド名が出力されます。 |
| オプション情報 | 次のオプション情報が出力されます。
|
性能解析トレースファイルの取得方法および出力先は,アプリケーションサーバおよびサービスプラットフォーム全体で共通です。性能解析トレースファイルの取得方法および出力先については,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7.3 Management Serverを利用した性能解析トレースファイルの収集」を参照してください。
ユーザ電文トレースは,電文の状態を確認するために使用します。
ユーザ電文トレースの取得ポイントを次の図に示します。
図A-14 ユーザ電文トレースの取得ポイント
詳細位置,およびトレース取得ポイントを次の表に示します。なお,表の「図中の番号」は,図中の番号と対応しています。
表A-9 ユーザ電文トレースの取得ポイント
| 図中の番号 | 詳細位置 | トレース取得ポイント |
|---|---|---|
| 1 | IN | カスタム受付フレームワークの入口 |
| 2 | OUT | カスタム受付フレームワークの出口 |
| 3 | RQA※1 | データ変換(要求電文)の応答口 |
| 4 | RSB※1 | データ変換(応答電文)の呼び出し口 |
| 5 | ERR※2 | カスタム受付フレームワークのサービス呼び出し |
表A-10 ユーザ電文トレースに出力される内容(トレース開始)
| 項目 | 内容 | |
|---|---|---|
| 番号 | トレースレコードの出力通番が出力されます。 | |
| 日付 | トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。 | |
| 時刻 | トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。 | |
| 製品ID | 製品を識別するためのIDが出力されます。
|
|
| pid | プロセスを識別するためのIDが出力されます。 | |
| tid | スレッドを識別するためのIDが出力されます。 | |
| ID | − | |
| 電文トレース開始取得ポイント識別情報 | 電文トレース開始 | ユーザ電文トレース開始を示す文字列「telegramtrace started」が出力されます。 |
| 取得位置 | トレースの取得ポイント情報(取得位置)が出力されます。
|
|
| プロトコル種別 | トレースの取得ポイント情報(プロトコル種別)が出力されます。
|
|
| 詳細位置 | トレースの取得ポイント情報(詳細位置)が出力されます。
|
|
| メッセージ共通ID | リクエスト識別情報(親ID)が出力されます。 | |
| 付加情報 | 次の付加情報が出力されます。
|
|
| CRLF | レコード終端符号が出力されます。 | |
表A-11 ユーザ電文トレースに出力される内容(トレースデータ)
| 項目 | 内容 | |
|---|---|---|
| 番号 | トレースレコードの出力通番が出力されます。 | |
| 日付 | トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。 | |
| 時刻 | トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。 | |
| 製品ID | 製品を識別するためのIDが出力されます。
|
|
| pid | プロセスを識別するためのIDが出力されます。 | |
| tid | スレッドを識別するためのIDが出力されます。 | |
| ID | − | |
| 電文トレースデータ情報 | 出力位置 | ユーザ電文の先頭からのオフセット値(16進数形式)が出力されます。 |
| データ (16進数形式) |
ユーザ電文の内容(16進数形式)が出力されます。 | |
| データ (ASCII形式) |
ユーザ電文の内容(ASCII形式)が出力されます。 0x20〜0x7Eの範囲の場合にASCII文字が出力されます。 範囲外の場合は,ピリオド(.)が出力されます。 |
|
| CRLF | レコード終端符号が出力されます。 | |
表A-12 ユーザ電文トレースに出力される内容(トレース終了)
| 項目 | 内容 | |
|---|---|---|
| 番号 | トレースレコードの出力通番が出力されます。 | |
| 日付 | トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。 | |
| 時刻 | トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。 | |
| 製品ID | 製品を識別するためのIDが出力されます。
|
|
| pid | プロセスを識別するためのIDが出力されます。 | |
| tid | スレッドを識別するためのIDが出力されます。 | |
| ID | − | |
| 電文トレース終了取得ポイント識別情報 | 電文トレース終了 | ユーザ電文トレース終了を示す文字列「telegramtrace ended」が出力されます。 |
| 取得位置 | トレースの取得ポイント情報(取得位置)が出力されます。
|
|
| プロトコル種別 | トレースの取得ポイント情報(プロトコル種別)が出力されます。
|
|
| 詳細位置 | トレースの取得ポイント情報(詳細位置)が出力されます。
|
|
| メッセージ共通ID | リクエスト識別情報(親ID)が出力されます。 | |
| 付加情報 | ユーザ電文の長さ(10進数形式)が出力されます。ユーザ電文がない場合は「null」が出力されます。 | |
| CRLF | レコード終端符号が出力されます。 | |
ユーザ電文トレースの取得方法と出力先については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.4 ユーザ電文トレース」を参照してください。
All Rights Reserved. Copyright (C) 2012, 2019, Hitachi, Ltd.