ユーザー コード トレースの出力

Windows Communication Foundation (WCF) により生成されるインストルメンテーション データを収集するには、構成内でトレースを有効にする方法に加えて、ユーザー コードのプログラムによりトレースを出力することもできます。この方法では、インストルメンテーション データを能動的に作成でき、後でそのデータを診断目的で詳細に調べることができます。ここでは、この方法について説明します。

また、Extending Tracingサンプルには、次の各セクションで取り上げるすべてのコードが含まれています。

トレース ソースの作成

ユーザー トレース ソースを作成するには、次のコードを使用できます。

TraceSource ts = new TraceSource("myUserTraceSource");

アクティビティの作成

アクティビティは論理的な処理単位です。トレースをグループ化する主要な処理単位ごとに 1 つのアクティビティを作成できます。たとえば、サービスの要求ごとに 1 つのアクティビティを作成できます。これを行うには、次の手順を実行します。

1. スコープでアクティブ ID を保存します。
2. 新しいアクティビティ ID を作成します。
3. スコープ内のアクティビティから新しいアクティビティに移り、スコープ内に新しいアクティビティを設定し、そのアクティビティの Start トレースを出力します。

次のコードは、この設定方法を示しています。

Guid oldID = Trace.CorrelationManager.ActivityId;
Guid traceID = Guid.NewGuid();
ts.TraceTransfer(0, "transfer", traceID);
Trace.CorrelationManager.ActivityId = traceID; // Trace is static
ts.TraceEvent(TraceEventType.Start, 0, "Add request");

ユーザー アクティビティ内でのトレースの出力

ユーザー アクティビティ内でトレースを出力するコードを次に示します。

double value1 = 100.00D;
double value2 = 15.99D;
ts.TraceInformation("Client sends message to Add " + value1 + ", " + value2);
double result = client.Add(value1, value2);
ts.TraceInformation("Client receives Add response '" + result + "'");

アクティビティの停止

アクティビティを停止するには、旧アクティビティに戻り、現在のアクティビティ ID を停止して、スコープで旧アクティビティをリセットします。

次のコードでは、この設定方法について説明します。

ts.TraceTransfer(0, "transfer", oldID);
ts.TraceEvent(TraceEventType.Stop, 0, "Add request");
Trace.CorrelationManager.ActivityId = oldID;

サービスへのアクティビティ ID の伝達

クライアントとサービスの両方の構成ファイルで、System.ServiceModel トレース ソースの propagateActivity 属性を true に設定した場合、Add 要求に対するサービス処理は、クライアントに定義されたものと同じアクティビティで発生します。サービスに独自のアクティビティと転送が定義されている場合、そのサービス トレースは、クライアントにより伝達されたアクティビティには表示されません。その代わり、クライアントから ID が伝達されたアクティビティに、転送トレースにより、関連付けられたアクティビティにサービス トレースが表示されます。

メモ :
propagateActivity 属性がクライアントとサービスの両方で true に設定されている場合、WCF によりサービスの操作スコープ内のアンビエント アクティビティが設定されます。

次のコードを使用して、アクティビティが WCF によってスコープ内に設定されたかどうかをチェックできます。

// Check if an activity was set in scope by WCF, i.e., if it was 
// propagated from the client. If not, i.e., ambient activity is 
// equal to Guid.Empty, create a new one.
if(Trace.CorrelationManager.ActivityId == Guid.Empty)
{
    Guid newGuid = Guid.NewGuid();
    Trace.CorrelationManager.ActivityId = newGuid;
}
// Emit your Start trace.
ts.TraceEvent(TraceEventType.Start, 0, "Add Activity");

// Emit the processing traces for that request.
serviceTs.TraceInformation("Service receives Add " 
                            + n1 + ", " + n2);
// double result = n1 + n2;
serviceTs.TraceInformation("Service sends Add result" + result);

// Emit the Stop trace and exit the method scope.
ts.TraceEvent(TraceEventType.Stop, 0, "Add Activity");
// return result;

コード内でスローされる例外のトレース

コード内で例外をスローする場合、次のコードを使用して警告以上のレベルでその例外をトレースすることもできます。

ts.TraceEvent(TraceEventType.Warning, 0, “Throwing exception “ + “exceptionMessage”);

サービス トレース ビューア ツールでのユーザー トレースの表示

このセクションには、「Extending Tracing」のサンプルを実行することによって生成されたトレースを、Service Trace Viewer Toolを使用して表示したときのスクリーンショットが含まれています。

次の図の左ペインでは、以前に作成した “Add 要求” アクティビティが選択されています。アプリケーション クライアント プログラムを構成する他の 3 つの算術演算アクティビティ (Divide、Subtract、Multiply) も表示されています。どの要求でどのようなエラーが発生したかを明確にするため、ユーザー コードでは、操作ごとに新しいアクティビティが 1 つ定義されています。

「Extending Tracing」のサンプルでは、転送の使用方法を示すために 4 つの操作要求をカプセル化した Calculator アクティビティも作成されています。要求があるたびに、Calculator アクティビティから該当する要求のアクティビティへ、または該当する要求のアクティビティから Calculator アクティビティへ移転します (図の右上のパネルにトレースが表示されています)。

左のパネルでアクティビティを選択すると、そのアクティビティによって追加されたトレースが右上のパネルに表示されます。要求パス内の各エンドポイントで propagateActivity に true が設定されている場合、要求アクティビティのトレースは、その要求に関連するすべてのプロセスから取り込まれます。このサンプルでは、クライアントおよびサービスからのトレースをパネルの 4 番目の列で参照できます。

このアクティビティは次の順序で処理を行います。

1. クライアントはメッセージを Add に送信します。
2. サービスは Add 要求メッセージを受信します。
3. サービスは Add 応答を送信します。
4. クライアントは Add 応答を受信します。

これらすべてのトレースは、Information レベルで出力されています。右上のパネルでトレースをクリックすると、トレースの詳細が右下のパネルに表示されます。

次の図には、Calculator アクティビティと要求アクティビティ間の転送トレースに加え、1 つの要求アクティビティについて Start トレースと Stop トレースが 2 組表示されています。1 組はクライアントのトレースで、もう 1 組はサーバーのトレースです (各トレース ソースにつき 1 組)。

クライアントがスローする原因となる例外を、サービス コードがスローする場合 (たとえば、クライアントが要求に対する応答を取得できなかった場合など)、直接的な相関関係を示すために、サービスとクライアントの両方の警告メッセージまたはエラー メッセージは、同じアクティビティ内に発生します。次の図の場合、サーバーは、"この要求をユーザー コードで処理することをサービスが拒否した" という状態を知らせる例外をスローしています。また、クライアントも、"内部エラーによりサーバーが要求を処理できない" という状態を知らせる例外をスローしています。

左パネルの Multiply アクティビティをダブルクリックすると、次のグラフが表示されます。関連するプロセスごとの Multiply アクティビティに対するトレースが示されます。まずサービスで発生した警告 (スローされた例外) が表示され、それに続いて、要求を処理できなかったために発生したクライアントの警告とエラーが表示されます。したがって、エンドポイント間のエラーの因果関係が示され、エラーの根本的な原因を導き出すことができます。

以前のトレースを取得するには、ユーザー トレース ソースに対して ActivityTracing を設定し、System.ServiceModel トレース ソースに対して propagateActivity=true を設定します。ユーザー コード間のアクティビティの伝達を有効にするため、System.ServiceModel トレース ソースの ActivityTracing は設定されていません (ServiceModel アクティビティがオンになっている場合、クライアントに定義されているアクティビティ ID がサービス ユーザー コードにまで伝達されることはありません。ただし、転送は、クライアントおよびサービスのユーザー コード アクティビティと、中間の WCF アクティビティを相互に関連付けます)。

アクティビティを定義してアクティビティ ID を伝達することにより、エンドポイント間でエラーの直接相関関係を実行できます。このようにして、エラーの根本原因をよりすばやく見つけることができるようになります。

関連項目

その他の技術情報

Extending Tracing