8.1.5 .NET APIのメソッド情報

アプリケーションから呼び出されたメソッド情報は、アプリケーションからの呼出し時、復帰時、および例外発生時に出力されます。

出力形式

APIスナップは、CSV形式で出力します。

以下に、出力レベルごとの出力形式を説明します。

レベル1

メソッド呼出し時

プログラム名,サービスID,スレッド名,日付,時間,Call,クラス名,メソッド名

メソッド復帰時

プログラム名,サービスID,スレッド名,日付,時間,Return,クラス名,メソッド名,メソッド実行時間,,性能情報

エラー復帰時

プログラム名,サービスID,スレッド名,日付,時間,Throw,クラス名,メソッド名,メソッド実行時間,例外クラス名: 例外詳細文字列,性能情報

レベル2

メソッド呼出し時

プログラム名,サービスID,スレッド名,日付,時間,Call,クラス名,メソッド名,,パラメタ情報

メソッド復帰時

プログラム名,サービスID,スレッド名,日付,時間,Return,クラス名,メソッド名,メソッド実行時間,復帰値情報,性能情報

エラー復帰時

プログラム名,サービスID,スレッド名,日付,時間,Throw,クラス名,メソッド名,メソッド実行時間,例外クラス名 : 例外詳細文字列,性能情報

出力内容

以下に出力される項目と内容を説明します。

表8.3 .NET APIのメソッド情報の出力内容の一覧
出力項目	内容	出力レベル
出力項目	内容	レベル1	レベル2
プログラム名	APIを呼び出したプログラム名を出力します。	○	○
サービスID	ShunServiceオブジェクトのIDを出力します。(注1)	○	○
スレッド名	スレッド名を出力します。	○	○
日付	メソッド呼出しの開始/終了の日付を“年/月/日”の形式で出力します。	○	○
時間	メソッド呼出しの開始/終了の時間を“時:分:秒.ミリ秒”の形式で出力します。	○	○
Call Return Throw	“Call”：メソッド呼出し時の情報であることを示します。 “Return”：メソッド復帰時の情報であることを示します。 “Throw”：メソッドで例外が発生したことを示します。	○	○
クラス名	呼び出された.NET APIのクラス名を出力します。	○	○
メソッド名	呼び出された.NET APIのメソッド名を出力します。プロパティの取得または設定時は、それぞれ対応したメソッド名が出力されます。	○	○
メソッド実行時間	メソッド呼出しから復帰までにかかった時間を出力します。単位は秒です。	○	○
パラメタ情報	メソッド呼出し時のパラメタ情報（パラメタの型、値）を以下の形式で出力します。 (パラメタの型)値または (パラメタの型)<Object> パラメタがない場合は、本項目は出力されません。	×	○
復帰値情報	メソッドの復帰値情報（復帰値の型、値）を以下の形式で出力します。 (復帰値の型)値または (復帰値の型)<Object> voidの場合は、本項目は出力されません。	×	○
例外クラス名	メソッド呼出しで例外が発生した場合の例外クラス名を出力します。また、発生した例外に詳細文字列が含まれている場合は、その詳細文字列も出力されます。	○	○
性能情報	性能ログに出力されている依頼番号（Shunsakuシステム内で一意な番号）を出力します。(注2) 依頼番号は、conductorおよびdirectorで採番されます。(注2)	○(注3)	○(注3)

○：出力される項目
×：出力されない項目

注1) ShunServiceオブジェクトに関係なく作成されたオブジェクトは、そのメソッド情報のサービスIDには0が出力されます。
注2) 性能ログの出力内容については、“導入・運用ガイド”の“性能ログの出力情報”を参照してください。
注3) 性能情報を出力したい場合は、API用動作環境ファイルのPfmLogパラメタの設定が必要です。

出力例

スナップに出力する情報は、.NET APIが動作するプラットフォームの文字コードで出力します。

以下に、出力例を出力レベルごとに示します。

レベル1

正常終了時

"sample.exe",2,"(3964)","2006/04/19","21:32:35.151","Call","ShunService","GetHitCount",,,
"sample.exe",2,"(3964)","2006/04/19","21:32:35.198","Return","ShunService","GetHitCount",0.046875,,"44462b7f00000002"

異常終了時

"sample.exe",2,"(3964)","2006/04/19","21:32:35.198","Call","ShunService","GetHitCount",,,
"sample.exe",2,"(3964)","2006/04/19","21:32:35.214","Throw","ShunService","GetHitCount",0.015625,"InvalidOperationException: 
shn30910u:Connection has not been connected.",

レベル2

正常終了時

"sample.exe",2,"(3436)","2006/04/19","21:33:37.417","Call","ShunService","GetHitCount",,"(String) /document/base/prefecture == '大阪' ",
"sample.exe",2,"(3436)","2006/04/19","21:33:37.448","Return","ShunService","GetHitCount",0.03125,"(Int32) 5 ","44462b7f00000004"

異常終了時

"sample.exe",2,"(3436)","2006/04/19","21:33:37.448","Call","ShunService","GetHitCount",,"(String) /document/base/prefecture == '大阪' ",
"sample.exe",2,"(3436)","2006/04/19","21:33:37.464","Throw","ShunService","GetHitCount",0.015625,"InvalidOperationException: 
shn30910u:Connection has not been connected.",

ポイント

文字列項目は二重引用符(")で囲みます。
数値項目は二重引用符(")で囲みません。

参考

採取したスナップは、サービスIDやスレッド名を利用することで操作を時系列でトレースすることが可能です。