如果客户端未发送，如何获取/设置APIM入站策略中的Traceparent头部？

Question

我们希望将Azure APIM和Application Insight中的请求关联起来。对于API，我们有一个在入站和出站部分使用send-request的策略。我们使用的是W3C distributed tracing Azure、specification

现在，如果客户端不发送traceparent报头，则入站中的send-request在应用程序洞察力中不是相关的。

如果我们试图在入站策略中设置traceparent头，它将在策略的后端部分被覆盖。看起来APIM会检查传入的请求，如果没有设置traceparent，它将生成它。但我们不能向策略中的传入请求添加头部(只读)。

示例策略

<policies>
    <inbound>
        <base />
        <send-request mode="new" response-variable-name="inboundresponse" timeout="10" ignore-error="true">
            <set-url>https://someUrl.com</set-url>
            <set-method>GET</set-method>
            <set-header name="traceparent" exists-action="skip">
                <value>00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01</value>
            </set-header>
            <set-body></set-body>
        </send-request>
        <!-- for test set fixed value, but this value is overwritten by Azure APIM in backend
         and all 3 requests are not coorrelated -->
        <set-header name="traceparent" exists-action="skip">
            <value>00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01</value>
        </set-header>
    </inbound>
    <backend>
        <base />
    </backend>
    <outbound>
        <base />
        <!-- traceparent value we get here is not the same that we set -->
        <send-request mode="new" response-variable-name="outboundresponse" timeout="10" ignore-error="true">
            <set-url>https://someUrl.com</set-url>
            <set-method>GET</set-method>
            <set-header name="traceparent" exists-action="skip">
                <value>00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01</value>
            </set-header>
            <set-body></set-body>
        </send-request>
        
    </outbound>
    <on-error>
        <base />
    </on-error>
</policies>

​

​

Answer 1

您是否尝试过像这样使用set-header策略：

<set-header name="traceparent" exists-action="override">
     <value>00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01</value>
</set-header>

请注意override exists-action。在我的测试中，按预期设置了traceparent并将其发送到后端。

更新

如果您只想在没有可用的情况下设置新的关联上下文头，我建议您使用以下语句：

<set-header name="traceparent" exists-action="skip">
    <value>@($"00-{context.RequestId.ToString("N")}-0000000000000000-01")</value>
</set-header>

使用context.RequestId.ToString("N")，您可以获得请求的内部相关id，并将其格式化，而不使用破折号。另一件事要提的是：

您是否已将设置选项卡中的相关格式设置为W3C？

​

Answer 2

我通过在inbound中添加以下标头解决了我的问题。您可以查看一下documentation。

 <inbound> 
  <allowed-headers>
    .....
    <header>request-id</header>
    <header>request-context</header>
    <header>traceparent</header>
   </allowed-headers>
 </inbound>

Answer 3

可能发生的情况是，它正在生成具有非法格式的traceID，当发生这种情况时，它会生成一个新的格式。

HEXDIGLC = DIGIT / "a" / "b" / "c" / "d" / "e" / "f" ; lowercase hex character
value           = version "-" version-format

See Documentation