当前位置:首页 >专题 >OpenTelemetry JavaScript SDK 3.0 工程实践专题
OpenTelemetry Java
OpenTelemetry JavaScript SDK 3.0 工程实践专题
从 Node.js 22、ESM/CJS 到日志稳定与迁移验收
OpenTelemetry JavaScript SDK 3.0 于 2026 年 11 月发布,带来 Node.js 22.15+ 最低版本、完整 ESM/CJS 导出、复杂属性支持、日志信号稳定和多包整合。这个专题把官方升级说明与站内 Node.js、NestJS、Next.js 和分布式追踪文章连接起来,帮助团队把升级变成可验证的工程流程。
常见问题
把 Node 版本、兼容性和验收边界说清楚
OpenTelemetry JS SDK 3.0 最低需要什么 Node.js 版本?
除 API 与 semantic-conventions 包外,SDK 3.x 要求 Node.js >=22.15.0,Node.js 18 和 20 不再受支持。升级前应在本地、CI、容器和生产运行时逐一核对。
SDK 3.0 是否必须把 CommonJS 改成 ESM?
不必一刀切。3.0 同时提供更规范的 ESM 与 CommonJS exports,但深层导入和直接导入 package.json 的代码需要按迁移指南改写。
api-logs 被移除后应该怎么改?
删除独立的 @opentelemetry/api-logs 依赖并改用 @opentelemetry/api 中的日志 API,同时将 sdk-logs 升级到 3.x,再用真实日志导出链路验证字段和级别。
如何证明 JavaScript SDK 3.0 升级没有丢失观测数据?
对同一组请求同时核对 trace、metric、log 的数量、服务名、上下文关系、错误记录和导出耗时,并保留 2.x 与 3.0 的结果 diff;失败时通过锁定旧版本快速回滚。
相关专题
继续查看相近方向内容
查看更多
最新文章
-
- Go reflect.MapIter.Reset 怎样解除对原 map 的引用
- 2分钟前 436浏览
-
- Go sql.Rows 不生效怎么办
- 4分钟前 429浏览
-
- Go url.ParseQuery 怎样定位资源未释放
- 20分钟前 399浏览
-
- Go url.ParseQuery 为什么在边界输入上得到空结果
- 22分钟前 500浏览
-
- Go url.ParseQuery 不生效怎么办
- 23分钟前 118浏览
-
- Go http.Cookie 不生效怎么办
- 24分钟前 361浏览
-
- Go http.Cookie 怎样定位资源未释放
- 28分钟前 250浏览
-
- Go http.Cookie 为什么在边界输入上得到空结果
- 30分钟前 407浏览

