OpenTelemetry JavaScript SDK 3.0 é lançado com suporte apenas a ESM
Aprofundamento CEVIU
Aprofundamento
O OpenTelemetry JavaScript lançou o SDK 3.0, com pacotes estáveis na versão 3.0.0 e experimentais na 0.300.0, além da API 1.10.0. O piso de Node.js subiu para 22.15.0, então Node.js 18 e 20 ficam de fora. Segundo o blog do projeto, o Node.js 20 chegou ao fim de vida em abril de 2026. Um detalhe importante para o título da notícia: o blog diz que todos os pacotes agora trazem exports de ES Module (ESM) e de CommonJS. Ou seja, a fonte descreve suporte a ambos os formatos, com entry points reescritos para ficar mais amigável a ESM e a bundlers.
Outras mudanças afetam o código: o @opentelemetry/api-logs foi incorporado ao @opentelemetry/api, porque Logs foi estabilizado e agora Traces, Metrics e Logs são estáveis em JavaScript. Vários pacotes de tracing foram consolidados no @opentelemetry/sdk-trace. Pacotes obsoletos saíram, como propagator-jaeger, exporter-jaeger, shim-opentracing e shim-opencensus. Tipos e classes públicas foram renomeados ou movidos. Atributos complexos (OTEP 4485) funcionam em span e log record, mas não em atributos de resource e de métrica. A API em si não teve breaking changes, e quem usa o @opentelemetry/auto-instrumentations-node via instrumentação zero-code não precisa mudar nada. Os pacotes do opentelemetry-js-contrib também foram atualizados, e a série 2.x dos pacotes estáveis do SDK terá suporte por um ano a partir do 3.0.0.
O que mudou
A cobertura anterior do CEVIU ajuda a situar o runtime. Em 10 de junho de 2026, na matéria "Node.js 26: novidades da versão e o que esperar da mudança no modelo de lançamento", o CEVIU registrou que o Node.js 26 foi lançado como versão Current. O SDK 3.0 mira justamente um Node.js mais recente, com piso em 22.15.0. Em 2 de novembro de 2026, o CEVIU noticiou que o "OpenTelemetry eBPF Instrumentation chega à versão v1.0.0", outro marco de maturidade do projeto na mesma semana.
Por que isso importa
Para quem opera serviços Node.js, a leitura prática é checar a versão do runtime antes de qualquer bump. Imagens base com Node 18 ou 20 travam a atualização, e isso pode entrar no planejamento de pipeline. Quem usa exporter Jaeger ou shims de OpenTracing e OpenCensus precisa migrar antes de subir o SDK. Quem depende só da auto-instrumentação tende a ter menos trabalho, mas vale testar em staging. O ano de suporte à 2.x dá uma janela para fazer isso sem pressa.
Linha do tempo
CEVIU noticia o lançamento do Node.js 26 como versão Current.
OpenTelemetry eBPF Instrumentation chega à v1.0.0.
OpenTelemetry JavaScript SDK 3.0 é lançado, com Node.js 22.15.0 como mínimo e Logs estável.
Perguntas frequentes
O OpenTelemetry JS SDK 3.0 funciona só com ESM?
Segundo o blog oficial, não. Todos os pacotes trazem exports de ES Module e de CommonJS. A mudança nos entry points deixa o SDK mais amigável a ESM e a bundlers.
Qual versão mínima do Node.js o SDK 3.0 exige?
O mínimo agora é o Node.js 22.15.0. O suporte a Node.js 18 e 20 foi removido. O Node.js 20 chegou ao fim de vida em abril de 2026.
Preciso mudar algo se uso auto-instrumentations-node?
Segundo o blog, quem usa o pacote @opentelemetry/auto-instrumentations-node conforme a documentação de zero-code instrumentation não precisa mudar nada. A API (@opentelemetry/api) também não teve breaking changes.
Até quando a versão 2.x do SDK recebe suporte?
Pelas diretrizes do OpenTelemetry, os pacotes estáveis da série 2.x terão suporte por um ano a partir do lançamento da 3.0.0. Isso dá tempo para planejar a migração.
Fontes
- opentelemetry.iofonte original
- Categoria
- CEVIU DevOps
- Publicado
- 06 de novembro de 2026
- Editoria
- CEVIU DevOps
