答案：本文介绍在Golang微服务中集成OpenTelemetry实现分布式追踪的方法，包括安装OTel依赖、初始化TracerProvider并配置OTLP导出器、在HTTP服务中创建Span、以及通过上下文传播实现跨服务调用追踪，最终将数据发送至Jaeger或OTLP Collector后端。
在Golang微服务架构中，分布式追踪能帮助开发者理解请求在多个服务间的流转路径，定位延迟瓶颈。OpenTelemetry（简称 OTel）是目前主流的可观测性框架，提供统一的API和SDK来收集追踪（Tracing）、指标（Metrics）和日志（Logs）。本文重点介绍如何在Golang项目中集成 OpenTelemetry 实现分布式追踪，并配置导出到后端（如 Jaeger、OTLP Collector）。
1. 安装 OpenTelemetry 依赖
使用 Go modules 管理依赖，安装 OpenTelemetry 核心包和导出器：
go get go.opentelemetry.io/otel \ go.opentelemetry.io/otel/sdk \ go.opentelemetry.io/otel/exporters/jaeger \ go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc \ go.opentelemetry.io/otel/propagation \ go.opentelemetry.io/otel/trace根据导出目标选择导出器：
-
Jaeger：使用
go.opentelemetry.io/otel/exporters/jaeger
-
OTLP（推荐）：通过 gRPC 发送到 Collector，使用
otlptracegrpc
2. 初始化 TracerProvider
TracerProvider 负责创建 Tracer 并管理采样、批处理和导出。以下是一个使用 OTLP gRPC 导出的示例：
立即学习“go语言免费学习笔记（深入）”；
package main
import ( "context" "go.opentelemetry.io/otel" "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc" "go.opentelemetry.io/otel/propagation" "go.opentelemetry.io/otel/sdk/resource" "go.opentelemetry.io/otel/sdk/trace" "go.opentelemetry.io/otel/semconv/v1.21.0" )
func initTracer() (*trace.TracerProvider, error) { // 创建 OTLP gRPC 导出器 exporter, err := otlptracegrpc.New( context.Background(), otlptracegrpc.WithInsecure(), // 若 Collector 未启用 TLS otlptracegrpc.WithEndpoint("localhost:4317"), ) if err != nil { return nil, err }
// 设置资源信息（服务名、版本等） res := resource.NewWithAttributes( semconv.SchemaURL, semconv.ServiceNameKey.String("my-go-service"), semconv.ServiceVersionKey.String("v1.0.0"), )
// 创建 TracerProvider tp := trace.NewTracerProvider( trace.WithBatcher(exporter), trace.WithResource(res), trace.WithSampler(trace.AlwaysSample()), // 可调整采样策略 )
// 设置全局 TracerProvider otel.SetTracerProvider(tp) // 设置上下文传播格式（W3C Trace Context） otel.SetTextMapPropagator(propagation.NewCompositeTextMapPropagator( propagation.TraceContext{}, propagation.Baggage{}, ))
return tp, nil }
程序退出前需关闭 TracerProvider 以确保数据刷新：
defer func() { if err := tp.Shutdown(context.Background()); err != nil { panic(err) } }()3. 在 HTTP 服务中启用追踪
以 net/http 为例，为每个请求创建 Span：
import ( "net/http" "go.opentelemetry.io/otel" )
var tracer = otel.Tracer("http-handler")
func handler(w http.ResponseWriter, r *http.Request) { ctx, span := tracer.Start(r.Context(), "handler") defer span.End()
// 模拟业务逻辑 time.Sleep(10 * time.Millisecond) w.Write([]byte("Hello, OTel!")) }
func main() { tp, err := initTracer() if err != nil { panic(err) } defer tp.Shutdown(context.Background())
http.HandleFunc("/", handler) http.ListenAndServe(":8080", nil) }
若使用 Gin、Echo 等框架，可使用社区中间件，如
github.com/uptrace/opentelemetry-go-extra/otelgin。
4. 配置传播与跨服务调用
确保请求头中的 Trace 信息在服务间正确传递。OpenTelemetry 自动处理 W3C 标准头（
traceparent、
tracestate）。
发起 HTTP 请求时注入上下文：
import "go.opentelemetry.io/otel/propagation"func callDownstream(ctx context.Context, url string) error { req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)
// 自动注入 traceparent 等头 propagator := otel.GetTextMapPropagator() propagator.Inject(ctx, propagation.HeaderCarrier(req.Header))
_, err := http.DefaultClient.Do(req) return err }
这样，调用链会在 Jaeger 或其他后端中完整展示。
基本上就这些。只要初始化好 TracerProvider，配置好导出器，并在服务入口和出口处理上下文传播，Golang 服务就能无缝接入分布式追踪体系。不复杂但容易忽略的是采样策略和资源标签的设置，建议根据环境调整。
