Golang怎么做链路追踪_Golang链路追踪教程【深入】-Golang-PHP中文网

opentelemetry在go中必须首行注册tracerprovider和tracecontext传播器，否则span为nil、链路静默断裂；需用otelhttp.newhandler/newtransport自动透传traceparent，禁用手动header；资源属性、采样器、otlp导出配置缺一不可。

golang怎么做链路追踪_golang链路追踪教程【深入】

直接用 go.opentelemetry.io/otel，别碰 opentracing-go 或 go-opencensus——它们已归档，跨语言链路在 Istio、Jaeger v1.50+、X-Ray 里必然断裂。

TracerProvider 必须在 main() 开头注册，否则所有 span 都是 nil

Go 的 otel.Tracer() 不报错，但没初始化 sdktrace.TracerProvider 时返回的是 noop tracer，日志没 trace_id，HTTP 中间件不生效，问题静默且难排查。

必须在 main() 第一行就调用 otel.SetTracerProvider(tp) 和 otel.SetTextMapPropagator(propagation.TraceContext{})，缺一不可
别在 init() 里做：单元测试并发 init 会 panic；配置（如 SERVICE_NAME）也还没加载
别在 handler 里临时 new：多个 provider 冲突，采样逻辑错乱，span 可能被丢
资源属性必须设：resource.WithAttributes(semconv.ServiceNameKey.String("my-service"))，否则 Jaeger UI 里看不到服务名

HTTP 请求自动透传 traceparent，别手写 header

自己 req.Header.Set("traceparent", ...) 会漏 tracestate，多 vendor 场景下链路在第一个跳就断；手动 extract + StartSpan 还会导致 span 名字全是 "HTTP GET"、没状态码、没 peer.ip。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

入向：用 otelhttp.NewHandler(http.HandlerFunc(handler), "api") 包裹 handler，它自动 extract、创建 span、注入 context、记录 status/path/method、精准结束时机
Gin/Echo 不支持直接传 http.Handler，得用适配中间件（如 ginotel.Middleware），且必须显式传 propagation.TraceContext{}
出向：必须用 otelhttp.NewTransport(http.DefaultTransport) 替换 client transport，http.DefaultClient 是链路断裂元凶
健康检查路径（如 /healthz）建议用 otelhttp.WithFilter() 过滤，避免污染 trace 数据

数据库 span 断裂或 duration 不准，光 wrap sql.DB 不够

只用 otelsql.Open() 或 otelsql.WrapDriver() 覆盖不了 sql.Tx 内部的 Stmt.Exec、预编译语句、Rows.Scan 等底层调用，span 断裂或耗时统计失真。

正确做法：用 otelsql.RegisterDriver() 注册带 tracing 的 driver，让连接层所有操作都被拦截
PostgreSQL 推荐 github.com/jackc/pgx/v5/pg 驱动，MySQL 推荐官方 github.com/go-sql-driver/mysql（需确认版本兼容 otelsql）
高基数字段（如 user_id、request_id）禁作 span attribute，会撑爆后端存储
异步 goroutine 必须显式传入上游 ctx，不能用 context.Background()，否则生成 root span，父子关系丢失

OTLP 导出失败不报错，本地开发优先用 stdout

OTLP exporter 默认超时短（5s）、失败静默，连不上 collector 就丢 trace，不 panic 也不 log，非常难定位。

本地开发先用 stdouttrace.NewExporter()，一眼看到 span 输出，排除 SDK 初始化问题
生产用 otlphttp.NewExporter 或 otlpgrpc.NewExporter，配合 OpenTelemetry Collector
检查 collector 地址：HTTP 是 http://localhost:4318，gRPC 是 localhost:4317；用 curl -v http://localhost:4318/v1/traces 测试是否响应
采样器别留 sdktrace.AlwaysSample() 上线：QPS 一高，exporter 积压、重试风暴、拖垮 CPU 和网络；改用 sdktrace.ParentBased(sdktrace.TraceIDRatioBased(0.01))