37 lines (24 loc) · 996 Bytes

联调与断链排查

常见断链场景

1. traceparent 未传播

症状: API 端的 Span 没有 parent，显示为新的 Trace Root。

检查:

浏览器网络 Tab → 请求头是否包含 traceparent
API 日志中 extractTraceContextFromIncoming 是否成功解析
CORS 配置是否允许 traceparent 头

2. TRACEPARENT 环境变量未设置

症状: 子进程中的操作没有关联到父 Trace。

检查:

injectTraceEnv() 是否被调用
子进程是否实际收到了 TRACEPARENT 环境变量

3. OTEL Exporter 连接失败

症状: Span 创建成功但无法在 Jaeger/Tempo 中查看。

检查:

Collector 是否运行: curl http://localhost:4318/v1/traces
Endpoint URL 是否正确
Exporter 日志中的错误信息

4. Context 丢失

症状: 异步操作中的 Span 没有父子关系。

检查:

是否使用了 context.with() 或 runWithContext()
Bun 的 async_hooks 是否正确追踪