Node.js agent release notesRSS

Notes

Code refactoring

• Updated agent to use @apm-js-collab/tracing-hooks for the CJS/ESM registration for tracing channel based instrumentation (#3324) (4b2c14f)

Documentation

• Updated compatibility report (#3330) (2831a89)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added ability to register Supportability/Features/Instrumentation/OnRequire/<pkg> metrics for subscriber based instrumentation (#3312) (87bfa40)
• Added esm loader hook and commonjs patch to work with orchestrion-js (#3312) (415aeba)
• Added instrumentation for @modelcontextprotocol/sdk client calls client.callTool, client.readResource, and client.getPrompt (#3312) (5d9790b)

Bug fixes

• Fixed logic around detecting OTEL packages (#3326) (4df30e5)
• Updated shimmer.setupSubscribers to properly setup and skip subscribers that are disabled (#3312) (cf5b3ec)

Code refactoring

• Added ability to disable subscribers via config.instrumentation.<pkg-name>.enabled (#3312) (55f8fe7)
• Added ability to prevent creation of segments in subscriber based instrumentation when parent is marked as internal and of the same package (#3322) (91f91c2)
• Removed id parameter from opensearch class (#3312) (8be00ce)
• Updated opensearch instrumentation to subscribe to events emitted (#3312) (9a27a5d)
• Updated elasticsearch instrumentation to subscribe to events emitted (#3312) (a3e2348)
• Updated ioredis instrumentation to subscribe to events emitted (#3312) (90b97d2)
• Updated pino instrumentation to subscribe to events emitted (#3312) (28bbe9f)
• Updated subscribers to have a common createSegment that creates, assigns attributes, starts segment (#3317) (aa3f8d9)
• Updated undici instrumentation to remove its reliance on shim. Also updated storing the relevant segments on context instead of symbols on the request object (#3312) (ec17fa7)

Documentation

• Updated compatibility report (#3313) (749ddc9) (#3304) (cc000a7)

Miscellaneous chores

• change from ending segment to touching for feature parity with shim (#3312) (4d39fc5)
• Updated eslint configuration (#3296) (5c168a6)

Tests

• Fixed obtaining opensearch package version for older versions we instrument (#3314) (e45ab27)
• Removed unnecessary prisma.$use in tests to unpin (#3303) (db20324)

Continuous integration

• Allow users to run benchmark tests even if not sending metrics (#3307) (1be1514)
• Change benchmark tests to use TEST_LICENSE (#3325) (1f7f733)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notas

Recurso

• Adicionado suporte para API de logs OTEL (#3228) (19a9c78)
• Adicionada a capacidade de suporte métrico quando a instrumentação foi desabilitada para um pacote (#3252) (6098a5b)
• Instrumentação de timers desabilitada por padrão no exemplo de configuração (#3253) (72eb8d4)

Correções de bugs

• Corrigida transaction.url ofuscação (#3280) (dc09492)

Refatoração de código

• Atualizado http-outbound para analisar url apenas uma vez (#3270) (5bb0f8d)

Documentação

• Exemplo distributed tracing atualizado destino para usar o repositório correto (#3254) (1fb3859)
• Relatório de compatibilidade atualizado (#3299) (8b85342)
• Relatório de compatibilidade atualizado (#3267) (2712c94)
• Relatório de compatibilidade atualizado (#3265) (daedadd)
• Relatório de compatibilidade atualizado (#3261) (bd7d3fa)
• Relatório de compatibilidade atualizado (#3246) (c289fb5)
• Relatório de compatibilidade atualizado (#3241) (64529e1)

Tarefas diversas

• Guarda-corpo adicionado para ponte OTEL (#3283) (ff71865)
• Inicialização API refatorada (#3281) (97be8f6)

Testes

• Motores limpos e intervalos de versões em testes versionados (#3260) (c7fd60e)
• Corrigido teste de benchmark http com falha (#3258) (7e8cd48)
• Corrigiu um teste de benchmark de evento de intervalo com falha (#3255) (05b955f)
• Problemas de CI corrigidos com os últimos 24 (#3277) (960d169)
• Testes corrigidos que presumiam que a instrumentação dos temporizadores estava sempre habilitada (#3257) (40cfda1)
• Instalação forçada de dependências de pares no aplicativo de teste nestjs (#3269) (4e454ff)

integração contínua

• CI atualizado para falhar se os testes de benchmark falharem (#3256) (a6a7a15)
• Adicionado envio de benchmark métrico para NR One (#3285) (7fc8e40)

Declaração de apoio:

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

Consulte a New Relic Node.js política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notas

⚠ ALTERAÇÕES CRÍTICAS

Esta versão do agente Node.js é uma atualização PRINCIPAL do SemVer e contém as seguintes alterações importantes. As principais versões podem deixar de oferecer suporte a tempos de execução de linguagens que atingiram o fim de vida útil, de acordo com o mantenedor. Além disso, as versões PRINCIPAIS podem deixar de oferecer suporte e remover certos instrumentos. Para mais detalhes sobre essas alterações, consulte o guia de migração.

• Suporte abandonado para Node.js 18
• Versão mínima suportada atualizada para fastify para 3.0.0, pino para 8.0.0 e koa-router para 12.0.0

Recurso

• Suporte removido para Node.js 18 (#3097) (cb7c080)
• Versão mínima suportada atualizada para fastify, pino e koa-router (#3108) (ae9e21d)

Documentação

• Documentação de compatibilidade AI Monitoring atualizada com as novas APIs AWS Bedrock (#3230) (e1ff0d3)
• Relatório de compatibilidade atualizado (#3237) (dc85e4e)

Testes

• Corrigido assertSegments para inserir todos os segmentos esperados (#3239) (de183fb)
• Testes atualizados para simular chamadas de saída para evitar problemas no CI (#3234) (66694c6)

integração contínua

• Versão de preparação atualizada para excluir cópia principal do Semver para repositório diferente de node-newrelic (#3242) (82d9689)
• Preparação de lançamento atualizada para adicionar cópia em torno de mudanças drásticas (#3199) (ca1131c)

Declaração de apoio:

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

Consulte a New Relic Node.js política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notas

Recurso

• Instrumento AWS Bedrock Converse API (#3191) (16ac684)

Correções de bugs

• eventSegment.addAttribute não travará se nulo (#3215) (8955f37)
• openai Suporte à API de respostas alterado para >=v4.87.0 (#3219) (19c0c70)

Documentação

• Relatório de compatibilidade atualizado (#3220) (b4350c7)

Tarefas diversas

• .proto convertido para .json para agrupamento (#3212) (1e208d4)

Declaração de apoio:

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

Consulte a New Relic Node.js política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)