Go语言怎么用Jaeger_Go语言Jaeger链路追踪教程【实用】

张开发
• 2026/4/15 23:52:22 • 15 分钟阅读

最新文章

推荐文章

相关文章

分享文章

Go语言怎么用Jaeger_Go语言Jaeger链路追踪教程【实用】
Jaeger客户端初始化报nil pointer dereference因未设置有效tracer须在main开头调用opentracing.SetGlobalTracerHTTP透传需用opentracing.HTTPHeadersCarrierTag/Log值禁用nil指针UDP连Agent失败应检查端口、Docker网络及改用TCP reporter。Jaeger客户端初始化为什么总报错 nil pointer dereference常见原因是没传入有效的 tracer或在调用 opentracing.StartSpan 前没完成初始化。Jaeger 的 Go SDK 不会自动 fallbackopentracing.GlobalTracer() 默认返回空实现直接用它开 Span 就 panic。必须显式创建并设置全局 traceropentracing.SetGlobalTracer(tracer)且这行要在任何 Span 创建之前执行推荐在 main() 开头、配置加载后立即初始化不要懒加载或放 goroutine 里如果用 jaeger.NewTracer注意第 2 个参数jaeger.Configuration.Sampler不能为 nil采样器至少得是 jaeger.NewConstSampler(true)本地调试时jaeger.NewCollector() 若连不上 Agent默认会静默失败——加 jaeger.WithLogger 才能看到连接错误怎么让 HTTP 请求自动带上 TraceID 并透传到下游服务Go 标准库不自动注入/提取 trace 上下文必须手动做。核心是用 opentracing.HTTPHeadersCarrier 在请求头中写入 uber-trace-id。发起请求前从当前 Span 获取上下文用 tracer.Inject(span.Context(), opentracing.HTTPHeaders, carrier)接收请求时用 tracer.Extract(opentracing.HTTPHeaders, carrier) 恢复 SpanContext再 StartSpanFromContext别直接读写 r.Header.Get(uber-trace-id)——要用 opentracing.HTTPHeadersCarrier 包装 map否则大小写、空格处理不一致如果下游是 Python/Java 服务确保 header key 是小写 uber-trace-idJaeger Go SDK 默认用这个不是 Uber-Trace-Id为什么 Span 看不到日志Log或 Tag或者 Tag 值是 nilJaeger Go SDK 对 Log 和 Tag 的类型很敏感Tag 值必须是基础类型string、int64、bool或实现了 String() 方法的 structLog 字段值不能是 nil 指针。写 Tag 时避免 span.SetTag(user_id, u.ID)——u.ID 是指针显示为 nil 或地址应写 span.SetTag(user_id, u.ID)Log 事件字段值不能为 nilspan.LogFields(log.String(error, err.Error())) 比 log.Object(err, err) 更稳后者在 err nil 时会崩Tag 键名别用空格或特殊字符Jaeger UI 可能解析失败推荐全小写 下划线如 http_status_codeLog 时间戳默认用 time.Now()但如果你手动传 log.Timestamp注意单位是 time.Time不是 Unix 时间戳整数Agent 连不上或 Span 全丢怎么快速定位是网络还是配置问题Jaeger Go 默认走 UDP 发给 localhost:6831但这个端口容易被防火墙、Docker 网络或 SELinux 拦住且无重试、无确认机制丢了就真丢了。 Mokker AI AI产品图添加背景

更多文章