当前位置:首页 >专题 >OpenTelemetry JavaScript SDK 3.0 工程实践专题

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 和分布式追踪文章连接起来,帮助团队把升级变成可验证的工程流程。

官方入口:3.0 变化与安装边界

先确认版本、包结构和官方快速开始

OpenTelemetry JavaScript SDK 3.0 发布说明
外链

OpenTelemetry JavaScript SDK 3.0 发布说明

官方介绍 SDK 3.0、API 1.10.0、Node.js 22.15+、ESM/CJS、日志稳定和包整合。
OpenTelemetry JS 3.x 迁移指南
外链

OpenTelemetry JS 3.x 迁移指南

官方逐项说明 Node.js 版本、导出、api-logs、追踪 SDK 和弃用包迁移。
OpenTelemetry JavaScript 文档总览
外链

OpenTelemetry JavaScript 文档总览

官方 JavaScript 语言实现入口,覆盖 API、SDK、Node.js、浏览器和示例。
Node.js 快速开始
外链

Node.js 快速开始

官方 Node.js 安装、初始化、自动检测和运行验证流程。
浏览器快速开始
外链

浏览器快速开始

官方浏览器端追踪初始化、导出和跨域注意事项。
JavaScript 自动埋点与手动埋点
外链

JavaScript 自动埋点与手动埋点

官方介绍 Node 与浏览器的 instrumentation 组合、配置和手动 span。
JavaScript 导出器文档
外链

JavaScript 导出器文档

官方说明 OTLP、Prometheus 等导出器的选择、配置与运行边界。

站内实战:Node、NestJS 与 Next.js

用真实文章搭建跨服务观测链路

NestJS + Opentelemetry (Loki)
文章

NestJS + Opentelemetry (Loki)

在 NestJS 中配置 OpenTelemetry,并把日志导出到 Loki。
NestJS + Opentelemetry(Grafana 云)
文章

NestJS + Opentelemetry(Grafana 云)

将 NestJS 的 trace 与 log 导出到 Grafana Cloud。
Nextjs 中的分布式跟踪
文章

Nextjs 中的分布式跟踪

在 Next.js 中设置 OpenTelemetry、API 路由追踪并分析跨服务请求。
使用 OpenTelemetry 探索可观察性:上下文传播和分布式架构
文章

使用 OpenTelemetry 探索可观察性:上下文传播和分布式架构

介绍上下文传播、分布式追踪和服务间观测连接。
OpenTelemetry:痕迹、指标、日志和行李
文章

OpenTelemetry:痕迹、指标、日志和行李

梳理 traces、metrics、logs 与 baggage 的核心概念。
Opentelemetry的基本概念
文章

Opentelemetry的基本概念

解释 OpenTelemetry 的 API、SDK、导出器和采集链路。
使用 OpenTelemetry 统一不同服务的范围
文章

使用 OpenTelemetry 统一不同服务的范围

排查 gRPC 服务之间 span 上下文没有正确传播的问题。
在 OpenTelemetry 中,otel.Tracer(name) 函数是如何创建和配置跟踪器的?
文章

在 OpenTelemetry 中,otel.Tracer(name) 函数是如何创建和配置跟踪器的?

从源码与配置角度理解 tracer 的创建过程。

升级验收:依赖、数据与回滚

把 3.0 迁移变成可复现的发布检查

OpenTelemetry JS GitHub 仓库
外链

OpenTelemetry JS GitHub 仓库

官方源码、发行说明、问题和贡献入口。
OpenTelemetry JS 自动埋点 Node 文档
外链

OpenTelemetry JS 自动埋点 Node 文档

官方 Node.js 零代码自动埋点与运行方式。
OpenTelemetry JavaScript API 参考
外链

OpenTelemetry JavaScript API 参考

JavaScript API 与 SDK 包的官方类型和接口参考。
OpenTelemetry JavaScript 发布包
外链

OpenTelemetry JavaScript 发布包

官方 npm 组织下的稳定与实验包发布入口。

常见问题

把 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;失败时通过锁定旧版本快速回滚。

微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码