Node.js agent release notesRSS

Bug fixes

Fixed Azure functions crashing when they include response headers (#4070) (c88d2b7)

Documentation

Updated compatibility report (#4067) (0ae24b8)

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.

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Notes

Documentation

• Removed outdated Next.js documentation in repo (#4060) (185bb66)
• Updated compatibility report (#4047) (25cbd38)

Miscellaneous chores

• Added proxy config support to OTEL metrics (#4041) (6c04b8a)
• Added supportability metrics to OTEL metrics export (#4051) (db6e4e3)
• Updated min version of @opentelemetry 0.x packages to ^0.219.0 (#4065) (3f58ad0)

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 instrumentação OTEL nativa do Next.js via agente híbrido (#4040) (1944f39)

Correções de bugs

• Atualizado o analisador de rótulos para tratar valores vazios em uma chave de objeto (#4004) (73c00d7)

Refatoração de código

• Migrar @hapi/hapi e @hapi/vision para baseado em assinantes (#3995) (54c60a8)
• Refatorada a instrumentação de koa para assinar eventos emitidos (#4016) (e1f6c27)
• Atualizado MiddlewareWrapper maybeHandleError para marcar o erro como tratado apenas se houvesse um erro armazenado anteriormente (#4032) (1b21cc8)

Documentação

• Removido o link para @newrelic/apollo-server-plugin já que a instrumentação foi mesclada ao agente (#4003) (9afd9cb)
• Movida a documentação de apollo-server para o site de documentação (#3994) (11ca2ae)
• Relatório de compatibilidade atualizado (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

Tarefas diversas

• Descontinuar a API instrumentLoadedModule (#4034) (306ff86)

• Adicionado logging de auditoria para métricas do OTEL (#4018) (494c836)

• Adicionada regra OTEL para suporte ao Prisma 7 (#4013) (c142c60)

• Corrigir a ordenação das regras do OTEL (#4025) (150476a)

• Regras de transformação do OTEL refatoradas (#3999) (48ff739)

• Corrigido node-version no fluxo de trabalho de CI (#4042) (dd05ea9)

• Ação codecov atualizada (#4039) (31b9c84)

• Atualizado remote-method para usar o método audit do agente (#4038) (0e4507e)

• Adicionadas instruções de baseline para o bot Claude (#4036) (c8f6649)

• Dependências atualizadas

  • Removidas dependências de desenvolvimento não utilizadas (#4005) (e00f7d3)
  • Atualizado @apm-js-collab/tracing-hooks para 0.9.1 (#4043) (f05e5d4)
  • Atualizado commander para a versão mais recente (#4021) (83b1d58)
  • Atualizado nock para a versão mais recente (#4022) (9bf79ab)
  • Atualizado sinon para a versão mais recente (#4020) (0ced304)
  • Atualizado protobufjs para a versão mais recente (#4006) (45c61f3)
  • Atualizado glob para 13 (#4008) (3053545)
  • Atualizados got e rimraf para a versão mais recente (#4007) (b967593)

Testes

• Adicionar shim http.request estável para que a configuração do agente de teste da AWS funcione com smithy >= 4.7.3 (#4010) (c5fd80a)
• Adicionado um teste versionado do undici para verificar o comportamento ao usar um certificado autoassinado e undici.Agent (#4026) (27507bc)
• Refatorar testes mongodb-esm para testar >=4.1.4 (#4023) (d85767f)
• Removida a dependência de glob em favor de fs.glob (#4019) (204f124)
• Atualizado o teste versionado do undici.Agent para ignorar o uso de dispatcher personalizado em versões < 5.2.0, pois não era suportado (#4029) (08cd079)

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.

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