Controlling Correlation Header Location
In 4.4 and earlier, when WCF calls execute on a downstream tier, Splunk AppDynamics includes them as part of the business transaction from the originating tier. If the downstream WCF service uses the NetTcpBinding in WCF, you must register the app agent node property enable-soap-header-correlation with a value of true. See 'enable-soap-header-correlation' on App Agent Node Properties Reference. Otherwise, the .NET Agent will detect the WCF call as the entry point for a new business transaction.
In the following table, when the node property is set to the default (false), the correlation message with header will only successfully deliver when sent over HTTP, not over SOAP with an HTTP wrapper or other protocol. When the node property is set to true, the correlation message with header will succeed in all scenarios.
| enable-soap-header-correlation | HTTP | SOAP (HTTP) | SOAP (other) | |
|---|---|---|---|---|
| 4.4 (default) | false | X | - | - |
| 4.4 | true | X | X | X |
In 4.4.1 and later, the enable-soap-header-correlation node property and the default behavior for SOAP calls over non-HTTP protocols in WCF have changed. In addition, a new property, disable-soap-header-correlation-non-http, has been added. See disable-soap-header-correlation-non-http on App Agent Node Properties Reference. With the new default Splunk AppDynamics will, by default, include downstream WCF services using NetTcpBinding as part of business transactions.
The following table captures the changes and additions of the correlation data for the following use cases:
- When the node properties for both
enable-soap-header-correlationanddisable-soap-header-correlation-non-httpare set to the default (false), the correlation message with header will only successfully deliver when sent over HTTP or SOAP wrapped in a protocol other than HTTP. - When the node property for
enable-soap-header-correlationis set totrue, and thedisable-soap-header-correlation-non-httpnode property is set to the default (false), the correlation message with header will succeed in all scenarios. - When the node property for
enable-soap-header-correlationis set to the default (false), and thedisable-soap-header-correlation-non-httpnode property is set totrue, the correlation message with header will only successfully deliver when sent over HTTP, not over SOAP with an HTTP wrapper or other protocol. - When the node properties for both
enable-soap-header-correlation anddisable-soap-header-correlation-non-httpare set totrue, the correlation message with header will only successfully deliver when sent over HTTP or SOAP with an HTTP wrapper, not over SOAP with another protocol.
enable-soap-header-correlation property retains its previous value and disable-soap-header-correlation-non-http defaults to false.
| enable-soap-header-correlation | disable-soap-header-correlation-non-http | HTTP | SOAP (HTTP) | SOAP (other) | |
|---|---|---|---|---|---|
| 4.5 (default) | false | false | X | - | X |
| 4.5 | true | false | X | X | X |
| 4.5 | false | true | X | - | - |
| 4.5 | true | true | X | X | - |
By default, the .NET Agent does not correlate EUM transactions for WCF entry points. You can enable EUM correlation for WCF using the wcf-enable-eum node property. This feature is useful when an instrumented mobile application calls directly into a WCF entry point. See 'wcf-enable-eum' on App Agent Node Properties Reference.