You need to enable JavaScript to run this app. 如何通过通用标识在LogAnalyticWorkspace中追踪Azure多组件请求
优惠活动
大模型
产品
解决方案
定价
更多

如何通过通用标识在LogAnalyticWorkspace中追踪Azure多组件请求

可跨全链路复用的追踪关联标识

你这套Azure链路涉及的所有组件,均原生支持两类可直接用于全链路串联的标识,无需大规模改造,且所有标识都会被各节点记录到统一Log Analytics工作区中。

开箱即用的原生通用标识

  • W3C Trace Context标准请求头:所有涉及组件默认不会拦截、篡改该头,会完整从入站请求透传到下游节点
    • 链路最前端的WAFv2 AppGW:会把收到的traceparent、tracestate头完整写入访问日志、WAF日志的结构化请求头字段,不会做任何内容修改,且被WAF拦截的请求也会完整记录这些头值,可以覆盖断链场景的排查
    • APIM实例:默认透传所有W3C标准头到下游,网关日志会完整记录透传的头值
    • 无WAF的AppGW:默认不拦截自定义标准头,请求透传到ACI时会完整保留W3C头集合
    • ACI上运行的应用:只要是通用的现代开发栈(.NET/Java/Node.js/Python),支持自动从请求头提取W3C上下文值写入自身日志
      其中traceparent头的格式为00-{32位全局唯一traceid}-{16位当前节点spanid}-{标记位},中间的32位traceid是全链路统一值,可作为跨所有节点的关联主键。
  • 结构化公共字段映射:就算没有自定义头,所有节点的日志都会记录请求方法、原始请求路径、客户端IP、到达时间这几个结构化字段,配合1分钟级的时间窗口,可以做低精度的兜底关联,适合排查WAF拦截这类没有透传头的异常场景。

需要轻量配置的高可靠性自定义标识

如果排查发现部分老客户端不会自动生成W3C标准头,可以配置一个跨全链路透传的自定义关联头:

  • 自定义x-correlation-id请求头:在最前端的WAFv2 AppGW上配置规则,当检测到入站请求没有携带该头时,自动生成一个UUID作为该头的值向后传递
  • 所有中间节点默认不会拦截x-开头的自定义请求头,只要确认没有WAF/URL重写规则主动过滤该头,就能完整透传到ACI后端
  • ACI上的应用只需要从请求头读取该值,写入自身日志的结构化属性即可

全链路串联的落地实现建议
  1. 优先启用原生W3C能力,零代码改造成本
    • 检查最前端AppGW的WAF规则集,确认没有自定义拦截规则屏蔽traceparent、tracestate头,默认的微软管理规则集不会拦截这两个标准头
    • 检查APIM的全局转发策略,确认没有配置删除、清空请求头的操作,默认的forward-request策略会完整传递所有入站请求头
    • 检查后端AppGW的HTTP配置,确认没有开启额外的请求头过滤逻辑
    • ACI上的应用不需要大改,只要加少量逻辑从入站请求头提取W3C的traceid,写入日志的自定义维度即可
  2. 兜底自定义关联头配置
    • 对所有没有自带W3C上下文的老旧客户端,在前端AppGW生成自动透传的x-correlation-id头,避免因为客户端没有传标准头导致链路断连
    • 注意不要把关联头的生成逻辑放到APIM层,要放到链路最前端的节点,这样可以覆盖WAF拦截的请求场景
  3. Log Analytics查询优化
    所有节点的日志都在同一个工作区,不需要跨空间查询,可以通过统一关联字段直接做全链路聚合:
    • 关联的表包括:AppGatewayAccessLogs(两个AppGW实例可通过ResourceId字段区分)、AppGatewayWafLogs、ApiManagementGatewayLogs、ContainerInstanceLogs
    • 写KQL查询时,先从每个表的结构化请求头字段解析出统一的关联ID(traceid、correlationId),再按该ID做全节点日志排序,就能看到单个请求经过所有节点的完整处理流程
      参考查询片段:
    // 解析两个AppGW节点的日志
    let appgwLogs = AppGatewayAccessLogs
    | extend traceId = extract(@"00-([0-9a-f]{32})-", 1, tostring(parse_json(RequestHeaders).traceparent)),
        correlationId = tostring(parse_json(RequestHeaders)["x-correlation-id"]),
        nodeType = iff(ResourceId contains "waf", "前端WAF AppGW", "后端普通AppGW");
    // 解析APIM日志
    let apimLogs = ApiManagementGatewayLogs
    | extend traceId = extract(@"00-([0-9a-f]{32})-", 1, tostring(parse_json(RequestHeaders).traceparent)),
        correlationId = tostring(parse_json(RequestHeaders)["x-correlation-id"]),
        nodeType = "APIM网关";
    // 解析ACI日志
    let aciLogs = ContainerInstanceLogs
    | extend traceId = tostring(customDimensions.TraceId),
        correlationId = tostring(customDimensions.CorrelationId),
        nodeType = "ACI容器";
    // 联合所有节点日志,按关联ID、时间排序
    union appgwLogs, apimLogs, aciLogs
    | where isnotempty(traceId) or isnotempty(correlationId)
    | sort by coalesce(correlationId, traceId) asc, TimeGenerated asc
    

注意事项:不要拿各组件自己生成的x-request-id作为跨链路关联键,因为每个节点都会为同一个请求生成独立的、和上下游不关联的随机ID,无法跨节点匹配。

内容的提问来源于stack exchange,提问作者Chad Carlton

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 03:45:03