Go微服务分布式追踪推荐用OpenTelemetry SDK，需初始化全局TracerProvider并配置Exporter与采样策略，通过HTTP中间件和gRPC拦截器自动传播上下文，并支持自定义Span记录业务细节。

在 Go 微服务架构中，实现请求调用链追踪（Distributed Tracing）核心是统一传播 Trace ID 和 Span ID，并将各服务的调用片段（span）上报到集中式追踪后端（如 Jaeger、Zipkin 或 OpenTelemetry Collector）。Go 生态推荐使用 OpenTelemetry Go SDK，它已成事实标准，替代了旧的 OpenTracing + OpenCensus 双轨方案。

1. 初始化全局 Tracer 并配置 Exporter

启动时创建并设置全局 TracerProvider，指定 exporter（如 Jaeger、OTLP）和采样策略。建议生产环境使用概率采样（如 1%），避免性能与存储压力。

• 安装依赖：go get go.opentelemetry.io/otel、go.opentelemetry.io/otel/exporters/jaeger（或 otlp）
• 初始化 Jaeger exporter 示例：

  // 创建 exporter
  exp, err := jaeger.New(jaeger.WithAgentEndpoint(jaeger.WithAgentHost("localhost"), jaeger.WithAgentPort(6831)))
  if err != nil { panic(err) }
  // 构建 TracerProvider，启用批量上传和上下文传播
  tp := sdktrace.NewTracerProvider(
    sdktrace.WithBatcher(exp),
    sdktrace.WithSampler(sdktrace.AlwaysSample), // 开发期用，生产换为 sdktrace.TraceIDRatioBased(0.01)
  )
  otel.SetTracerProvider(tp)
  otel.SetTextMapPropagator(propagation.NewCompositeTextMapPropagator(propagation.TraceContext{}, propagation.Baggage{}))

2. HTTP 中间件自动注入/提取 Trace 上下文

所有入站 HTTP 请求需从 header（如 traceparent）中提取 span 上下文；出站请求需将当前 span 的 context 注入 header。用中间件统一处理，避免每个 handler 手动操作。

• 入站：使用 otelhttp.NewHandler 包裹 handler，自动提取、创建 server span
• 出站：使用 otelhttp.NewClient 包裹 http.Client，自动注入 traceparent header

  // 入站示例
  http.Handle("/api/order", otelhttp.NewHandler(http.HandlerFunc(orderHandler), "POST /api/order"))
  // 出站示例
  client := otelhttp.NewClient(http.DefaultClient)
  resp, _ := client.Get("http://user-svc/users/123")

3. gRPC 服务集成追踪

gRPC 使用拦截器（interceptor）实现类似逻辑。OpenTelemetry 提供了开箱即用的拦截器：

• 服务端：用 otelgrpc.UnaryServerInterceptor 拦截请求，生成 server span
• 客户端：用 otelgrpc.UnaryClientInterceptor 拦截调用，注入 context

  // gRPC Server 启动时
  server := grpc.NewServer(
    grpc.UnaryInterceptor(otelgrpc.UnaryServerInterceptor()),
  )
  // gRPC Client 连接时
  conn, _ := grpc.Dial("user-svc:50051",
    grpc.WithUnaryInterceptor(otelgrpc.UnaryClientInterceptor()),
  )

4. 自定义 Span 记录业务逻辑细节

在关键路径（如 DB 查询、外部 API 调用、耗时计算）中手动创建子 span，添加属性（attribute）、事件（event）和错误标注，提升可分析性。

• 用 tracer.Start(ctx, "db.query") 创建新 span，返回带 context 的新 ctx
• 用 span.SetAttributes(attribute.String("sql", query)) 记录元数据
• 发生错误时调用 span.RecordError(err) 并设 span.SetStatus(codes.Error, err.Error())

  ctx, span := tracer.Start(r.Context(), "process-order")
  defer span.End()
  span.SetAttributes(
    attribute.String("order.id", orderID),
    attribute.Int("item.count", len(items)),
  )
  if err := chargePayment(ctx, orderID); err != nil {
    span.RecordError(err)
    span.SetStatus(codes.Error, "payment failed")
    return
  }