使用OpenTelemetry在Golang中实现分布式追踪，需通过W3C标准传递traceparent头，结合Jaeger等后端可视化调用链，并将Trace ID注入日志系统以关联全链路日志。
在分布式系统中，服务间调用链追踪是排查问题、分析性能瓶颈的关键手段。Golang 中实现调用链追踪，核心在于传递上下文中的唯一标识（Trace ID）以及记录各阶段的耗时和元数据。以下是具体实现方式。
使用 OpenTelemetry 实现分布式追踪
OpenTelemetry 是目前主流的可观测性框架，支持跨语言、可扩展，并能与 Jaeger、Zipkin 等后端集成。
步骤如下：
- 引入依赖：go.opentelemetry.io/otel 和对应的 exporter（如 jaeger）
- 初始化全局 TracerProvider，配置采样策略和导出器
- 在每个服务入口（如 HTTP 请求）提取 Trace ID 或生成新的 trace
- 通过 Context 在 goroutine 和远程调用中传递 span 上下文
- 在关键逻辑点创建子 span，记录事件和属性
示例代码片段：
立即学习“go语言免费学习笔记（深入）”；
tracer := otel.Tracer("my-service")
ctx, span := tracer.Start(r.Context(), "handle-request")
defer span.End()
// 调用下游服务时注入上下文
req, _ := http.NewRequestWithContext(ctx, "GET", "http://service-b/api", nil)
_ = otel.GetTextMapPropagator().Inject(ctx, propagation.HeaderCarrier(req.Header))
http.DefaultClient.Do(req)
跨服务传递追踪信息
为了让多个服务串联成完整调用链，必须在请求头中传递追踪上下文。
常用标准是 W3C Trace Context，通过以下两个头部字段：
- traceparent：包含 trace-id、span-id、trace-flags
- tracestate：用于携带厂商扩展信息
HTTP 中间件应自动解析 incoming 请求的 header，恢复 span 上下文；发起 outgoing 请求时自动注入 header。
集成日志系统输出 Trace ID
将 Trace ID 输出到日志，便于在日志系统中关联同一请求的所有操作。
做法是在 context 中保存 trace-id，结合结构化日志库（如 zap 或 logrus）将其作为字段输出。
例如：
span := trace.SpanFromContext(ctx)
traceID := span.SpanContext().TraceID()
logger.Info("handling request", zap.String("trace_id", traceID.String()))
这样在 ELK 或 Loki 中搜索特定 trace_id，就能看到整个链路的日志流。
可视化展示调用链
收集的 trace 数据需要发送到后端系统进行存储和展示。
推荐方案：
- 本地测试使用 Jaeger All-in-One 启动：
docker run -d -p6831:6831/udp -p16686:16686 jaegertracing/all-in-one - 配置 OTLP Exporter 将数据发往 collector
- 通过 Jaeger UI 查看完整的调用树、各节点耗时、错误标记等
基本上就这些。关键是统一接入标准协议，确保上下文不丢失，再配合监控和日志体系形成闭环。不复杂但容易忽略细节，比如异步任务或中间件拦截。
