首页/云/可观测性速查/W3C Trace Context:跨服务传播标准

W3C Trace Context:跨服务传播标准

traceparent 头承载 trace_id、parent span_id 与采样标志,tracestate 携带厂商额外状态;是跨语言跨厂商链路能连起来的关键标准。

可观测性速查云更新于 2026-10-12

traceparent 格式

traceparent 格式
# version-traceid-spanid-flags
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
#             |  |                                |                |
#             |  trace_id(32 hex)                span_id(16)   采样标志
tracestate: vendor=value
接收方校验格式与版本后继续传递;tracestate 保持键值对顺序,避免破坏其他厂商条目。

易错点

  • 网关或代理丢弃 traceparent 会让链路断在边界,接入时逐个组件验证透传
  • traceparent 是标准头不是业务头:不要用 x-trace-id 之类的自定义头替代

数据来源与参考

  • W3C Trace Context Recommendation
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌