配置特定于 SOA 的属性 › 配置关联跟踪

配置关联跟踪

跨进程事务跟踪需要代理插入一个关联标识符，该标识符可从一个进程传递到另一个进程。 代理可将该关联标识符插入 SOAP 或 HTTP 头。

由于大多数服务使用 SOAP 消息，因此默认情况下，从 SOAP 头插入和读取该关联标识符。 但在某些情况下，您可能更愿意使用 HTTP 头传递关联标识符。 例如，在少数情况下，向 SOAP 头添加关联标识符可导致消息被拒绝（由于关联 ID 更改了 SOAP 负载）。

根据应用程序处理 SOAP 消息和您实施安全性的方式，您可以通过修改 IntroscopeAgent.profile 文件来选择在 HTTP 头还是 SOAP 头中传递关联 ID。

有四个代理配置属性可以控制对客户端和服务器上的关联标识符的处理。 您可以通过这些属性来指定标识符应当插入 SOAP 头、HTTP 头、这两种头协议，或者根本不插入。 这些属性以标准代理前缀 com.wily.introscope.agent 开头：

soapheaderinsertion.enabled

允许客户端在 SOAP 头中插入关联标识符。

• 将属性设为 true 以允许客户端使用 SOAP 头。
• 如果希望阻止客户端在 SOAP 头中插入关联标识符，则将属性设为 false。

默认情况下，该属性设置为 true。

httpheaderinsertion.enabled

允许客户端在 HTTP 头中插入关联标识符。

• 将该属性设置为 true 以允许客户端使用 HTTP 头。
• 如果要防止客户端在 HTTP 头中插入关联标识符，可将该属性设置为 false。

默认情况下，该属性设置为 false。

soapheaderread.enabled

允许服务器从 SOAP 头中读取关联标识符。

• 将该属性设置为 true 以允许服务器使用 SOAP 头。
• 如果要防止服务器读取 SOAP 头，可将该属性设置为 false。

默认情况下，该属性设置为 true。

httpheaderread.enabled

允许服务器从 HTTP 头中读取关联标识符。

• 将该属性设置为 true 以允许服务器使用 HTTP 头。
• 如果要防止服务器读取 HTTP 头，可将该属性设置为 false。

默认情况下，该属性设置为 false。