OpenTelemetry依赖包升级正确性验证及适配建议

我在NestJS(TypeScript)项目中使用以下OpenTelemetry依赖包旧版本：

"@opentelemetry/api": "=1.4.1",
"@opentelemetry/exporter-jaeger": "^1.13.0",
"@opentelemetry/instrumentation-express": "^0.32.3",
"@opentelemetry/instrumentation-http": "^0.39.1",
"@opentelemetry/instrumentation-ioredis": "^0.34.2",
"@opentelemetry/instrumentation-nestjs-core": "^0.32.4",
"@opentelemetry/instrumentation-pg": "^0.35.2",
"@opentelemetry/instrumentation-socket.io": "^0.33.3",
"@opentelemetry/sdk-node": "=0.39.1",
"@opentelemetry/sdk-trace-base": "=1.13.0",
"@opentelemetry/sdk-trace-node": "=1.13.0",

为生产环境升级至最新稳定版以避免破坏性变更，我已通过@latest升级到以下版本，并将废弃的Jaeger Exporter替换为OTLP HTTP Exporter（用于向本地Docker部署的Jaeger发送追踪数据）：

"@opentelemetry/api": "^1.9.0",
"@opentelemetry/exporter-trace-otlp-http": "^0.208.0",
"@opentelemetry/instrumentation-express": "^0.57.0",
"@opentelemetry/instrumentation-http": "^0.208.0",
"@opentelemetry/instrumentation-ioredis": "^0.56.0",
"@opentelemetry/instrumentation-nestjs-core": "^0.55.0",
"@opentelemetry/instrumentation-pg": "^0.61.0",
"@opentelemetry/instrumentation-socket.io": "^0.55.0",
"@opentelemetry/resources": "^2.2.0",
"@opentelemetry/sdk-node": "^0.208.0",
"@opentelemetry/sdk-trace-base": "^2.2.0",
"@opentelemetry/sdk-trace-node": "^2.2.0",

请验证该版本是否正确，若不正确请给出适配NestJS项目的正确版本方案。

你的版本存在版本割裂冲突问题：

• OpenTelemetry核心SDK包（如sdk-node、instrumentation-http）使用了0.208.x系列，而资源、追踪基础包（resources、sdk-trace-base等）使用了2.x系列，这两个版本属于不同发布线，会导致依赖不兼容和运行时错误。
• 工具库（instrumentation类包）与核心SDK版本不匹配，可能引发调用异常。

正确的版本配置（适配NestJS生产环境） #

OpenTelemetry从1.x开始统一核心包版本号，当前最新稳定核心版本为2.2.0，工具库需匹配对应兼容版本。以下是统一无冲突的依赖配置：

"@opentelemetry/api": "^1.9.0",
"@opentelemetry/exporter-trace-otlp-http": "^0.52.0",
"@opentelemetry/instrumentation-express": "^0.57.0",
"@opentelemetry/instrumentation-http": "^0.52.0",
"@opentelemetry/instrumentation-ioredis": "^0.56.0",
"@opentelemetry/instrumentation-nestjs-core": "^0.55.0",
"@opentelemetry/instrumentation-pg": "^0.61.0",
"@opentelemetry/instrumentation-socket.io": "^0.55.0",
"@opentelemetry/resources": "^2.2.0",
"@opentelemetry/sdk-node": "^2.2.0",
"@opentelemetry/sdk-trace-base": "^2.2.0",
"@opentelemetry/sdk-trace-node": "^2.2.0"

关键注意事项 #

1. 版本统一逻辑：核心SDK包（resources、sdk-node、sdk-trace-*）使用2.2.0，对应的工具库、Exporter包版本号需匹配（如0.52.x对应核心2.2.0），避免跨版本线混用。
2. OTLP Exporter配置：向本地Docker Jaeger发送数据时，需配置正确的端点地址，示例代码片段：

const exporter = new OTLPTraceExporter({
  url: 'http://localhost:4318/v1/traces'
});

3. NestJS版本适配：@opentelemetry/instrumentation-nestjs-core@0.55.0兼容NestJS 9.x/10.x，若使用更早版本NestJS，可适当降低该工具库版本至对应兼容范围。

内容的提问来源于stack exchange，提问作者Lexter Seoul