Golang怎么接入OpenTelemetry Trace_Golang如何用OTel SDK采集分布式追踪Span数据【教程】-Golang-PHP中文网

根本原因是SDK未初始化或导出器未注册：默认NoopTracerProvider静默丢弃Span；须显式调用otel.SetTracerProvider(tp)，配置带endpoint的otlpgrpc导出器并禁用TLS（若collector未启TLS），正确透传context，合理设置ParentBased采样策略。

golang怎么接入opentelemetry trace_golang如何用otel sdk采集分布式追踪span数据【教程】

为什么 `otel.Tracer` 创建后调用 `Start()` 却没数据上报？

根本原因通常是 SDK 没初始化或导出器未注册。OpenTelemetry Go SDK 默认是“空实现”（NoopTracerProvider），不主动上报任何 Span，哪怕你写了 tracer.Start(ctx) 也只会静默丢弃。

必须显式调用 otel.SetTracerProvider(tp)，其中 tp 是带导出器的 trace.TracerProvider
导出器（如 otlpgrpc.NewClient）要提前配置好 endpoint，常见错误是写成 localhost:4317 但本地没跑 collector
别漏掉 defer tp.Shutdown(context.Background())，否则进程退出前最后一批 Span 可能丢失

用 `otlpgrpc.Exporter` 连接本地 Collector 总超时或报 `rpc error: code = Unavailable desc = connection closed`

这基本是网络或协议层没对齐。OTLP/gRPC 导出器默认走 TLS，而本地 otel-collector 默认只开非 TLS 的 4317 端口（gRPC）和 4318（HTTP/JSON），但 Go SDK 不会自动降级。

启动 collector 时加 --config=... --set=exporters.otlp.endpoint=localhost:4317，并确认它 log 里有 Starting OTLP Receiver on port 4317
Go 侧创建 exporter 时显式禁用 TLS：otlpgrpc.NewClient(otlpgrpc.WithEndpoint("localhost:4317"), otlpgrpc.WithInsecure())
如果 collector 配了 TLS（比如用自签证书），就得配 otlpgrpc.WithTLSCredentials(credentials.NewClientTLSFromCert(...))，不是简单加 WithInsecure()

`context.Context` 传错导致 Span 断链：为什么子 Span 的 parent 总是空？

Go 的 OpenTelemetry 依赖 context.Context 透传 Span，不是靠 goroutine 局部变量或全局单例。一旦 context 没带 span 或被重置，链就断了。

Golang Uber Dig

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

下载

从入口开始就要用 trace.ContextWithSpan(ctx, span) 把 span 注入 context，再传给下游函数
HTTP handler 中常用 otelhttp.NewHandler 自动注入；手动埋点时，别直接用 context.Background()，要用 handler 入参的 r.Context()
goroutine 启动新任务时，必须把带 span 的 context 传进去：go doWork(ctx)，而不是 go doWork(context.Background())
log、metrics、DB 查询等中间件若没显式接收 context，Span 就不会自动关联——得自己用 span.AddEvent() 打点，不能指望它们“自动挂上链”

采样率设太高或太低，`trace.AlwaysSample()` 和 `trace.ParentBased(trace.TraceIDRatioBased(0.1))` 有什么实际区别？

采样策略决定哪些 Span 被记录、哪些被丢弃，直接影响可观测性粒度和资源开销。误用会导致关键路径没数据，或日志爆炸。

trace.AlwaysSample() 强制所有 Span 上报，适合调试，但生产环境慎用——高 QPS 服务可能打爆 collector
trace.ParentBased(trace.TraceIDRatioBased(0.1)) 是推荐的默认策略：根 Span 按 10% 采样，子 Span 继承父级决策，保证整条链要么全有、要么全无
注意 TraceIDRatioBased 的参数是 float64，写 0.01 表示 1%，不是整数 1；写错成 1 会变成 100% 采样
如果你用的是 Istio 或其他网关注入了 traceparent header，确保你的采样器识别并尊重 tracestate 和 sampling flag，否则可能覆盖上游决策

事情说清了就结束。真正卡住人的往往不是 API 怎么写，而是 context 没传、exporter 没启、采样器没配对、collector endpoint 写错端口——这些地方一错，代码跑得再顺也没 Span 上报。