首页/云/可观测性速查/Trace ID 与 Span ID 的格式

Trace ID 与 Span ID 的格式

标识规范固定:trace_id 为 16 字节(32 位十六进制),span_id 为 8 字节(16 位十六进制);全链路靠 trace_id 关联,span_id 定位具体节点。

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

格式示例

格式示例
trace_id   4bf92f3577b34da6a3ce929d0e0e4736   # 32 hex
span_id    00f067aa0ba902b7                   # 16 hex

子 span 记录 parent_span_id 指向父节点;
跨服务传播时 trace_id 保持不变,span_id 每跳新生成。
日志里打印 trace_id 是实现“链路与日志互跳”的前提,格式按十六进制小写对齐。

易错点

  • 各组件对 ID 大小写的处理不同,统一小写避免字符串比较失配
  • 生成非随机的 trace_id(如时间戳拼接)会碰撞,用规范随机生成器

数据来源与参考

  • W3C Trace Context 规范
  • OpenTelemetry 官方文档 · Trace IDs
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌