2.11.5 TP1/Serverの性能検証用トレース
TP1/Serverの性能検証用トレース(PRFトレース)とは,TP1/Server上で動作する各種サービスの,主なイベントのトレース情報です。この性能検証用トレースによって,性能検証,およびトラブルシュートの効率を向上できます。
TP1/Clientでは,TP1/Serverの性能検証用トレースにTP1/Clientが設定した性能検証用の識別情報を出力できます。また,この性能検証用の識別情報は,TP1/ClientのUAPトレースにも出力されます。このため,TP1/Clientの関数実行時間(UAPトレースで取得)と,TP1/Serverのサービスの実行時間(性能検証用トレースで取得)とを照合したり,障害が発生したときに,処理がどこまで到達したかを知ることができます。
- 〈この項の構成〉
(1) TP1/Serverへの性能検証用の識別情報の伝播
TP1/Serverへ性能検証用の識別情報を伝播する場合は,クライアント環境定義DCCLTPRFINFOSENDにYを指定します。
ただし,TP1/Serverのバージョンによっては,伝播できない場合があります。詳細については,マニュアル「OpenTP1 運用と操作」,またはマニュアル「TP1/LiNK 使用の手引」を参照してください。
(2) TP1/ServerとTP1/Clientとのトレースの照合
クライアント環境定義DCCLTPRFINFOSENDにYを指定した場合,TP1/Serverに送信する電文中に,dc_clt_cltin_s関数ごとに一意となる識別情報(IPアドレスなど)を付加できます。付加した情報は,TP1/ClientのUAPトレースに出力されます。また,これと同じ情報はTP1/Serverの性能検証用トレースにも出力されます。
このTP1/ClientのUAPトレースと,TP1/Serverの性能検証用トレースとを照合することで,TP1/ClientとTP1/Serverとの間の,一連の処理の流れを知ることができます。
ただし,クライアント環境定義DCTRCUAPの指定が有効でない場合は,UAPトレースに性能検証用の識別情報は出力されません(TP1/Serverへ性能検証用の識別情報は伝播します)。
(3) 性能検証用トレースの識別情報
TP1/Clientの性能検証用の識別情報は,TP1/ClientのUAPトレース,およびTP1/Serverの性能検証用トレースに出力されます。
(a) 性能検証用の識別情報として取得する情報
性能検証用の識別情報として取得する情報について,次に示します。
- ノードID:aa[bb](4バイトの英数字)
-
aa:次の値が出力されます。
-
TP1/Client/Wの場合:_W
-
TP1/Client/Pの場合:_P
bb:ランダムな2文字の英数字(数字(0〜9)またはアルファベット(A〜Z,a〜z))
-
- ルート通信通番:[xxxxxxxx](4バイトの16進表示のデータ)
-
xxxxxxxx:IPアドレス
- RPC通信通番:[yyyy][zzzz](4バイトの16進表示のデータ)
-
yyyy:ランダムな2バイトの16進数字
zzzz:通信通番(該当する関数の呼び出しごとにインクリメントされます)
(b) トレースの出力例
ノードID「_WOX」,ルート通信通番「f784d10a」,RPC通信通番「4e880002」の場合の出力例を次に示します。
- TP1/ClientのUAPトレースの出力例
-
関数入り口情報(EVENT=BEGIN)と関数出口情報(EVENT=END)の間で出力されます。取得ポイントは,送信前です。
DATE = 2008/08/11 TIME = 05:08:35.603 PID = 2072:3152 SIZE = 26 FUNC = dc_rpc_call_s EVENT = PRF Address +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f 0123456789abcdef 00000000 5f 57 4f 58 2f 30 78 66 37 38 34 64 31 30 61 2f _WOX/0xf784d10a/ 00000010 30 78 34 65 38 38 30 30 30 32 0x4e880002
- TP1/Serverの性能検証用トレースの出力例
PRF: Rec Node: smpl Run-ID: 0x4743dfcc Process: 53000 Trace: 4 Event: 0x1003 Time: 2008/08/11 05:08:36 583.000.000 Server-name: svgrp Rc: 0 Client: - 0x4e880002 Server: **** Root: _WOX - 0xf784d10a Svc-Grp: ******************************** Svc: ****************************** Trn: *
(4) トレース情報の取得ポイント
TP1/Clientでは,次に示す関数を実行すると,UAPトレースに性能検証用の識別情報が出力されます。
-
dc_rpc_call_s関数
-
dc_rpc_call_to_s関数
-
dc_clt_connect_s関数
-
dc_clt_disconnect_s関数
-
dc_trn_begin_s関数
-
dc_trn_chained_commit_s関数
-
dc_trn_chained_rollback_s関数
-
dc_trn_unchained_commit_s関数
-
dc_trn_unchained_rollback_s関数