宣布 OpenTelemetry JavaScript SDK 2.0
激动人心的消息:OpenTelemetry JavaScript 已发布 SDK 2.0!
迁移指南
有关重大更改的详细说明,请参阅迁移指南:升级到 OpenTelemetry JS SDK 2.x。
JS SDK 2.x 是什么?
JS SDK 2.x 包含从 opentelemetry-js 仓库发布的 @opentelemetry/* JavaScript 包的新版本,但不包括 API 和 semantic-conventions 包。此新主版本系列包的版本将是稳定版 >=2.0.0,不稳定版 >=0.200.0。有关完整包列表的详细信息,请参阅 迁移指南。
有什么变化?
总结
- 最低支持的 Node.js 已提高到
^18.19.0 || >=20.6.0。这意味着已弃用对 Node.js 14 和 16 的支持。 - 最低支持的 TypeScript 版本已提高到 5.0.4。
- 转译 TypeScript 的编译目标已提高到 ES2022(从 ES2017)。
- 公共接口已更改。
- 有关迁移到 2.x / 0.200.x 的说明,请参阅 升级指南。
详情
- Node.js 支持的版本
- TypeScript 支持的版本
- ES2022 编译目标
- 弃用浏览器中的
window.OTEL_*支持 @opentelemetry/resourcesAPI 更改@opentelemetry/coreAPI 更改- Tracing SDK API 更改
@opentelemetry/sdk-metricsAPI 更改@opentelemetry/resources中针对 Resource Detector实现者的更改- 其他更改
为什么要这样做?
我们知道,通过允许破坏性更改来改进与以下相关的方面,我们将获得最大的好处:
- 优化:移除类和命名空间以实现更好的代码压缩和摇树优化。
- 更好的工具和支持:弃用旧的运行时和工具版本,以利用增强的 ESM 支持并简化文档。
- 速度:减少代码复杂性并移除已弃用的字段,以加快功能和维护工作。
这也标志着我们每年发布新的 SDK 主版本发布的开始。
有关 2.0 的更详细解释,请参阅 issue #4083。