使用OpenTelemetry实现Golang微服务请求追踪，通过otel库初始化TracerProvider并配置导出器，结合Jaeger等后端系统；利用otelhttp包装客户端和服务端，自动注入和提取trace上下文；在日志中关联trace_id和span_id，确保链路可查；部署otel-collector统一处理数据，保障上下文传递完整，避免断链。
在Golang微服务中处理请求追踪，核心是实现分布式链路追踪，确保一次请求跨多个服务时能被完整记录和分析。关键方案是使用OpenTelemetry结合支持分布式追踪的后端系统（如Jaeger、Zipkin），通过传递上下文中的追踪信息来串联整个调用链。
使用OpenTelemetry进行自动追踪
OpenTelemetry是目前Go生态中主流的可观测性框架，支持自动注入和传播追踪上下文。
- 引入otel库：安装
go.opentelemetry.io/otel及相关组件，包括trace、propagation、sdk等。 - 初始化TracerProvider：在服务启动时配置trace导出器（如OTLP、Jaeger），并将它注册为全局provider。
- 启用上下文传播：使用
TraceContext或Baggagepropagator，确保HTTP头中的traceparent等字段被正确解析和传递。
在HTTP请求中注入追踪上下文
当微服务间通过HTTP通信时，需在客户端将当前span上下文写入请求头，在服务端从中提取并继续trace。
- 客户端：使用
otelhttp.NewClient包装http.Client，发送请求时自动注入trace信息到headers。 - 服务端：使用
otelhttp.NewHandler包装你的HTTP handler，自动从请求头恢复trace context，并创建server span。 - 自定义中间件：若不用otelhttp，可手动读取
W3C Trace Context头部（如traceparent），用propagators.Extract恢复context。
记录日志并与trace关联
为了排查问题，日志需要带上trace_id和span_id，方便在ELK或Loki中关联查询。
立即学习“go语言免费学习笔记（深入）”；
- 从context获取trace信息：
span := trace.SpanFromContext(ctx)，再提取span.SpanContext().TraceID()和SpanID()。 - 结构化日志输出：使用zap或logrus等库，在每条日志中加入
trace_id字段。 - 建议统一context封装，在请求入口处生成唯一标识并注入context，后续处理直接从中取值。
集成可视化后端（如Jaeger）
采集到的trace数据需要发送到可视化系统才能查看调用链。
- 配置OTLP Exporter：将trace数据通过gRPC发送到collector，再转发给Jaeger。
- 或直接使用Jaeger Exporter（开发环境适用）：直接上报到Jaeger agent或collector。
- 部署Collector：生产环境建议部署otel-collector，统一接收、处理并导出trace数据。
基本上就这些。只要在每个服务中正确初始化otel SDK，包装网络调用，统一日志格式，就能实现完整的请求追踪。不复杂但容易忽略细节，比如context传递中断或propagator未设置，会导致trace断链。
