如何实现Azure APIM全链路追踪至后端服务请求全过程？
摘要：问题描述 在使用 Azure API Management 时，常见的场景是客户端请求先经过 APIM 网关，再转发到后端服务 API。 当出现问题时，运维人员需要确认请求是否成功到达 APIM，以及是否被正确转发到后端服务。 然而，默认情
问题描述
在使用 Azure API Management 时，常见的场景是客户端请求先经过 APIM 网关，再转发到后端服务 API。
当出现问题时，运维人员需要确认请求是否成功到达 APIM，以及是否被正确转发到后端服务。
然而，默认情况下，跨网关和后端的请求链路缺乏统一标识，导致排查困难。
为实现全链路跟踪，需要配置一个唯一 ID，使其在请求进入 APIM、转发到后端以及返回客户端时保持一致。
问题解答
在 APIM 中，可以通过 RequestId 实现唯一标识，并将其注入请求和响应的 Header，从而实现全链路跟踪。
具体步骤如下：
第一步：在 API Policy 中设置 Header
在 API 的 inbound、outbound 和 on-error 部分添加 set-header 策略，将 context.RequestId 写入自定义 Header（如 x-request-id）：
<policies>
<!-- Throttle, authorize, validate, cache, or transform the requests -->
<inbound>
<base />
<set-header name="x-request-id" exists-action="override">
<value>@(context.RequestId.ToString())</value>
</set-header>
</inbound>
<!-- Control if and how the requests are forwarded to services -->
<backend>
<base />
</backend>
<!-- Customize the responses -->
<outbound>
<base />
<set-header name="x-request-id" exists-action="override">
<value>@(context.RequestId.ToString())</value>
</set-header>
</outbound>
<!-- Handle exceptions and customize error responses -->
<on-error>
<base />
<set-header name="x-request-id" exists-action="override">
<value>@(context.RequestId.ToString())</value>
</set-header>
</on-error>
</policies>
第二步：启用诊断日志
在 APIM 的 Diagnostic settings 中配置日志，将 x-request-id 字段记录到 Azure Monitor 或 Log Analytics，以便后续查询。
第三步：客户端验证
配置完成后，客户端在响应 Header 中也能看到 x-request-id，通过该 ID 可以在日志中追踪请求的完整路径。
注意事项：
Correlation ID 虽然用于整体链路跟踪，但在 APIM 的 context 中无法直接获取，因此推荐使用 RequestId。
参考资料
Set header ：https://learn.microsoft.com/en-us/azure/api-management/set-header-policy
[END]