关联 ID 与请求追踪

为一次业务请求生成关联 ID 并全程透传(网关、服务、消息、日志),把分散日志串成调用链,是联调与故障定位的基础设施。

生成入口生成或接收上游传入,格式固定
透传HTTP 头、消息属性、线程上下文全程携带
使用日志字段与错误响应携带,支持按 ID 检索

透传示意

透传示意
HTTP:X-Correlation-ID 头,网关缺失时生成
消息:写入消息属性,消费端读取并继续传递
日志:每条日志携带该字段
响应:错误响应回传该 ID 便于报障
对外响应可回传关联 ID 便于报障;敏感场景注意不要用它暴露内部调用拓扑。

易错点

  • 异步与消息路径丢失关联 ID,链路断裂
  • 每层各自生成新 ID,无法串起完整调用

数据来源与参考

  • Google SRE Book:Tracing
  • OpenTelemetry 文档:Context Propagation
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌