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/severmigrada 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.prefixRouteParameterspois 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/clie@nestjs/coreatualizada para10.0.0 - Atualizada a versão mínima suportada de
nextpara 14 - Versão mínima suportada de
bluebirdatualizada para3.0.0 - Versão mínima suportada de
mysql2atualizada para3.0.0 - Versão mínima suportada para
cassandra-driveratualizada para4.0.0 - Removido o suporte ao
fastify3.x - Atualizado
config.distributed_tracing.exclude_newrelic_headerpara ser definido comotruepor padrão
Recurso
- Suporte removido para
fastify3.x (#3980) (720979b) - Removido o suporte ao Node.js 20 (#3980) (5306223)
- Instrumentação de
@apollo/severmigrada de um plug-in(@newrelic/apollo-server-plugin) para a instrumentação tradicional (#3980) (736e0a4) - Removido
shim.argsToArray(#3980) (9183d29) - Removido
shim.prefixRouteParametersporque 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_headerpara ser definido comotruepor padrão (#3980) (774ce08) - Versão mínima suportada de
cassandra-driveratualizada para4.0.0(#3980) (419337a) - Atualizada a versão mínima suportada de
@nestjs/clie@nestjs/corepara10.0.0(#3980) (120e6de) - Versão mínima suportada de
bluebirdatualizada para3.0.0(#3980) (369f920) - Versão mínima suportada de
mysql2atualizada para3.0.0(#3980) (2861406) - Versão mínima suportada do
nextatualizada 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.bindFunctionatualizadas comtracer.runInContextpara melhorar o desempenho em caminhos críticos (#3811) (5d77085)
Documentação
Tarefas diversas
- Removido
huskyem favor de git hooks, adicionadas opções de segurança reforçada anpm install(#3988) (e3a7dda) - Dependências de produção atualizadas para as mais recentes (#3996) (b710bac)
Testes
- Adicionado
minSupportedao 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-utiltiespara 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-v3para usargroupedDependencies(#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: writeapost-releasepara 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-artifactatualizada 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/functionsatualizada 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
connectatualizadas para lidar com a reestruturação de arquivos em<3.4.0(#3923) (00b615c) - Atualizado
tracer.bindFunctionpara 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-client4.13.0+ (#3965) (5e0fe24)
Refatoração de código
- Removida a dependência de
AsyncLocalStorage.enterWithpara a instrumentação de undici, domínio eprocess._fatalException(#3894) (612b449)
Documentação
Tarefas diversas
- Adicionada linha de log quando
max_trace_segmentsé atingido (#3933) (46b9238) - Comentar
assertSegmentDurationpara o testeclient-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
actualTimevssegmentDurationnos testesmemcached(#3932) (98c50e0) - Atualizado
@apm-js-collab/tracing-hookspara0.7.0(#3949) (5c99cd1)
Testes
- Adicionada a asserção personalizada
assertSegmentDuratione adicionada amemcachedtestes (#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_processpara evitar o vazamento de manipuladores de eventos inscritos emonce(#3907) (ad0b1f6)
Documentação
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
Testes
- Atualizado
minAgentVersionpara 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/)
Notas
Recurso
- Adicionado suporte de instrumentação para
@anthropic-ai/sdk(#3881) (e8713bb) - Atributos de banco de dados do OTel atualizados para nomes estáveis das convenções semânticas 1.40.0 (#3826) (6d3000d)
- Adicionada propagação de distributed tracing ao SNS (#3893) (8fc1144)
Refatoração de código
Refatorar a instrumentação de
@aws-sdkv3 para assinar eventos emitidos- Adicionado assinante
@aws-sdk/smithy-client(#3877) (0e350fc) - Adicionado assinante
@smithy/smithy-clientsendcom AWS Bedrock Middleware (#3864) (5e0a6d1) - Movido o middleware genérico da AWS
Clientpara o assinante (#3889) (3cb1e1b) - Instrumentação
aws-sdk/dynamodbatualizada para um middleware assinante (#3891) (ff677a2) - Instrumentação do AWS SDK v3 atualizada para separar os utilitários do bedrock do middleware encapsulado real (#3883) (eed340e)
- Atualizada a instrumentação do Lambda para um middleware de assinante (#3890) (12f8284)
- Refatorada a instrumentação do SNS para o tipo assinante (#3876) (b9f3326)
- Instrumentação do SQS refatorada para o tipo subscriber (#3880) (de46dee)
- Adicionado assinante
Refatorado
LlmErrorMessagepara usar subclasses específicas do fornecedor (#3882) (5b0fd2b)Refatorado
amqplibpara usar constantes de message broker (#3879) (77621fb)
Documentação
Tarefas diversas
- Atualizado
@apm-js-collab/tracing-hookspara0.6.0(#3884) (f6ef470) - Testes do Undici atualizados para cobrir a versão 8 (#3896) (f27e75f)
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/)