OpenTelemetry JavaScript SDK 2.0 — 破坏性变更发布，提高 Node/TS 基线

关键更新

OpenTelemetry 发布了 JavaScript SDK 2.0（稳定的 SDK 包和 0.200.x 不稳定版本）。此版本将最低支持的 Node.js 提高到 ^18.19.0 || >=20.6.0，要求 TypeScript >=5.0.4，改变了公共 SDK 接口（因此 SDK 和一些仪器包存在破坏性变更），并将编译目标移动到 ES2022，以改善树摇和包大小。维护者提供了迁移指南和升级说明。（opentelemetry.io）

为什么这很重要

几乎每个依赖 OpenTelemetry SDK 包（服务器追踪、度量、自动仪器、出口）的 Node/TypeScript 服务或库都面临着不容小觑的迁移：您必须确保您的运行时（Node）和工具链（TypeScript/tsconfig）符合新的最低要求，更新供应商仪器（APM 代理和社区仪器可能需要升级），并运行集成测试，因为公共 SDK API 已经改变。收益是更小、更易优化的包，更少的运行时填充，以及简化的 SDK 界面，这将加速未来的改进 — 但直接影响是操作性的：分阶段升级、CI 矩阵更改，以及与旧仪器可能存在的临时不兼容。如果您维护依赖 @opentelemetry/* 的库，请计划更新并发布兼容版本；如果您运行服务，请在更新 OTEL 包和 Node 版本后安排金丝雀发布，并遵循官方迁移指南。

来源

• 来源