Notas
Correções de bugs
- Atualizado o instrumentado
winstonpara atribuirhandleExceptionsao primeiro NrTransport para evitar o registro de manipuladoresuncaughtExceptionduplicados (#4108) (d60a48d)- Isso criaria um vazamento de memória linear porque os objetos
NrTransportpara agentes que não estão mais em uso, não seriam liberados devido ao manipuladorprocess.on('uncaughtException')global
- Isso criaria um vazamento de memória linear porque os objetos
Documentação
integração contínua
- Fixado o npm do CI para 11 para que as suítes versionadas nativas sejam compiladas no Node 22 (#4114) (b844e94)
- Removido o tempo limite de shard versionado de 8 minutos (#4111) (0ef6374)
- Tentativa de corrigir o problema de CI do memcached novamente (#4098) (f67fef5)
- Testes versionados de shard em executores de CI (#4101) (1471734)
Testes
- Adicionado
samplesao prisma e next para reduzir as versões em teste nos pacotes em que recomendamos o uso da instrumentação de agente híbrida (#4112) (7d8bd7c) - Resolvido
grpcproto-loaderdonode_modulesda suíte em execução (#4110) (5b5a9f8)
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
- Adicionado suporte ao Node.js 26 (#4084) (4a7f777)
- Adicionados os rótulos
span_idetrace_idaos dados de amostraCpuProfiler(#4049) (c2b1737) - Adicionada nova lógica de nome do host do GCP Cloud Run para incluir
K_REVISION(#4069) (02855dc) - Adicionada a opção de configuração
profiling.source_mapping.enabled(#4090) (43add80) - Removido
spanIdno cabeçalhotracestatede saída (#4091) (40a8bf1)
Refatoração de código
Documentação
Tarefas diversas
- Resolvidas falhas intermitentes de CI de longa data (#4093) (ae973a0)
- Corrigida a resolução da versão do pacote no Node 26 (#4094) (73d14a9)
integração contínua
- Atualizado
release-creationpara usarlts/*para node-version (#4080) (7eaed22) - Atualizado o job
setup-nodepara incluircheck-latestpara garantir que estamos obtendo a versão mais recente do node (#4079) (4a425f6)
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/)
Correções de bugs
Corrigido o travamento do Azure Functions quando incluem cabeçalhos de resposta (#4070) (c88d2b7)
Documentação
Relatório de compatibilidade atualizado (#4067) (0ae24b8)
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.
Consulte a política de EOL do agente Node.js da New Relic para obter informações sobre as versões do agente e as datas de suporte.
Notas
Documentação
- Documentação desatualizada do Next.js removida no repositório (#4060) (185bb66)
- Relatório de compatibilidade atualizado (#4047) (25cbd38)
Tarefas diversas
- Adicionado suporte de configuração de proxy para métricas do OTEL (#4041) (6c04b8a)
- Adicionadas métricas de suportabilidade para exportação de métricas do OTEL (#4051) (db6e4e3)
- Versão mínima dos pacotes
@opentelemetry0.xatualizada para^0.219.0(#4065) (3f58ad0)
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
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/hapie@hapi/visionpara baseado em assinantes (#3995) (54c60a8) - Refatorada a instrumentação de
koapara assinar eventos emitidos (#4016) (e1f6c27) - Atualizado MiddlewareWrapper
maybeHandleErrorpara marcar o erro como tratado apenas se houvesse um erro armazenado anteriormente (#4032) (1b21cc8)
Documentação
- Removido o link para
@newrelic/apollo-server-pluginjá que a instrumentação foi mesclada ao agente (#4003) (9afd9cb) - Movida a documentação de
apollo-serverpara o site de documentação (#3994) (11ca2ae) - Relatório de compatibilidade atualizado (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)
Tarefas diversas
Adicionado logging de auditoria para métricas do OTEL (#4018) (494c836)
Adicionada regra OTEL para suporte ao Prisma 7 (#4013) (c142c60)
Regras de transformação do OTEL refatoradas (#3999) (48ff739)
Corrigido node-version no fluxo de trabalho de CI (#4042) (dd05ea9)
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-hookspara0.9.1(#4043) (f05e5d4) - Atualizado
commanderpara a versão mais recente (#4021) (83b1d58) - Atualizado
nockpara a versão mais recente (#4022) (9bf79ab) - Atualizado
sinonpara a versão mais recente (#4020) (0ced304) - Atualizado
protobufjspara a versão mais recente (#4006) (45c61f3) - Atualizado
globpara 13 (#4008) (3053545) - Atualizados
goterimrafpara a versão mais recente (#4007) (b967593)
Testes
- Adicionar shim
http.requestestá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-esmpara testar>=4.1.4(#4023) (d85767f) - Removida a dependência de
globem favor defs.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/)
Notes
⚠ BREAKING CHANGES
This version of the Node.js agent is a SemVer MAJOR update and contains the following breaking changes. MAJOR versions may drop support for language runtimes that have reached End-of-Life according to the maintainer. Additionally, MAJOR versions may drop support for and remove certain instrumentation. For more details on these changes please see the migration guide.
- Dropped support for Node.js 20
- Migrated
@apollo/severinstrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation - Removed Cross Application Tracing(CAT) functionality
- Removed support for License, Application, and Security Policies(LASP)
- Removed instrumentation for
koa-route - Removed instrumentation for
koa-router - Removed
shim.prefixRouteParametersas the logic was previously moved to when a transaction ends - Removed creating
MySQL Pool#querysegments - Removed
shim.argsToArray - Updated minimum supported version of
@nestjs/cliand@nestjs/coreto10.0.0 - Updated minimum supported version of
nextto 14 - Updated minimum supported version of
bluebirdto3.0.0 - Updated minimum supported version of
mysql2to3.0.0 - Updated minimum supported version for
cassandra-driverto4.0.0 - Dropped support for
fastify3.x - Updated
config.distributed_tracing.exclude_newrelic_headerto be set totrueby default
Features
- Dropped support for
fastify3.x (#3980) (720979b) - Dropped support for Node.js 20 (#3980) (5306223)
- Migrated
@apollo/severinstrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation (#3980) (736e0a4) - Removed
shim.argsToArray(#3980) (9183d29) - Removed
shim.prefixRouteParametersas the logic was previously moved to when a transaction ends (#3980) (9f1408e) - Removed creating
MySQL Pool#querysegments (#3980) (1d5a6dd) - Removed Cross Application Tracing(CAT) functionality (#3980) (a87ed4d)
- Removed instrumentation for
koa-route(#3980) (40c10d9) - Removed instrumentation for
koa-router(#3980) (038ecc7) - Removed support for License, Application, and Security Policies(LASP) (#3980) (bc09485)
- Updated
config.distributed_tracing.exclude_newrelic_headerto be set totrueby default (#3980) (774ce08) - Updated minimum supported version for
cassandra-driverto4.0.0(#3980) (419337a) - Updated minimum supported version of
@nestjs/cliand@nestjs/coreto10.0.0(#3980) (120e6de) - Updated minimum supported version of
bluebirdto3.0.0(#3980) (369f920) - Updated minimum supported version of
mysql2to3.0.0(#3980) (2861406) - Updated minimum supported version of
nextto 14 (#3980) (80c5c0c)
Code refactoring
- Updated how exclusive time and trace total time is calculated (#3980) (b227ed6)
- Updated instances of
tracer.bindFunctionwithtracer.runInContextto improve performance in hot paths (#3811) (5d77085)
Documentation
Miscellaneous chores
- Removed
huskyin lieu of git hooks, added security hardened options tonpm install(#3988) (e3a7dda) - Updated production dependencies to the latest (#3996) (b710bac)
Tests
- Added
minSupportedto the nest js versioned tests package.json to ensure the compatibility report will show we support@nestjs/core(#3982) (bfa4aa1) - Added prisma 7 tests (#3980) (116ee9c)
- Moved versioned test runner code from
@newrelic/test-utiltiesto agent (#3980) (d4f9a0c) - Removed
@newrelic/test-utilities(#3980) (1751147) - Decrease smoke-like esm tests' sample size (#3986) (40669fb)
- Fixed
test/lib/get-package-version.js(#3993) (5d31f08) - Fixed version lookup issue in aws-sdk-v3 tests (#3992) (7be3f4a)
- Restructure
aws-sdk-v3test runner to usegroupedDependencies(#3984) (fc67490) - Updated a few versioned test stanzas to reduce the number of combinations it runs (#3991) (d606305)
Continuous integration
- Added
contents: writetopost-releaseto allow commit/push of api docs (#3978) (90c4e61) - Updated remaining actions so they are running on Node 24 (#3980) (ea21934)
- Updated version of
actions/download-artifactto v8 (#3980) (54a58b9) - Updated versions of actions to ensure they are running on node 24 (#3980) (6302002)
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/)