Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム 開発ガイド 受付・アダプタ定義編

[目次][用語][索引][前へ][次へ]

付録A.8 障害情報の取得(カスタム受付)

カスタム受付の運用時に障害が発生すると,障害対策に必要な次の情報が出力されます。

ここでは,ログおよび各種トレースの取得方法について説明します。

<この項の構成>
(1) メッセージログ(カスタム受付)
(2) リクエストトレース(カスタム受付)
(3) 性能解析トレース(カスタム受付)
(4) ユーザ電文トレース(カスタム受付)

(1) メッセージログ(カスタム受付)

メッセージログは,次に示すログに出力されます。

メッセージログの取得方法および出力先については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.1 メッセージログ」に関する内容を参照してください。また,詳細は,マニュアル「サービスプラットフォーム メッセージ」の「2. メッセージ一覧」を参照してください。

(2) リクエストトレース(カスタム受付)

リクエストトレースは,リクエストの障害要因の解析に使用します。

(a) リクエストトレースの取得ポイント

リクエストトレースの取得ポイントを次の図に示します。

図A-12 リクエストトレースの取得ポイント

[図データ]

詳細位置,およびトレース取得ポイントを次の表に示します。なお,表の「図中の番号」は,図中の番号と対応しています。

表A-5 リクエストトレースの取得ポイント

図中の番号 詳細位置 トレース取得ポイント
1 IN カスタム受付フレームワークの入口
2 OUT カスタム受付フレームワークの出口
(b) リクエストトレースの出力形式と出力内容

出力形式
リクエストトレースの出力形式については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.2 リクエストトレース」を参照してください。

出力内容
リクエストトレースに出力される内容を次の表に示します。

表A-6 リクエストトレースに出力される内容

項目 内容
番号 トレースレコードの出力通番が出力されます。
日付 トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。
時刻 トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。
製品ID 製品を識別するためのIDが出力されます。
  • CSCMSG:メッセージング基盤
pid プロセスを識別するためのIDが出力されます。
tid スレッドを識別するためのIDが出力されます。
ID
メッセージ共通ID リクエスト識別情報(親ID)が出力されます。
サービスリクエストID リクエスト識別情報(子ID)が出力されます。
取得ポイント識別情報 取得位置 トレースの取得ポイント情報(取得位置)が出力されます。
  • URCP:ユーザ定義受付
プロトコル種別 トレースの取得ポイント情報(プロトコル種別)が出力されます。
  • CUSTM:カスタム受付
詳細位置 トレースの取得ポイント情報(詳細位置)が出力されます。
  • IN:受付
  • OUT:応答
名称
アダプタ種別
結果 応答結果種別が出力されます。ただし,詳細位置がINの場合は,出力されません。
  • NORMAL:正常終了
  • ERROR:異常終了
付加情報 応答結果の付加情報が出力されます。
  • 受付名
  • 受付ID
  • クライアント相関ID
  • サービス名
  • サービスオペレーション名
CRLF レコード終端符号が出力されます。

(凡例)
−:何も出力されません。

(c) リクエストトレースの取得方法と出力先

リクエストトレースの取得方法と出力先については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.2 リクエストトレース」を参照してください。

(3) 性能解析トレース(カスタム受付)

性能解析トレース(PRFトレース)は,サービスプラットフォームシステムの性能解析をするためのトレース情報で,それをCSV形式で編集出力したテキストファイルが性能解析トレースファイルです。性能解析トレースは,J2EEアプリケーションを含めた,システム全体の性能ボトルネックを解析するための情報が出力されます。システムの性能ネックや性能トラブルシュートに使用します。性能解析トレース機能については,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7. 性能解析トレースを使用した性能解析」を参照してください。

(a) 性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図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:「標準」であることを示します。
B:「詳細」であることを示します。

注※
JSON-XML変換をする場合だけ出力されます。

(b) 性能解析トレースの出力形式と出力内容

出力形式
性能解析トレースファイルに出力される形式は,J2EEサーバの性能解析トレースと同様です。性能解析トレースファイルの詳細は,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7.3 Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

出力内容
性能解析トレースファイルに出力される内容を次の表に示します。

表A-8 性能解析トレースファイルに出力される内容

項目 内容
イベントID 取得ポイントのイベントIDが出力されます。
リターンコード 取得ポイント種別が出力されます。
  • 0:正常終了
  • 1:異常終了
インターフェース名 クラス名が出力されます。
パッケージ名は表示されません。
オペレーション名 メソッド名が出力されます。
オプション情報 次のオプション情報が出力されます。
  • リクエスト識別情報(親ID)
  • リクエスト識別情報(子ID)
  • 受付名
  • 受付ID
  • クライアント相関ID
  • サービス名
  • サービスオペレーション名
  • 例外クラス名(異常終了時だけ)
(c) 性能解析トレースの取得方法と出力先

性能解析トレースファイルの取得方法および出力先は,アプリケーションサーバおよびサービスプラットフォーム全体で共通です。性能解析トレースファイルの取得方法および出力先については,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「7.3 Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(4) ユーザ電文トレース(カスタム受付)

ユーザ電文トレースは,電文の状態を確認するために使用します。

(a) ユーザ電文トレースの取得ポイント

ユーザ電文トレースの取得ポイントを次の図に示します。

図A-14 ユーザ電文トレースの取得ポイント

[図データ]

詳細位置,およびトレース取得ポイントを次の表に示します。なお,表の「図中の番号」は,図中の番号と対応しています。

表A-9 ユーザ電文トレースの取得ポイント

図中の番号 詳細位置 トレース取得ポイント
1 IN カスタム受付フレームワークの入口
2 OUT カスタム受付フレームワークの出口
3 RQA※1 データ変換(要求電文)の応答口
4 RSB※1 データ変換(応答電文)の呼び出し口
5 ERR※2 カスタム受付フレームワークのサービス呼び出し

注※1
データ変換をする場合だけトレースを取得します。

注※2
サービス呼び出しでエラー(システム例外またはフォルト)を検出した場合だけ,要求電文のトレースを取得します。

(b) ユーザ電文トレースの出力形式と出力内容

出力形式
ユーザ電文トレースの出力形式については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.4 ユーザ電文トレース」を参照してください。

出力内容
ユーザ電文トレースに出力される内容を次の表に示します。

表A-10 ユーザ電文トレースに出力される内容(トレース開始)

項目 内容
番号 トレースレコードの出力通番が出力されます。
日付 トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。
時刻 トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。
製品ID 製品を識別するためのIDが出力されます。
  • CSCMSG:メッセージング基盤
pid プロセスを識別するためのIDが出力されます。
tid スレッドを識別するためのIDが出力されます。
ID
電文トレース開始取得ポイント識別情報 電文トレース開始 ユーザ電文トレース開始を示す文字列「telegramtrace started」が出力されます。
取得位置 トレースの取得ポイント情報(取得位置)が出力されます。
  • URCP:ユーザ定義受付
プロトコル種別 トレースの取得ポイント情報(プロトコル種別)が出力されます。
  • CUSTM:カスタム受付
詳細位置 トレースの取得ポイント情報(詳細位置)が出力されます。
  • IN:受付
  • OUT:応答
  • RQA:カスタム受付での要求時のデータ変換後
  • RSB:カスタム受付での応答時のデータ変換前
メッセージ共通ID リクエスト識別情報(親ID)が出力されます。
付加情報 次の付加情報が出力されます。
  • リクエスト識別情報(子ID)(Service Request ID)
  • 受付名(Reception Name)
  • 受付ID(Reception ID)
  • クライアント相関ID(Client ID)
  • サービス名(Service Name)
  • サービスオペレーション名(OP)
  • PRFルートアプリケーション情報(RootApInfo)
CRLF レコード終端符号が出力されます。

(凡例)
−:何も出力されません。

 

表A-11 ユーザ電文トレースに出力される内容(トレースデータ)

項目 内容
番号 トレースレコードの出力通番が出力されます。
日付 トレースレコードの取得日付(yyyy/mm/dd形式)が出力されます。
時刻 トレースレコードの取得時刻(hh:mm:ss.sss形式)が,ローカル時刻で出力されます。
製品ID 製品を識別するためのIDが出力されます。
  • CSCMSG:メッセージング基盤
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が出力されます。
  • CSCMSG:メッセージング基盤
pid プロセスを識別するためのIDが出力されます。
tid スレッドを識別するためのIDが出力されます。
ID
電文トレース終了取得ポイント識別情報 電文トレース終了 ユーザ電文トレース終了を示す文字列「telegramtrace ended」が出力されます。
取得位置 トレースの取得ポイント情報(取得位置)が出力されます。
  • URCP:ユーザ定義受付
プロトコル種別 トレースの取得ポイント情報(プロトコル種別)が出力されます。
  • CUSTM:カスタム受付
詳細位置 トレースの取得ポイント情報(詳細位置)が出力されます。
  • IN:受付
  • OUT:応答
  • RQA:カスタム受付での要求時のデータ変換後
  • RSB:カスタム受付での応答時のデータ変換前
メッセージ共通ID リクエスト識別情報(親ID)が出力されます。
付加情報 ユーザ電文の長さ(10進数形式)が出力されます。ユーザ電文がない場合は「null」が出力されます。
CRLF レコード終端符号が出力されます。

(凡例)
−:何も出力されません。

(c) ユーザ電文トレースの取得方法と出力先

ユーザ電文トレースの取得方法と出力先については,マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「7.4.4 ユーザ電文トレース」を参照してください。