トレースの拡張

2025-06-19

ExtendingTracing サンプルは、クライアントおよびサービスコードでユーザー定義アクティビティトレースを記述することによって、Windows Communication Foundation (WCF) トレース機能を拡張する方法を示しています。ユーザー定義のアクティビティトレースを記述すると、ユーザーはトレースアクティビティを作成し、トレースを論理作業単位にグループ化できます。また、転送 (同じエンドポイント内) と伝達 (エンドポイント間) を介してアクティビティを関連付けることもできます。このサンプルでは、クライアントとサービスの両方に対してトレースが有効になっています。クライアントおよびサービス構成ファイルでトレースを有効にする方法の詳細については、「トレースとメッセージログ」を参照してください。

このサンプルは、入門に基づいています。

注

このサンプルのセットアップ手順とビルド手順は、このトピックの最後にあります。

トレースとアクティビティの伝達

ユーザー定義アクティビティトレースを使用すると、ユーザーは独自のトレースアクティビティを作成してトレースを論理作業単位にグループ化し、転送と伝達によってアクティビティを関連付け、WCF トレースのパフォーマンスコスト (ログファイルのディスク領域コストなど) を削減できます。

カスタムソースを追加する

ユーザー定義トレースは、クライアントコードとサービスコードの両方に追加できます。クライアントまたはサービス構成ファイルにトレースソースを追加すると、これらのカスタムトレースを記録し、サービストレースビューアーツール (SvcTraceViewer.exe) に表示できます。次のコードは、 ServerCalculatorTraceSource という名前のユーザー定義トレースソースを構成ファイルに追加する方法を示しています。

<system.diagnostics>
    <sources>
        <source name="System.ServiceModel" switchValue="Warning" propagateActivity="true">
            <listeners>
                <add type="System.Diagnostics.DefaultTraceListener" name="Default">
                    <filter type="" />
                </add>
                <add name="xml">
                    <filter type="" />
                </add>
            </listeners>
        </source>
        <source name="ServerCalculatorTraceSource" switchValue="Information,ActivityTracing">
            <listeners>
                <add type="System.Diagnostics.DefaultTraceListener" name="Default">
                    <filter type="" />
                </add>
                <add name="xml">
                    <filter type="" />
                </add>
            </listeners>
        </source>
    </sources>
    <sharedListeners>
       <add initializeData="C:\logs\ServerTraces.svclog" type="System.Diagnostics.XmlWriterTraceListener"
        name="xml" traceOutputOptions="Callstack">
            <filter type="" />
        </add>
    </sharedListeners>
    <trace autoflush="true" />
</system.diagnostics>
....

アクティビティの関連付け

エンドポイント間でアクティビティを直接関連付けるためには、propagateActivity トレースソースでtrueにSystem.ServiceModel属性を設定する必要があります。また、WCF アクティビティを経由せずにトレースを伝達するには、ServiceModel アクティビティトレースをオフにする必要があります。これは、次のコード例で確認できます。

注

ServiceModel アクティビティトレースをオフにすることは、 switchValue プロパティで示されるトレースレベルをオフに設定するのと同じではありません。

<system.diagnostics>
    <sources>
      <source name="System.ServiceModel" switchValue="Warning" propagateActivity="true">

    ...

       </source>
    </sources>
</system.diagnostics>

パフォーマンスコストの削減

ActivityTracing トレースソースでSystem.ServiceModelをオフに設定すると、ServiceModel アクティビティトレースが含まれていなくても、ユーザー定義のアクティビティトレースのみを含むトレースファイルが生成されます。 ServiceModel アクティビティトレースを除外すると、ログファイルがはるかに小さくなります。ただし、WCF 処理トレースを関連付ける機会は失われます。

サンプルを設定、ビルド、実行する

Windows Communication Foundation サンプルのOne-Time セットアップ手順を実行していることを確認します。
ソリューションの C# または Visual Basic .NET エディションをビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
シングルコンピューター構成またはクロスコンピューター構成でサンプルを実行するには、「 Windows Communication Foundation サンプルの実行」の手順に従います。

こちらも参照ください

AppFabric 監視のサンプル

次の方法で共有