尧图网站建设 
OpenTelemetry Go Jaeger Exporter 实战在 BuildKit 中的配置、原理与迁移指南【免费下载链接】buildkitconcurrent, cache-efficient, and Dockerfile-agnostic builder toolkit项目地址: https://gitcode.com/GitHub_Trending/bu/buildkitBuildKit 的 vendored 依赖中携带了go.opentelemetry.io/otel/exporters/jaeger这一 OpenTelemetry Go 官方 Jaeger 追踪导出器见 README.mdBuildKit 自身的分布式追踪体系也基于它提供了兼容旧版JAEGER_TRACE环境的 Jaeger 导出能力。本文以该导出器为核心完整讲解其安装方式、两种上报链路Agent UDP / Collector HTTP、环境变量配置表并结合 jaeger.go、agent.go、uploader.go 等源码剖析其底层实现最后给出官方推荐的 OTLP 迁移路径与 BuildKit 中的实际接入方式。重要前提该导出器已进入弃用状态阅读本文前必须先了解一个关键事实这个模块已不再受支持。根据其包注释 doc.go 与 README 中的醒目说明OpenTelemetry 已于2023 年 7 月正式放弃对 Jaeger exporter 的支持Jaeger 官方已接受并推荐使用OTLP作为采集协议官方建议新项目直接改用 OTLP 系列导出器即go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp或go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc。因此本文对它的讲解定位是理解遗留代码、维护存量系统、掌握迁移依据。对于仍在维护的 BuildKit 等仓库它被保留在 vendor 中主要是出于向后兼容考虑BuildKit 侧注释明确写着Jaeger still supported for compatibility。安装与基本用法按 README 说明安装命令为go get -u go.opentelemetry.io/otel/exporters/jaeger注意README 中指向的示例目录example/jaeger属于上游 OpenTelemetry-Go 仓库当前 BuildKit 的 vendor 目录中并未携带该示例若想在真实项目中观察该导出器的接入效果可直接参考 BuildKit 自己的集成代码 util/tracing/detect/jaeger/jaeger.go详见下文BuildKit 中的接入一节。该导出器实现了sdktrace.SpanExporter接口见 jaeger.go 的编译期断言可无缝挂载到 OpenTelemetry SDK 的TracerProvider上。其核心入口是New(endpointOption EndpointOption) (*Exporter, error)唯一的参数是一个EndpointOption用来决定流量走 Agent 还是走 Collector。两种上报链路AgentUDP与 CollectorHTTPREADME 明确指出导出器支持两种发送目标对应两个不同的构造选项发送目标传输方式协议对应选项Jaeger agentUDP 数据报jaeger.thrift Compact Thrift 协议WithAgentEndpointJaeger collectorHTTP POSTjaeger.thriftHTTP 封装WithCollectorEndpoint链路一WithAgentEndpoint— 发给本机/就近的 Jaeger AgentAgent 模式适合应用与 Jaeger Agent 同机部署的经典 sidecar 拓扑。数据通过UDP发送Agent 再把数据转发给 Collector最终入库 Jaeger 后端。从 uploader.go 的源码可以看到该选项的默认行为默认主机从环境变量OTEL_EXPORTER_JAEGER_AGENT_HOST读取缺省为localhost默认端口从环境变量OTEL_EXPORTER_JAEGER_AGENT_PORT读取缺省为6831默认开启 UDP 自动重连AttemptReconnecting: true。Agent 模式下还提供了一批细粒度选项全部实现在 agent.go 与 uploader.go 中选项作用默认值/说明WithAgentHost(host)覆盖 agent 主机覆盖OTEL_EXPORTER_JAEGER_AGENT_HOST缺省localhostWithAgentPort(port)覆盖 agent 端口覆盖OTEL_EXPORTER_JAEGER_AGENT_PORT缺省6831WithMaxPacketSize(size)单 UDP 包上限上限 65000 字节见下方源码解析WithDisableAttemptReconnecting()关闭自动重连默认开启重连WithAttemptReconnectingInterval(interval)重连解析间隔未设置时默认 30 秒WithLogger(logger)/WithLogr(logger)设置日志器两者互相覆盖链路二WithCollectorEndpoint— 直连 Jaeger CollectorHTTPCollector 模式把追踪数据直接 POST 给 Jaeger Collector 的 HTTP 接口适合应用与 Jaeger 后端不在同一主机或希望绕过 Agent 直连采集端的场景。从 uploader.go 的默认配置可见端点从环境变量OTEL_EXPORTER_JAEGER_ENDPOINT读取缺省为http://localhost:14268/api/traces用户名/密码分别来自OTEL_EXPORTER_JAEGER_USER与OTEL_EXPORTER_JAEGER_PASSWORD没有默认值两者都为空时不设置认证头使用http.DefaultClient作为默认 HTTP 客户端。该模式下的选项见 uploader.go选项作用WithEndpoint(endpoint)设置 Collector 完整 URL覆盖OTEL_EXPORTER_JAEGER_ENDPOINTWithUsername(username)设置 Basic 认证用户名覆盖OTEL_EXPORTER_JAEGER_USERWithPassword(password)设置 Basic 认证密码覆盖OTEL_EXPORTER_JAEGER_PASSWORDWithHTTPClient(client)自定义*http.Client可用于超时、TLS、代理等定制Collector 上传的实现细节非常明确见 uploader.go序列化采用 ThriftBinary Protocol请求方法为POSTContent-Type设为application/x-thrift仅当用户名与密码同时非空时才调用SetBasicAuth响应状态码不在 2xx 范围即返回错误failed to upload traces; HTTP status code: %d。环境变量配置一键切换选项优先README 提供了官方的环境变量对照表这是运维侧最常用的配置入口完整继承如下环境变量对应选项默认值OTEL_EXPORTER_JAEGER_AGENT_HOSTWithAgentHostlocalhostOTEL_EXPORTER_JAEGER_AGENT_PORTWithAgentPort6831OTEL_EXPORTER_JAEGER_ENDPOINTWithEndpointhttp://localhost:14268/api/tracesOTEL_EXPORTER_JAEGER_USERWithUsername无OTEL_EXPORTER_JAEGER_PASSWORDWithPassword无这些变量名都定义在 env.go 中并通过envOr(key, defaultValue)工具函数读取变量存在且非空时取变量值否则取默认值见 env.go。优先级规则README 明确声明显式传入的选项 环境变量 内置默认值。这一点在 uploader.go 中体现得很直观WithAgentEndpoint/WithCollectorEndpoint先以环境变量初始化配置再逐个应用用户传入的 option 覆盖。源码级解析OTel Span 是如何变成 Jaeger Thrift 的理解了配置层之后值得深入 jaeger.go 看一遍数据转换与导出的完整流水线这对排查追踪为什么没查到很有帮助。1. 导出入口与批处理ExportSpansExportSpansjaeger.go是导出器实现sdktrace.SpanExporter的核心方法流程如下快速检查ctx是否已取消、导出器是否已Shutdown命中则直接返回通过jaegerBatchList(spans, e.defaultServiceName)把一批 OTel Span 按Resource 分组成若干个 JaegerBatch对每个 Batch 调用上传器的upload(ctx, batch)发送任一 Batch 发送失败即返回错误。Shutdownjaeger.go通过sync.Once关闭stopCh随后让上传器释放连接资源。2. 分组与 Service 识别jaegerBatchList / processjaegerBatchListjaeger.go用map[attribute.Distinct]*gen.Batch把同 Resource 的 Span 归入同一 Batch保证每个 Batch 携带一份独立的Process即 Jaeger 中的服务进程描述。processjaeger.go负责把 OTelResource映射为 JaegerProcess遍历 Resource 属性时service.name被提取为Process.ServiceName而不转成 Tag其余属性全部转为Process.Tags。若 Span 的 Resource 中没有service.name则回退使用默认 Resource 中的服务名——这也就是New()在构造时会从resource.Default()读取service.name的原因jaeger.go取不到时会直接报错failed to get service name from default resource。3. 字段映射spanToThriftspanToThriftjaeger.go完成单条 Span 的字段级转换值得留意的映射规则包括TraceID / SpanID / ParentSpanID按 BigEndian 拆分为TraceIdHigh/TraceIdLow两个 int64 与单个 int64 的 SpanID时间单位换算StartTime用UnixNano() / 1000转成微秒Duration用纳秒差值再除以 1000Span Kind非SpanKindInternal的 Kind 写为字符串 Tagspan.kind状态码codes.Ok映射为otel.status_codeOKcodes.Error额外追加布尔 Tagerrortrue与otel.status_codeERROR描述写入otel.status_descriptionInstrumentationScope追加otel.library.name与otel.library.version两个 Tag事件Events转为 JaegerLog时间戳换算为微秒事件名写入名为event的字段被丢弃的属性数写入otel.event.dropped_attributes_countLinks全部映射为FOLLOWS_FROM类型的 SpanRef。keyValueToTagjaeger.go负责 OTelattribute.KeyValue到 ThriftTag的类型转换字符串→TagType_STRING、布尔→TagType_BOOL、int64→TagType_LONG、float64→TagType_DOUBLE而四种切片类型BOOL/INT64/FLOAT64/STRING 切片统一通过 JSON 序列化后以字符串 Tag 承载。4. Agent UDP 的报文组装agent.goAgent 链路的传输细节在 agent.go 中这是理解UDP 模式为什么偶尔丢数据的关键报文上限udpPacketMaxLength 65000字节另有emitBatchOverhead 70字节的封包开销实际可用净荷为 65000 - 70协议使用 ThriftCompact ProtocolTCompactProtocolTMemoryBuffer协议工厂配置可见 agent.go拆包逻辑EmitBatchagent.go先序列化Process得到其大小再逐个累计 Span 大小单个 Span 超限则直接丢弃并记录错误累计超限则先把已有 Spanflush成一个 UDP 报文再继续下一包写失败检查flush后会检查thriftBuffer.Len() maxPacketSize超限时报data does not fit within one UDP packet。5. UDP 自动重连机制reconnecting_udp_client.goAgent 模式默认开启的重连由 reconnecting_udp_client.go 实现后台 goroutine 每resolveTimeout默认 30 秒重新解析一次主机地址若解析出的地址与当前连接不同则新建 UDP 连接并替换旧连接Write失败时也会先尝试重解析重拨成功则重试写入。这保证了 agent 地址如 DNS 记录发生变化时导出器仍能自动恢复。BuildKit 中的接入兼容旧版 JAEGER_TRACE 的自动探测除了 vendor 中提供该导出器BuildKit 还在 util/tracing/detect/jaeger/jaeger.go 中实现了针对 Jaeger 的自动探测注册这是该导出器在 BuildKit 中最直接的实战用法自动启用条件jaeger.go满足以下任一条件即启用 Jaeger 导出器——OTEL_TRACES_EXPORTERjaeger存在旧版兼容变量JAEGER_TRACE设置了OTEL_EXPORTER_JAEGER_AGENT_HOST或OTEL_EXPORTER_JAEGER_ENDPOINT。旧版变量兼容JAEGER_TRACE是 OpenTelemetry 规范之外、BuildKit 为向后兼容保留的变量。其值若以http:///https://开头则视为 Collector 端点否则按host:port解析为 Agent 地址jaeger.go。BuildKit 侧附加变量BuildKit 额外支持OTEL_EXPORTER_JAEGER_HOST默认localhost与OTEL_EXPORTER_JAEGER_PORT默认6831端点默认值为http://localhost:14250jaeger.go。注意这三个默认值是该集成代码自身定义的与导出器包内默认值并不完全一致配置时需留意。线程安全包装社区曾反馈该 Jaeger 导出器并非线程安全BuildKit 因此用sync.Mutex将其包裹为threadSafeExporterWrapper对ExportSpans做互斥保护jaeger.go。因此在 BuildKit 上启用 Jaeger 追踪最省事的办法就是设置环境变量例如 Agent 模式OTEL_TRACES_EXPORTERjaeger JAEGER_TRACEjaeger-agent:6831或直连 CollectorOTEL_EXPORTER_JAEGER_ENDPOINThttp://jaeger-collector:14268/api/traces迁移建议从 Jaeger 导出器走向 OTLP鉴于官方已弃用该导出器任何新代码都不应再引入exporters/jaeger依赖存量系统迁移时应替换为官方推荐的 OTLP 导出器otlptracehttpgo.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp适用于 HTTP/Protobuf 链路otlptracegrpcgo.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc适用于 gRPC 链路。现代 Jaeger 后端已原生支持 OTLP 接入Jaeger 官方将 OTLP 作为推荐协议迁移后既能解除对已被放弃模块的依赖又能获得 OpenTelemetry 生态的持续维护。BuildKit 自身的追踪体系也已演进为基于 OTLP 的自动探测见 util/tracing 目录下的其他检测器实现与 Jaeger 导出器共存但定位不同——Jaeger 相关代码仅承担兼容旧环境的职责。小结本文基于 README.md 完整呈现了 OpenTelemetry Go Jaeger 导出器的安装、双链路配置、环境变量表与弃用声明并通过 jaeger.go、agent.go、uploader.go、env.go 与 reconnecting_udp_client.go 还原了从 OTel Span 到 Jaeger Thrift 数据包的完整转换链路。对于在 BuildKit 及其衍生系统中维护存量追踪能力的工程师可参照 util/tracing/detect/jaeger/jaeger.go 的兼容接入方式对于新建项目请务必遵循官方建议直接采用 OTLP 导出器。【免费下载链接】buildkitconcurrent, cache-efficient, and Dockerfile-agnostic builder toolkit项目地址: https://gitcode.com/GitHub_Trending/bu/buildkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenTelemetry Go Jaeger Exporter 实战：在 BuildKit 中的配置、原理与迁移指南
OpenTelemetry Go Jaeger Exporter 实战在 BuildKit 中的配置、原理与迁移指南【免费下载链接】buildkitconcurrent, cache-efficient, and Dockerfile-agnostic builder toolkit项目地址: https://gitcode.com/GitHub_Trending/bu/buildkitBuildKit 的 vendored 依赖中携带了go.opentelemetry.io/otel/exporters/jaeger这一 OpenTelemetry Go 官方 Jaeger 追踪导出器见 README.mdBuildKit 自身的分布式追踪体系也基于它提供了兼容旧版JAEGER_TRACE环境的 Jaeger 导出能力。本文以该导出器为核心完整讲解其安装方式、两种上报链路Agent UDP / Collector HTTP、环境变量配置表并结合 jaeger.go、agent.go、uploader.go 等源码剖析其底层实现最后给出官方推荐的 OTLP 迁移路径与 BuildKit 中的实际接入方式。重要前提该导出器已进入弃用状态阅读本文前必须先了解一个关键事实这个模块已不再受支持。根据其包注释 doc.go 与 README 中的醒目说明OpenTelemetry 已于2023 年 7 月正式放弃对 Jaeger exporter 的支持Jaeger 官方已接受并推荐使用OTLP作为采集协议官方建议新项目直接改用 OTLP 系列导出器即go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp或go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc。因此本文对它的讲解定位是理解遗留代码、维护存量系统、掌握迁移依据。对于仍在维护的 BuildKit 等仓库它被保留在 vendor 中主要是出于向后兼容考虑BuildKit 侧注释明确写着Jaeger still supported for compatibility。安装与基本用法按 README 说明安装命令为go get -u go.opentelemetry.io/otel/exporters/jaeger注意README 中指向的示例目录example/jaeger属于上游 OpenTelemetry-Go 仓库当前 BuildKit 的 vendor 目录中并未携带该示例若想在真实项目中观察该导出器的接入效果可直接参考 BuildKit 自己的集成代码 util/tracing/detect/jaeger/jaeger.go详见下文BuildKit 中的接入一节。该导出器实现了sdktrace.SpanExporter接口见 jaeger.go 的编译期断言可无缝挂载到 OpenTelemetry SDK 的TracerProvider上。其核心入口是New(endpointOption EndpointOption) (*Exporter, error)唯一的参数是一个EndpointOption用来决定流量走 Agent 还是走 Collector。两种上报链路AgentUDP与 CollectorHTTPREADME 明确指出导出器支持两种发送目标对应两个不同的构造选项发送目标传输方式协议对应选项Jaeger agentUDP 数据报jaeger.thrift Compact Thrift 协议WithAgentEndpointJaeger collectorHTTP POSTjaeger.thriftHTTP 封装WithCollectorEndpoint链路一WithAgentEndpoint— 发给本机/就近的 Jaeger AgentAgent 模式适合应用与 Jaeger Agent 同机部署的经典 sidecar 拓扑。数据通过UDP发送Agent 再把数据转发给 Collector最终入库 Jaeger 后端。从 uploader.go 的源码可以看到该选项的默认行为默认主机从环境变量OTEL_EXPORTER_JAEGER_AGENT_HOST读取缺省为localhost默认端口从环境变量OTEL_EXPORTER_JAEGER_AGENT_PORT读取缺省为6831默认开启 UDP 自动重连AttemptReconnecting: true。Agent 模式下还提供了一批细粒度选项全部实现在 agent.go 与 uploader.go 中选项作用默认值/说明WithAgentHost(host)覆盖 agent 主机覆盖OTEL_EXPORTER_JAEGER_AGENT_HOST缺省localhostWithAgentPort(port)覆盖 agent 端口覆盖OTEL_EXPORTER_JAEGER_AGENT_PORT缺省6831WithMaxPacketSize(size)单 UDP 包上限上限 65000 字节见下方源码解析WithDisableAttemptReconnecting()关闭自动重连默认开启重连WithAttemptReconnectingInterval(interval)重连解析间隔未设置时默认 30 秒WithLogger(logger)/WithLogr(logger)设置日志器两者互相覆盖链路二WithCollectorEndpoint— 直连 Jaeger CollectorHTTPCollector 模式把追踪数据直接 POST 给 Jaeger Collector 的 HTTP 接口适合应用与 Jaeger 后端不在同一主机或希望绕过 Agent 直连采集端的场景。从 uploader.go 的默认配置可见端点从环境变量OTEL_EXPORTER_JAEGER_ENDPOINT读取缺省为http://localhost:14268/api/traces用户名/密码分别来自OTEL_EXPORTER_JAEGER_USER与OTEL_EXPORTER_JAEGER_PASSWORD没有默认值两者都为空时不设置认证头使用http.DefaultClient作为默认 HTTP 客户端。该模式下的选项见 uploader.go选项作用WithEndpoint(endpoint)设置 Collector 完整 URL覆盖OTEL_EXPORTER_JAEGER_ENDPOINTWithUsername(username)设置 Basic 认证用户名覆盖OTEL_EXPORTER_JAEGER_USERWithPassword(password)设置 Basic 认证密码覆盖OTEL_EXPORTER_JAEGER_PASSWORDWithHTTPClient(client)自定义*http.Client可用于超时、TLS、代理等定制Collector 上传的实现细节非常明确见 uploader.go序列化采用 ThriftBinary Protocol请求方法为POSTContent-Type设为application/x-thrift仅当用户名与密码同时非空时才调用SetBasicAuth响应状态码不在 2xx 范围即返回错误failed to upload traces; HTTP status code: %d。环境变量配置一键切换选项优先README 提供了官方的环境变量对照表这是运维侧最常用的配置入口完整继承如下环境变量对应选项默认值OTEL_EXPORTER_JAEGER_AGENT_HOSTWithAgentHostlocalhostOTEL_EXPORTER_JAEGER_AGENT_PORTWithAgentPort6831OTEL_EXPORTER_JAEGER_ENDPOINTWithEndpointhttp://localhost:14268/api/tracesOTEL_EXPORTER_JAEGER_USERWithUsername无OTEL_EXPORTER_JAEGER_PASSWORDWithPassword无这些变量名都定义在 env.go 中并通过envOr(key, defaultValue)工具函数读取变量存在且非空时取变量值否则取默认值见 env.go。优先级规则README 明确声明显式传入的选项 环境变量 内置默认值。这一点在 uploader.go 中体现得很直观WithAgentEndpoint/WithCollectorEndpoint先以环境变量初始化配置再逐个应用用户传入的 option 覆盖。源码级解析OTel Span 是如何变成 Jaeger Thrift 的理解了配置层之后值得深入 jaeger.go 看一遍数据转换与导出的完整流水线这对排查追踪为什么没查到很有帮助。1. 导出入口与批处理ExportSpansExportSpansjaeger.go是导出器实现sdktrace.SpanExporter的核心方法流程如下快速检查ctx是否已取消、导出器是否已Shutdown命中则直接返回通过jaegerBatchList(spans, e.defaultServiceName)把一批 OTel Span 按Resource 分组成若干个 JaegerBatch对每个 Batch 调用上传器的upload(ctx, batch)发送任一 Batch 发送失败即返回错误。Shutdownjaeger.go通过sync.Once关闭stopCh随后让上传器释放连接资源。2. 分组与 Service 识别jaegerBatchList / processjaegerBatchListjaeger.go用map[attribute.Distinct]*gen.Batch把同 Resource 的 Span 归入同一 Batch保证每个 Batch 携带一份独立的Process即 Jaeger 中的服务进程描述。processjaeger.go负责把 OTelResource映射为 JaegerProcess遍历 Resource 属性时service.name被提取为Process.ServiceName而不转成 Tag其余属性全部转为Process.Tags。若 Span 的 Resource 中没有service.name则回退使用默认 Resource 中的服务名——这也就是New()在构造时会从resource.Default()读取service.name的原因jaeger.go取不到时会直接报错failed to get service name from default resource。3. 字段映射spanToThriftspanToThriftjaeger.go完成单条 Span 的字段级转换值得留意的映射规则包括TraceID / SpanID / ParentSpanID按 BigEndian 拆分为TraceIdHigh/TraceIdLow两个 int64 与单个 int64 的 SpanID时间单位换算StartTime用UnixNano() / 1000转成微秒Duration用纳秒差值再除以 1000Span Kind非SpanKindInternal的 Kind 写为字符串 Tagspan.kind状态码codes.Ok映射为otel.status_codeOKcodes.Error额外追加布尔 Tagerrortrue与otel.status_codeERROR描述写入otel.status_descriptionInstrumentationScope追加otel.library.name与otel.library.version两个 Tag事件Events转为 JaegerLog时间戳换算为微秒事件名写入名为event的字段被丢弃的属性数写入otel.event.dropped_attributes_countLinks全部映射为FOLLOWS_FROM类型的 SpanRef。keyValueToTagjaeger.go负责 OTelattribute.KeyValue到 ThriftTag的类型转换字符串→TagType_STRING、布尔→TagType_BOOL、int64→TagType_LONG、float64→TagType_DOUBLE而四种切片类型BOOL/INT64/FLOAT64/STRING 切片统一通过 JSON 序列化后以字符串 Tag 承载。4. Agent UDP 的报文组装agent.goAgent 链路的传输细节在 agent.go 中这是理解UDP 模式为什么偶尔丢数据的关键报文上限udpPacketMaxLength 65000字节另有emitBatchOverhead 70字节的封包开销实际可用净荷为 65000 - 70协议使用 ThriftCompact ProtocolTCompactProtocolTMemoryBuffer协议工厂配置可见 agent.go拆包逻辑EmitBatchagent.go先序列化Process得到其大小再逐个累计 Span 大小单个 Span 超限则直接丢弃并记录错误累计超限则先把已有 Spanflush成一个 UDP 报文再继续下一包写失败检查flush后会检查thriftBuffer.Len() maxPacketSize超限时报data does not fit within one UDP packet。5. UDP 自动重连机制reconnecting_udp_client.goAgent 模式默认开启的重连由 reconnecting_udp_client.go 实现后台 goroutine 每resolveTimeout默认 30 秒重新解析一次主机地址若解析出的地址与当前连接不同则新建 UDP 连接并替换旧连接Write失败时也会先尝试重解析重拨成功则重试写入。这保证了 agent 地址如 DNS 记录发生变化时导出器仍能自动恢复。BuildKit 中的接入兼容旧版 JAEGER_TRACE 的自动探测除了 vendor 中提供该导出器BuildKit 还在 util/tracing/detect/jaeger/jaeger.go 中实现了针对 Jaeger 的自动探测注册这是该导出器在 BuildKit 中最直接的实战用法自动启用条件jaeger.go满足以下任一条件即启用 Jaeger 导出器——OTEL_TRACES_EXPORTERjaeger存在旧版兼容变量JAEGER_TRACE设置了OTEL_EXPORTER_JAEGER_AGENT_HOST或OTEL_EXPORTER_JAEGER_ENDPOINT。旧版变量兼容JAEGER_TRACE是 OpenTelemetry 规范之外、BuildKit 为向后兼容保留的变量。其值若以http:///https://开头则视为 Collector 端点否则按host:port解析为 Agent 地址jaeger.go。BuildKit 侧附加变量BuildKit 额外支持OTEL_EXPORTER_JAEGER_HOST默认localhost与OTEL_EXPORTER_JAEGER_PORT默认6831端点默认值为http://localhost:14250jaeger.go。注意这三个默认值是该集成代码自身定义的与导出器包内默认值并不完全一致配置时需留意。线程安全包装社区曾反馈该 Jaeger 导出器并非线程安全BuildKit 因此用sync.Mutex将其包裹为threadSafeExporterWrapper对ExportSpans做互斥保护jaeger.go。因此在 BuildKit 上启用 Jaeger 追踪最省事的办法就是设置环境变量例如 Agent 模式OTEL_TRACES_EXPORTERjaeger JAEGER_TRACEjaeger-agent:6831或直连 CollectorOTEL_EXPORTER_JAEGER_ENDPOINThttp://jaeger-collector:14268/api/traces迁移建议从 Jaeger 导出器走向 OTLP鉴于官方已弃用该导出器任何新代码都不应再引入exporters/jaeger依赖存量系统迁移时应替换为官方推荐的 OTLP 导出器otlptracehttpgo.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp适用于 HTTP/Protobuf 链路otlptracegrpcgo.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc适用于 gRPC 链路。现代 Jaeger 后端已原生支持 OTLP 接入Jaeger 官方将 OTLP 作为推荐协议迁移后既能解除对已被放弃模块的依赖又能获得 OpenTelemetry 生态的持续维护。BuildKit 自身的追踪体系也已演进为基于 OTLP 的自动探测见 util/tracing 目录下的其他检测器实现与 Jaeger 导出器共存但定位不同——Jaeger 相关代码仅承担兼容旧环境的职责。小结本文基于 README.md 完整呈现了 OpenTelemetry Go Jaeger 导出器的安装、双链路配置、环境变量表与弃用声明并通过 jaeger.go、agent.go、uploader.go、env.go 与 reconnecting_udp_client.go 还原了从 OTel Span 到 Jaeger Thrift 数据包的完整转换链路。对于在 BuildKit 及其衍生系统中维护存量追踪能力的工程师可参照 util/tracing/detect/jaeger/jaeger.go 的兼容接入方式对于新建项目请务必遵循官方建议直接采用 OTLP 导出器。【免费下载链接】buildkitconcurrent, cache-efficient, and Dockerfile-agnostic builder toolkit项目地址: https://gitcode.com/GitHub_Trending/bu/buildkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考