Node.js agent release notesRSS

Notes

Features

• Added support for native Next.js OTEL instrumentation via the Hybrid Agent (#4040) (1944f39)

Bug fixes

• Updated label parser to handle empty values in an object key (#4004) (73c00d7)

Code refactoring

• Migrate @hapi/hapi and @hapi/vision to subscriber-based (#3995) (54c60a8)
• Refactored koa instrumentation to subscribe to events emitted (#4016) (e1f6c27)
• Updated MiddlewareWrapper maybeHandleError to only mark error as handled if there was a previously stored error (#4032) (1b21cc8)

Documentation

• Removed linked to @newrelic/apollo-server-plugin as instrumentation was merged into agent (#4003) (9afd9cb)
• Moved apollo-server docs to the docs website (#3994) (11ca2ae)
• Updated compatibility report (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

Miscellaneous chores

• Deprecate instrumentLoadedModule API (#4034) (306ff86)
• Added audit logging for OTEL metrics (#4018) (494c836)
• Added OTEL rule to support Prisma 7 (#4013) (c142c60)
• Fix ordering of OTEL rules (#4025) (150476a)
• Refactored OTEL transform rules (#3999) (48ff739)
• Fixed node-version in CI workflow (#4042) (dd05ea9)
• Updated codecov action (#4039) (31b9c84)
• Updated remote-method to use audit method of logger (#4038) (0e4507e)
• Added baseline instructions for Claude bot (#4036) (c8f6649)
• Updated dependencies
  • Removed unused dev dependencies (#4005) (e00f7d3)
  • Updated @apm-js-collab/tracing-hooks to 0.9.1 (#4043) (f05e5d4)
  • Updated commander to latest (#4021) (83b1d58)
  • Updated nock to latest (#4022) (9bf79ab)
  • Updated sinon to latest (#4020) (0ced304)
  • Updated protobufjs to latest (#4006) (45c61f3)
  • Upgraded glob to 13 (#4008) (3053545)
  • Upgraded got and rimraf to latest (#4007) (b967593)

Tests

• Add stable http.request shim so AWS test agent setup works with smithy >=4.7.3 (#4010) (c5fd80a)
• Added an undici versioned test to assert behavior with using a self signed cert and undici.Agent (#4026) (27507bc)
• Refactor mongodb-esm tests to test >=4.1.4 (#4023) (d85767f)
• Removed reliance on glob in lieu of fs.glob (#4019) (204f124)
• Updated undici.Agent versioned test to skip using custom dispatcher on versions <5.2.0 as it was not supported (#4029) (08cd079)

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

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

• Removido o suporte ao Node.js 20
• Instrumentação de @apollo/sever migrada de um plug-in(@newrelic/apollo-server-plugin) para instrumentação tradicional
• Funcionalidade de rastreamento multiaplicativo (CAT) removida
• Removido o suporte para Políticas de Licença, Aplicativo e Segurança (LASP)
• Removida a instrumentação para koa-route
• Removida a instrumentação para koa-router
• Removido shim.prefixRouteParameters pois a lógica foi movida anteriormente para quando uma transação termina
• Removida a criação de segmentos MySQL Pool#query
• Removido shim.argsToArray
• Versão mínima suportada de @nestjs/cli e @nestjs/core atualizada para 10.0.0
• Atualizada a versão mínima suportada de next para 14
• Versão mínima suportada de bluebird atualizada para 3.0.0
• Versão mínima suportada de mysql2 atualizada para 3.0.0
• Versão mínima suportada para cassandra-driver atualizada para 4.0.0
• Removido o suporte ao fastify 3.x
• Atualizado config.distributed_tracing.exclude_newrelic_header para ser definido como true por padrão

Recurso

• Suporte removido para fastify 3.x (#3980) (720979b)
• Removido o suporte ao Node.js 20 (#3980) (5306223)
• Instrumentação de @apollo/sever migrada de um plug-in(@newrelic/apollo-server-plugin) para a instrumentação tradicional (#3980) (736e0a4)
• Removido shim.argsToArray (#3980) (9183d29)
• Removido shim.prefixRouteParameters porque a lógica foi movida anteriormente para quando uma transação termina (#3980) (9f1408e)
• Removida a criação de segmentos MySQL Pool#query (#3980) (1d5a6dd)
• Funcionalidade de Rastreamento multiaplicativo (CAT) removida (#3980) (a87ed4d)
• Removida instrumentação para koa-route (#3980) (40c10d9)
• Removida instrumentação para koa-router (#3980) (038ecc7)
• Removido o suporte para políticas de licença, aplicativo e segurança (LASP) (#3980) (bc09485)
• Atualizado config.distributed_tracing.exclude_newrelic_header para ser definido como true por padrão (#3980) (774ce08)
• Versão mínima suportada de cassandra-driver atualizada para 4.0.0 (#3980) (419337a)
• Atualizada a versão mínima suportada de @nestjs/cli e @nestjs/core para 10.0.0 (#3980) (120e6de)
• Versão mínima suportada de bluebird atualizada para 3.0.0 (#3980) (369f920)
• Versão mínima suportada de mysql2 atualizada para 3.0.0 (#3980) (2861406)
• Versão mínima suportada do next atualizada para 14 (#3980) (80c5c0c)

Refatoração de código

• Atualizado como o tempo exclusivo e o tempo total do trace são calculados (#3980) (b227ed6)
• Instâncias de tracer.bindFunction atualizadas com tracer.runInContext para melhorar o desempenho em caminhos críticos (#3811) (5d77085)

Documentação

• Relatório de compatibilidade atualizado (#3990) (f3bb380)

Tarefas diversas

• Removido husky em favor de git hooks, adicionadas opções de segurança reforçada a npm install (#3988) (e3a7dda)
• Dependências de produção atualizadas para as mais recentes (#3996) (b710bac)

Testes

• Adicionado minSupported ao package.json de testes versionados do nest js para garantir que o relatório de compatibilidade mostre que oferecemos suporte a @nestjs/core (#3982) (bfa4aa1)
• Adicionados testes do prisma 7 (#3980) (116ee9c)
• Movido o código do executor de testes versionado de @newrelic/test-utilties para o agente (#3980) (d4f9a0c)
• Removido @newrelic/test-utilities (#3980) (1751147)
• Reduzir o tamanho da amostra dos testes esm do tipo smoke (#3986) (40669fb)
• Corrigido test/lib/get-package-version.js (#3993) (5d31f08)
• Corrigido o problema de busca de versão nos testes do AWS-sdk-v3 (#3992) (7be3f4a)
• Reestruturar o executor de testes aws-sdk-v3 para usar groupedDependencies (#3984) (fc67490)
• Atualizamos alguns blocos de teste versionados para reduzir o número de combinações executadas (#3991) (d606305)

integração contínua

• Adicionado contents: write a post-release para permitir commit/push da documentação da API (#3978) (90c4e61)
• Atualizadas as ações restantes para que sejam executadas no Node 24 (#3980) (ea21934)
• Versão de actions/download-artifact atualizada para v8 (#3980) (54a58b9)
• Versões atualizadas das actions para garantir que estejam sendo executadas no node 24 (#3980) (6302002)

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

• Adicionada instrumentação para Google ADK BaseAgent.runAsync (#3905) (c6c51d5)
• Instrumento Google ADK FunctionTool.runAsync (#3935) (57f9ed7)
• Instrumentação @azure/functions atualizada para o tipo assinante (#3915) (227e779)
• Atualizado como as chaves de licença são ocultadas nos logs (#3945) (6289502)

Correções de bugs

• Consultas de instrumentação de connect atualizadas para lidar com a reestruturação de arquivos em <3.4.0 (#3923) (00b615c)
• Atualizado tracer.bindFunction para tocar no segmento se uma promise for resolvida ou rejeitada (#3967) (712db61)
• Instrumentação do AWS SDK v3 atualizada para lidar com o uso de @smithy/smithy-client 4.13.0+ (#3965) (5e0fe24)

Refatoração de código

• Removida a dependência de AsyncLocalStorage.enterWith para a instrumentação de undici, domínio e process._fatalException (#3894) (612b449)

Documentação

• Relatório de compatibilidade atualizado (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

Tarefas diversas

• Adicionada linha de log quando max_trace_segments é atingido (#3933) (46b9238)
• Comentar assertSegmentDuration para o teste client-dynamodb (#3972) (590cd3e)
• Corrigido problema com os testes do amqplib (#3969) (a770000)
• Refatorada a instrumentação do Connect para o tipo assinante (#3912) (e5d87b7)
• Instrumentação do kafkajs refatorada para o tipo subscriber (#3958) (72e383c)
• Remover a asserção actualTime vs segmentDuration nos testes memcached (#3932) (98c50e0)
• Atualizado @apm-js-collab/tracing-hooks para 0.7.0 (#3949) (5c99cd1)

Testes

• Adicionada a asserção personalizada assertSegmentDuration e adicionada a memcached testes (#3875) (b28d866)

integração contínua

• Aplicado o modelo de privilégio mínimo a todos os fluxos de trabalho para atender ao CodeQL (#3961) (237d5b9)

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

Correções de bugs

• Corrigida a instrumentação de child_process para evitar o vazamento de manipuladores de eventos inscritos em once (#3907) (ad0b1f6)

Documentação

• Relatório de compatibilidade atualizado (#3897) (0ed2202)

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

Correções de bugs

• Corrigida a detecção da presença de atributos de mensagem do AWS SDK (#3903) (e81dc61)

Testes

• Atualizado minAgentVersion para testes versionados do Anthropic (#3900) (e1f6c32)
• Reorganizados os utilitários de teste nos testes versionados da AWS (#3895) (3025571)

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/)