相関追跡を設定する

プロセスにまたがるトランザクション追跡では、エージェントはあるプロセスから別のプロセスへ渡すことができる相関識別子を挿入する必要があります。エージェントはこの相関識別子を SOAP ヘッダまたは HTTP ヘッダに挿入できます。

ほとんどのサービスが SOAP メッセージングを使用するため、相関識別子は SOAP ヘッダにデフォルトで挿入され、そのヘッダから読み取られます。ただし、ある特定の状況では、HTTP ヘッダを使用して相関識別子を渡すことが優先される場合があります。たとえば、まれな状況ですが、SOAP ヘッダに相関識別子を追加すると、メッセージが拒否される場合があります。これは、相関 ID によって SOAP ペイロードが変更されるためです。

アプリケーションがどのように SOAP メッセージを処理するか、どのようにセキュリティを実装したかに応じて、IntroscopeAgent.profile ファイルを修正して、HTTP ヘッダまたは SOAP ヘッダのいずれで相関 ID を渡すかを選択できます。

クライアント側およびサーバ側の相関識別子の処理を制御する 4 つのエージェント設定プロパティがあります。これらのプロパティを使用して、相関識別子を SOAP ヘッダ、HTTP ヘッダ、または両方のヘッダプロトコルに挿入するか、まったく挿入しないかを指定できます。これらのプロパティは、以下の標準のエージェントプレフィックス com.wily.introscope.agent で始まります。

soapheaderinsertion.enabled

クライアントが SOAP ヘッダに相関識別子を挿入することを有効にします。

クライアントが SOAP ヘッダを使用できるようにするには、このプロパティを true に設定します。
クライアントが SOAP ヘッダに相関識別子を挿入しないようにするには、このプロパティを false に設定します。

デフォルトでは、このプロパティは true に設定されています。

httpheaderinsertion.enabled

クライアントが HTTP ヘッダに相関識別子を挿入することを有効にします。

クライアントが HTTP ヘッダを使用できるようにするには、このプロパティを true に設定します。
クライアントが HTTP ヘッダに相関識別子を挿入しないようにするには、このプロパティを false に設定します。

デフォルトでは、このプロパティは false に設定されています。

soapheaderread.enabled

サーバが SOAP ヘッダから相関識別子を読み取ることを有効にします。

サーバが SOAP ヘッダを使用できるようにするには、このプロパティを true に設定します。
サーバが SOAP ヘッダを読み取らないようにするには、このプロパティを false に設定します。

デフォルトでは、このプロパティは true に設定されています。

httpheaderread.enabled

サーバが HTTP ヘッダから相関識別子を読み取ることを有効にします。

サーバが HTTP ヘッダを使用できるようにするには、このプロパティを true に設定します。
サーバが HTTP ヘッダを読み取らないようにするには、このプロパティを false に設定します。

デフォルトでは、このプロパティは false に設定されています。