如何配置Golang的可视化调用链路环境 Go语言Jaeger环境快速部署

Jaeger Agent 启动失败：端口被占或协议不匹配

本地跑 jaeger-agent 时常见报错 address already in use 或根本收不到 span，大概率是 udp 端口 6831（Thrift Compact）没通，或者客户端发的是 6832（Thrift Binary）但 agent 没开对应监听。

• 默认只监听 6831，go 客户端用 jaeger-client-go 时默认也走这个端口，不用改
• 如果用 docker run jaegertracing/jaeger-agent，记得加 -p 6831:6831/udp，TCP 端口（如 14271）是 health check 用的，不是传 span 的
• Mac 上 Docker Desktop 的 UDP 转发偶尔抽风，可改用 --network=host 启动 agent，让 Go 进程直连 localhost:6831
• 验证是否收到数据：tcpdump -i lo0 -n udp port 6831 | head -10（Mac），有输出说明链路通了

Go 应用接入 Jaeger：client 初始化别漏了 reporter 和 sampler

只调 cfg.NewTracer() 不会自动上报，必须显式配置 reporter 指向 agent 地址，否则 tracer 创建成功但所有 span 都静默丢弃。

• reporter 必须设 localAgentHostPort，比如 "localhost:6831"；不填或填错 host 会导致连接超时，日志里几乎不报错，只能看 tracer.IsStarted() 是否为 false
• 开发环境建议用 ConstSampler（param: 1 表示全采），避免默认的 ProbabilisticSampler 把你的调试请求随机过滤掉
• 别在 http handler 里反复 new tracer，全局复用一个 opentracing.Tracer 实例即可
• 示例关键行：

  cfg := &config.Configuration{ServiceName: "my-service"}<br>cfg.Reporter.LocalAgentHostPort = "localhost:6831"<br>cfg.Sampler.Type = "const"<br>cfg.Sampler.Param = 1<br>tracer, _ := cfg.NewTracer(config.Logger(jaeger.StdLogger))

Span 上下文传递断开：HTTP 请求里没注入/提取 baggage

微服务间调用时 span parent ID 丢失，链路变成多个孤立节点，问题基本出在 HTTP header 的 inject/extract 流程没串起来。

• 用 http.RoundTripper 做出站请求时，必须手动调 tracer.Inject(span.Context(), opentracing.HTTPHeaders, opentracing.HTTPHeadersCarrier(req.Header))
• 服务端收到请求后，得用 tracer.Extract(opentracing.HTTPHeaders, opentracing.HTTPHeadersCarrier(r.Header)) 拿 context，再 StartSpanFromContext
• 别依赖中间件自动做——jaeger-client-go 不提供开箱即用的 HTTP middleware，得自己 wrap 或用社区轻量封装（如 jaeger-http 包）
• 检查 header 名：Jaeger 默认用 uber-trace-id，不是 traceparent（W3C 标准），混用会断链

Docker Compose 部署 Jaeger ui：query 服务连不上 cassandra/es 时先关掉存储

本地快速验证不需要持久化，硬配 Cassandra 或 elasticsearch 反而卡住启动，jaeger-query 日志刷满 connection refused 却不报具体哪个服务挂了。

立即学习“go语言免费学习笔记（深入）”；

• 直接用 all-in-one 镜像最省事：docker run -d -p 16686:16686 -p 6831:6831/udp jaegertracing/all-in-one:1.45
• 若必须用 compose，把 query 的 STORAGE=memory 环境变量加上，并删掉对 cassandra 或 elasticsearch 的 depends_on 和 links
• UI 访问地址永远是 http://localhost:16686，别试 :14268（这是 collector 接收 endpoint）
• all-in-one 模式下 span 仅内存存储，重启容器就清空，适合调试，不适合压测或跨天观察

Jaeger 的“可视化”其实只是 query 服务把存储里的 span 渲染成前端图表，真正难的是让每个 span 的 traceID、parentID、timestamp 在进程间准确透传——这三样只要有一样没对齐，UI 上就只能看到碎片。