如何让OpenTracing与OpenTelemetry在Go链路追踪场景下协同工作

OpenTelemetry官方提供了OpenTracing桥接组件，无需修改第三方库源码即可实现两套追踪规范的协同。

1. 安装桥接依赖 #

执行以下命令安装Go版本的OTel-OpenTracing桥接包：

go get go.opentelemetry.io/otel/bridge/opentracing

2. 初始化桥接Tracer #

在项目初始化OTel TracerProvider之后，将其包装为OpenTracing兼容的Tracer实例：

import (
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/bridge/opentracing"
    opentracingGo "github.com/opentracing/opentracing-go"
)

// 复用项目中已初始化完成的OTel TracerProvider
otelTracerProvider := otel.GetTracerProvider()
// 生成桥接Tracer，第二个参数可传入自定义的错误处理器，不需要可以留空
bridgeTracer, _ := opentracing.NewTracer(otelTracerProvider.Tracer("third-party-bridge"))
// 将桥接Tracer设置为OpenTracing全局实例，第三方库默认会读取该全局Tracer
opentracingGo.SetGlobalTracer(bridgeTracer)

如果第三方库支持传入自定义Tracer参数，可以直接将bridgeTracer传入，无需设置全局实例，隔离性更好。

3. 上下文透传配置 #

无需修改现有项目的上下文传递逻辑，桥接层会自动适配OTel与OpenTracing的上下文格式：

• 项目中正常使用OTel的context.Context传递链路上下文即可，第三方库通过OpenTracing API读取上下文时会自动识别
• 如果第三方库要求显式传入OpenTracing SpanContext，可以用opentracing.NewSpanContextWrapper(otelSpan.SpanContext())将OTel的SpanContext转换为OpenTracing兼容格式

4. 常见问题排查 #

• 链路不串联：确认第三方库是否使用OpenTracing全局Tracer，若不支持全局Tracer则需通过配置传入构造好的bridgeTracer
• 标签/日志缺失：升级桥接包到最新稳定版，最新版本已兼容OpenTracing到OTel的语义标签映射
• 链路分裂：不要同时初始化原生OpenTracing Tracer和桥接Tracer，全局Tracer只能设置为桥接实例

内容的提问来源于stack exchange，提问作者Zhixin Wen