アクティビティ ID の伝達

  • [アーティクル]

伝達は、ServiceModel アクティビティ トレースが有効な場合 (ServiceModel 伝達) または無効な場合 (ユーザーからユーザーへのアクティビティ伝達) に実行されます。

ServiceModel アクティビティ トレースが有効な場合

ServiceModel アクティビティ トレースが有効な場合、伝達は ProcessAction アクティビティ間で実行されます。

サーバー

クライアントとサーバーの両方で propagateActivity 属性が true に設定されている場合、サーバーの ProcessAction アクティビティの ID は、伝達された ActivityId メッセージ ヘッダーの ID と同じです。

メッセージに ActivityId ヘッダーが存在しない場合 (つまり、クライアントで propagateActivity=false の場合)、またはサーバーで propagateActivity=false の場合、サーバーは新しいアクティビティ ID を生成します。

Client

クライアントが同期的にシングル スレッドで動作する場合、クライアントは、クライアントまたはサーバー側で propagateActivity の設定を無視します。 代わりに、応答は要求アクティビティで処理されます。 クライアントが非同期的または同期的にマルチスレッドで動作し、クライアントで propagateActivity=true になっていて、サーバーから送信されたメッセージにアクティビティ ID ヘッダーがある場合、クライアントは、そのメッセージからアクティビティ ID を取得し、伝達されたアクティビティ ID を含んでいる "プロセス アクション" アクティビティに転送します。 それ以外の場合、クライアントは、"プロセス メッセージ" アクティビティから新しい "プロセス アクション" アクティビティに転送します。 この新しい "プロセス アクション" アクティビティへの転送は、整合性を維持するために行われます。 このアクティビティの内部で、クライアントは、スレッドが応答メッセージ処理用に割り当てられている場合、ローカル スレッド コンテキストから BeginCall アクティビティのアクティビティ ID を取得します。 その後、最初の "プロセス アクション" アクティビティに転送します。

クライアントが双方向の場合、クライアントは、メッセージを受信するときにサーバーとして機能します。

エラー メッセージの伝達

有効なメッセージの処理とエラー メッセージの処理に違いはありません。 propagateActivity=true の場合、SOAP エラー メッセージのヘッダーに追加されるアクティビティ ID は、アンビエント アクティビティと同じです。

ServiceModel アクティビティ トレースが無効な場合

ServiceModel アクティビティ トレースが無効な場合、伝達は、ServiceModel アクティビティを通過せずに直接ユーザー コード アクティビティ間で実行されます。 ユーザー定義のアクティビティ ID もメッセージ アクティビティ ID ヘッダーによって伝達されます。

propagateActivity=true で、ServiceModel トレース リスナーが ActivityTracing=off の場合 (トレースが ServiceModel で有効かどうかに関係なく)、クライアントとサーバーのいずれかで次の動作が発生します。

  • 要求の処理時または応答の送信時に、TLS のアクティビティ ID は、メッセージが作成されるまでユーザー コードの外部で伝達されます。 また、アクティビティ ID ヘッダーは、メッセージが送信される前にメッセージに挿入されます。

  • 要求の受信時または応答の受信時に、アクティビティ ID は、受信したメッセージのオブジェクトが作成されしだい、メッセージ ヘッダーから取得されます。 TLS のアクティビティ ID は、メッセージがスコープから消えるとすぐに、ユーザー コードに到達するまで伝達されます。

このアクションによって、伝達が有効な場合にユーザー トレースが同じアクティビティに表示されることが保証されます。 ただし、ServiceModel トレースに対する保証はありません。 ServiceModel トレースは、このトレースの処理がユーザー コード アクティビティが設定されたのと同じスレッドで実行される場合のみ、ユーザー コード アクティビティで実行されます。

通常、ServiceModel トレースは、次の場所で確認できます。

  • ServiceModel トレースが無効な場合、出力されたすべてのトレースは、ユーザー アクティビティに表示されます。 サーバーとクライアントの両方で伝達が有効な場合、このトレースは同じアクティビティに表示されます。

  • ServiceModel トレースが有効で、ActivityTracing が無効の場合、ユーザー トレースは、サーバーとクライアントの両方で伝達が有効な場合は同じアクティビティに表示されます。 ServiceModel トレースは、既定の 0000 アクティビティに表示されます。ただし、このトレースが、アクティビティが最初に設定されたユーザー コード処理と同じスレッドで実行される場合を除きます。

  • ServiceModel トレースと ActivityTracing が両方とも有効な場合、ユーザー トレースは、ユーザー定義のアクティビティに表示され、ServiceModel トレースは、ServiceModel 定義のアクティビティに表示されます。 伝達は、ServiceModel レベルで実行されます。