メッセージフローの概要

[アーティクル]
05/10/2023

相互接続されたサービスを持つ分散システムでは、サービス間の因果関係を調べる必要があります。状態監視、トラブルシューティング、根本原因分析などの重要なシナリオをサポートするには、要求フローに含まれるさまざまなコンポーネントを理解することが重要です。 .NET Framework 4 では、多様なサービス間でトレースを関連付けることができるように、次の機能のサポートが追加されています。

分析トレース: Event Tracing for Windows (ETW) を使用したトレース機能です。詳細度が低く、パフォーマンスに優れています。
WCF/WF サービス用のエンドツーエンドのアクティビティモデル: System.ServiceModel 名前空間および System.Workflow.ComponentModel 名前空間が生成するトレースの相関関係をサポートする機能です。
WF の ETW 追跡: この機能では、WF サービスによって生成された追跡レコードを使用して、ワークフローの現在の状態と進行状況を把握します。

追跡レコードまたはトレースレコードに記録されたエラーを使用して、コード障害や誤った形式のメッセージを検出できます。エラー状態のアクティビティの特定には、イベントのメッセージヘッダーにある Correlation ノードの ActivityId プロパティを使用することができます。アクティビティ ID ごとにメッセージフローのトレースを有効にする方法については、「メッセージフローのトレースの構成」を参照してください。このトピックでは、チュートリアル入門で作成されたプロジェクトでメッセージフローのトレースを有効にする方法を示します。

チュートリアル入門で作成されたプロジェクトでメッセージフローのトレースを有効にするには

[スタート] ボタン、 [ファイル名を指定して実行] の順にクリックし、「eventvwr.exe」と入力してイベントビューアーを開きます。
分析トレースを有効にしていない場合は、 [アプリケーションとサービスログ] 、 [Microsoft] 、 [Windows] 、 [アプリケーションサーバー - アプリケーション] の順に展開します。 [表示] 、 [分析およびデバッグログの表示] の順にクリックします。 [分析] を右クリックし、 [ログの有効化] を選択します。トレースが表示されるように、イベントビューアーを開いたままにします。
Visual Studio 2012 を使用して概要チュートリアルで作成したサンプルを開きます。サービスを作成できるように、管理者として Visual Studio 2012 を実行する必要があることに注意してください。 WCF サンプルがインストールされている場合、このチュートリアルで作成する完成済みのプロジェクトが含まれている入門サンプルを開くことができます。
Service プロジェクトを右クリックして、 [追加] 、 [新しい項目] の順にクリックします。 [アプリケーション構成ファイル] をクリックし、 [OK] をクリックします。

上の手順で作成した App.Config ファイルに次のコードを追加します。

<system.serviceModel>
  <diagnostics>
    <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>
  </diagnostics>
</system.serviceModel>

Ctrl キーを押しながら F5 キーを押して、サーバーアプリケーションをデバッグなしで実行します。 Client プロジェクトを右クリックし、 [デバッグ] 、 [新しいインスタンスを開始] の順にクリックして、Client プロジェクトを実行します。
クライアントからサーバーへのイベントをトレースするには、Client プロジェクトのアプリケーション構成ファイルに次の内容を追加します。
```
<diagnostics>
  <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>
</diagnostics>
```
クライアントの Program.cs に、次の using ディレクティブを追加します。
```
using System.Diagnostics;
```
クライアントプロジェクトの program.cs ファイルの Main メソッドで、トレース GUID がイベントログで伝達されるように設定します。
```
Guid guid = Guid.NewGuid();
Trace.CorrelationManager.ActivityId = guid;
```
最新の情報に更新し、[分析] ログを調べます。イベント ID が 220 のイベントを探します。イベントを選択し、プレビューペインで [詳細] タブをクリックします。このイベントには、呼び出し元アクティビティの相関 ID が含まれています。
```
<Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" />
```
Note

ActivityID に同じ GUID を持つすべてのイベントは、1 つの要求に関連しています。これは、特定のクライアントから特定のサービスへメッセージを関連付けるために使用できます。このクライアントが別のサービスを呼び出した場合、同じクライアントが ActivityID によって識別されます。
場合によっては、ActivityID が元の GUID から新しい ActivityID に変更されます。その場合、転送イベントが生成されます。このイベント ID は 499 で、イベントのヘッダーに次のデータが格納されます。
```
<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event">
    <System>
        <Provider Name="Microsoft-Windows-Application Server-Applications" Guid="{c651f5f6-1c0d-492e-8ae1-b4efd7c9d503}" />
        <EventID>499</EventID>
        ...
        <Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" RelatedActivityID="{85FC0930-9C49-42DA-804B-A7368104BD1B}" />
        ...
   </System>
</Event>
```
Note

転送イベントは、アクティブな ActivityID が、ActivityID として指定された GUID から RelatedActivityID として指定された GUID に変更されたことを記録します。転送イベントの生成後は、すべてのイベントに新しい GUID が ActivityID として格納されます。

次の方法で共有

メッセージフローの概要

チュートリアル入門で作成されたプロジェクトでメッセージフローのトレースを有効にするには

その他のリソース

次の方法で共有

メッセージ フローの概要

チュートリアル入門で作成されたプロジェクトでメッセージ フローのトレースを有効にするには

その他のリソース

メッセージフローの概要

チュートリアル入門で作成されたプロジェクトでメッセージフローのトレースを有効にするには