链路追踪通过统一上下文传递、生成唯一追踪ID、记录Span并上报数据，帮助定位微服务性能瓶颈。使用OpenTelemetry可标准化实现Golang链路追踪，结合Jaeger可视化调用链。1. 安装otel相关依赖；2. 初始化TracerProvider并配置Jaeger上报；3. 使用otelhttp中间件自动注入和传播追踪上下文；4. 在HTTP处理器中包装路由或手动创建Span；5. 客户端请求时通过HeaderCarrier透传上下文，服务端自动解析traceparent头；6. 启动Jaeger容器查看拓扑与调用详情。关键在于确保跨服务Context正确传递，尤其注意异步任务中的上下文携带与Header透传。
微服务架构下，一次请求可能经过多个服务节点，排查问题和性能瓶颈变得困难。链路追踪能帮助开发者清晰看到请求在各服务间的流转路径。Golang中实现链路追踪，核心是统一上下文传递、生成唯一追踪ID、记录跨度（Span）信息，并将数据上报到追踪系统。
使用OpenTelemetry实现链路追踪
OpenTelemetry是目前主流的可观测性框架，支持分布式追踪、指标和日志。它提供了一套标准API，可与多种后端（如Jaeger、Zipkin）集成。
1. 安装依赖
go get go.opentelemetry.io/otelgo get go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
go get go.opentelemetry.io/otel/exporters/jaeger
2. 初始化TracerProvider
立即学习“go语言免费学习笔记（深入）”；
在程序启动时配置Exporter和TracerProvider：
func initTracer() error {exporter, err := jaeger.New(jaeger.WithAgentEndpoint(
jaeger.WithAgentHost("localhost"),
jaeger.WithAgentPort("6831"),
))
if err != nil {
return err
}
tp := sdktrace.NewTracerProvider(
sdktrace.WithBatcher(exporter),
sdktrace.WithResource(resource.NewWithAttributes(
semconv.SchemaURL,
semconv.ServiceNameKey.String("my-service"),
)),
)
otel.SetTracerProvider(tp)
otel.SetTextMapPropagator(propagation.NewCompositeTextMapPropagator(propagation.TraceContext{}, propagation.Baggage{}))
return nil
}
在HTTP服务中注入追踪上下文
使用otelhttp中间件自动为HTTP请求创建Span，并处理上下文传播。
1. 包装HTTP处理器
http.HandleFunc("/api", otelhttp.WithRouteTag("/api", yourHandler))handler := otelhttp.NewHandler(http.DefaultServeMux, "api-server")
http.ListenAndServe(":8080", handler)
2. 手动创建Span（可选）
在关键业务逻辑中添加自定义Span：
ctx, span := tracer.Start(ctx, "processOrder")defer span.End()
span.AddEvent("order validated")
跨服务传递追踪上下文
当服务调用另一个服务时，必须将Trace ID和Span ID通过HTTP头传递。
1. 客户端发送请求时注入上下文
req, _ := http.NewRequest("GET", "http://service-b/api", nil)ctx := context.Background()
otel.GetTextMapPropagator().Inject(ctx, propagation.HeaderCarrier(req.Header))
http.DefaultClient.Do(req)
2. 服务端自动提取上下文
使用otelhttp中间件后，传入的请求头（如traceparent）会被自动解析，构建正确的调用链。
查看追踪数据（集成Jaeger）
启动Jaeger All-in-One用于本地调试：
docker run -d --name jaeger \-e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
-p 6831:6831/udp \
-p 16686:16686 \
jaegertracing/all-in-one:latest
访问 https://www.php.cn/link/13941bddb1399810f387f38dc7c775f0 查看服务拓扑和调用链详情。
基本上就这些。OpenTelemetry提供了标准化方式来实现Golang微服务的链路追踪，结合Jaeger等可视化工具，能快速定位延迟高、失败多的调用路径。关键是确保上下文在服务间正确传递，并合理命名Span以便分析。不复杂但容易忽略的是Header的透传和异步任务中的Context携带。
