Voltar

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

  1. CEVIU noticia o lançamento do Node.js 26 como versão Current.

  2. OpenTelemetry eBPF Instrumentation chega à v1.0.0.

  3. 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

Avalie este artigo:
Categoria
CEVIU DevOps
Publicado
06 de novembro de 2026
Editoria
CEVIU DevOps

Quer receber mais sobre CEVIU DevOps?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser