不能完全绕过go代码埋点，operator仅自动注入环境变量和collector地址，go仍需显式调用otel.tracer()等api创建span；错误注解会导致jaeger无数据。
OpenTelemetry Operator自动注入是否真能绕过Go代码埋点？
不能完全绕过，但可以大幅减少手动埋点。Operator注入的Java Agent或Python instrumentation在Go里不生效——Go没有类似JVM的agent机制，otel-go SDK必须显式初始化和使用。
常见错误现象是：Pod打了instrumentation.opentelemetry.io/inject: "go"注解，日志里也看到agent启动了，但Jaeger里始终没Span。这是因为Go runtime不会自动加载外部instrumentation包，它不支持字节码插桩。
- Go服务必须调用
otel.Tracer()、tracer.Start()等API创建Span，否则无数据可上报 - Operator对Go的作用仅限于自动挂载
OTEL_EXPORTER_OTLP_ENDPOINT等环境变量，以及把Collector地址透传进容器 - 若用
go run本地调试，Operator不生效，必须走Kubernetes Pod生命周期才能触发环境变量注入
Go中sdktrace.NewTracerProvider的关键参数怎么选？
参数选错会导致Span丢失、采样率失控或内存暴涨。最常被忽略的是WithSampler和WithBatcher的组合逻辑。
默认ParentBased(AlwaysSample())看似安全，但实际会让所有子Span都继承父Span的采样决策——如果上游服务没传traceparent头，整个链路就全丢；而AlwaysSample()在高并发下会压垮Collector。
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
- 生产环境推荐
sdktrace.ParentBased(sdktrace.TraceIDRatioBased(0.1))：既尊重上游决策，又对无上下文请求按10%采样 -
WithBatcher必须配otlptracegrpc.New导出器，不能用stdouttrace.New——后者只打印到控制台，Pod重启后日志即消失 - 避免在
main()里反复调用NewTracerProvider，它应全局唯一；多次调用会导致goroutine泄漏和内存持续增长
HTTP中间件里如何安全传递context.Context做跨Span追踪？
Go的http.Handler天然不携带context.Context，手动塞进去容易漏传或覆盖，导致Span Context断链。典型错误是直接用context.Background()创建新Span，而非从http.Request.Context()派生。
关键点在于：HTTP头里的traceparent必须由otelhttp.NewHandler自动解析并注入到Request.Context()，而不是靠开发者自己req.Header.Get("traceparent")再手动解析。
- 必须用
otelhttp.NewHandler(yourHandler, "route-name")包装原始handler，这是OpenTelemetry官方推荐的HTTP传播方式 - 自定义中间件（如JWT鉴权）需确保调用
next.ServeHTTP(w, req.WithContext(ctx))，其中ctx来自req.Context()，不能新建 - 若用
gorilla/mux或chi等路由库，注意其Middleware函数签名是否透传http.Handler——有些老版本会截断Context
上报失败时，otel-collector日志里出现rpc error: code = Unavailable desc = connection refused怎么办？
这通常不是网络策略问题，而是Go客户端与Collector之间的gRPC协议版本或TLS配置不匹配。尤其在启用了mTLS的集群里，错误信息却显示“connection refused”，容易误判为端口不通。
真实原因可能是：Go SDK默认启用gRPC的WithInsecure()，而Collector监听的是https://端点；或者Collector配置了tls: {enabled: true}但没提供证书路径，导致gRPC握手失败后底层直接关闭连接。
- 先确认Collector的
otlp/receiver配置：若endpoint: 0.0.0.0:4317且无tls块，则Go端必须用otlptracegrpc.New(context.Background(), otlptracegrpc.WithInsecure()) - 若Collector启用了TLS，Go端要改用
otlptracegrpc.New(context.Background(), otlptracegrpc.WithTLSCredentials(credentials.NewClientTLSFromCert(nil, "")))，并确保证书挂载进Pod - 检查Collector日志里是否有
failed to start receiver或server: TLS handshake error，比客户端报错更早暴露根因
span.End()不能放在goroutine里异步调用，也不能依赖defer在函数退出时执行——因为handler函数可能早已返回，而goroutine还在跑，此时span.End()会写入已销毁的Span Context，导致数据损坏或panic。必须确保span.End()在ServeHTTP返回前同步执行。
