Node.js agent release notesRSS

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/sever instrumentation 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.prefixRouteParameters as the logic was previously moved to when a transaction ends
• Removed creating MySQL Pool#query segments
• Removed shim.argsToArray
• Updated minimum supported version of @nestjs/cli and @nestjs/core to 10.0.0
• Updated minimum supported version of next to 14
• Updated minimum supported version of bluebird to 3.0.0
• Updated minimum supported version of mysql2 to 3.0.0
• Updated minimum supported version for cassandra-driver to 4.0.0
• Dropped support for fastify 3.x
• Updated config.distributed_tracing.exclude_newrelic_header to be set to true by default

Features

• Dropped support for fastify 3.x (#3980) (720979b)
• Dropped support for Node.js 20 (#3980) (5306223)
• Migrated @apollo/sever instrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation (#3980) (736e0a4)
• Removed shim.argsToArray (#3980) (9183d29)
• Removed shim.prefixRouteParameters as the logic was previously moved to when a transaction ends (#3980) (9f1408e)
• Removed creating MySQL Pool#query segments (#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_header to be set to true by default (#3980) (774ce08)
• Updated minimum supported version for cassandra-driver to 4.0.0 (#3980) (419337a)
• Updated minimum supported version of @nestjs/cli and @nestjs/core to 10.0.0 (#3980) (120e6de)
• Updated minimum supported version of bluebird to 3.0.0 (#3980) (369f920)
• Updated minimum supported version of mysql2 to 3.0.0 (#3980) (2861406)
• Updated minimum supported version of next to 14 (#3980) (80c5c0c)

Code refactoring

• Updated how exclusive time and trace total time is calculated (#3980) (b227ed6)
• Updated instances of tracer.bindFunction with tracer.runInContext to improve performance in hot paths (#3811) (5d77085)

Documentation

• Updated compatibility report (#3990) (f3bb380)

Miscellaneous chores

• Removed husky in lieu of git hooks, added security hardened options to npm install (#3988) (e3a7dda)
• Updated production dependencies to the latest (#3996) (b710bac)

Tests

• Added minSupported to 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-utilties to 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-v3 test runner to use groupedDependencies (#3984) (fc67490)
• Updated a few versioned test stanzas to reduce the number of combinations it runs (#3991) (d606305)

Continuous integration

• Added contents: write to post-release to 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-artifact to 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/)

Notes

Features

• Added instrumentation for Google ADK BaseAgent.runAsync (#3905) (c6c51d5)
• Instrument Google ADK FunctionTool.runAsync (#3935) (57f9ed7)
• Updated @azure/functions instrumentation to subscriber type (#3915) (227e779)
• Updated how license keys are redacted in logs (#3945) (6289502)

Bug fixes

• Updated connect instrumentation queries to handle file restructure in <3.4.0 (#3923) (00b615c)
• Updated tracer.bindFunction to touch segment if a promise is fulfilled or rejected (#3967) (712db61)
• Updated aws sdk v3 instrumentation to handle using @smithy/smithy-client 4.13.0+ (#3965) (5e0fe24)

Code refactoring

• Removed reliance on AsyncLocalStorage.enterWith for undici, domain and process._fatalException instrumentation (#3894) (612b449)

Documentation

• Updated compatibility report (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

Miscellaneous chores

• Added log line when max_trace_segments is hit (#3933) (46b9238)
• Comment out assertSegmentDuration for client-dynamodb test (#3972) (590cd3e)
• Fix issue with amqplib tests (#3969) (a770000)
• Refactored Connect instrumentation to subscriber type (#3912) (e5d87b7)
• Refactored kafkajs instrumentation to subscriber type (#3958) (72e383c)
• Remove actualTime vs segmentDuration assertion in memcached tests (#3932) (98c50e0)
• Updated @apm-js-collab/tracing-hooks to 0.7.0 (#3949) (5c99cd1)

Tests

• Added assertSegmentDuration custom assertion and added it to memcached tests (#3875) (b28d866)

Continuous integration

• Applied least-privilege model to all workflows to appease CodeQL (#3961) (237d5b9)

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

Remarques

Débogage

• Correction de l'instrumentation child_process pour éviter la fuite de gestionnaires d'événements abonnés à once (#3907) (ad0b1f6)

Documentation

• Rapport de compatibilité mis à jour (#3897) (0ed2202)

Déclaration de soutien :

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

Consultez la politique EOL de l'agent New Relic Node.js pour obtenir des informations sur la sortie de l'agent et les dates de support. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Fixed detecting AWS SDK message attributes presence (#3903) (e81dc61)

Tests

• Updated minAgentVersion for Anthropic versioned tests (#3900) (e1f6c32)
• Reorganized the test utilities in AWS versioned tests (#3895) (3025571)

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

Remarques

Caractéristiques

• Ajout de la prise en charge de l'instrumentation pour @anthropic-ai/sdk (#3881) (e8713bb)
• Mise à jour des attributs de base de données OTel vers des noms stables issus des conventions sémantiques 1.40.0 (#3826) (6d3000d)
• Ajout de la propagation du tracing distribué à SNS (#3893) (8fc1144)

Refactoring de code

• Refactoriser l'instrumentation @aws-sdk v3 pour s'abonner aux événements émis

  • Ajout de l'abonné @aws-sdk/smithy-client (#3877) (0e350fc)
  • Ajout de l'abonné @smithy/smithy-client send avec AWS Bedrock Middleware (#3864) (5e0a6d1)
  • Déplacement du middleware AWS Client générique vers l'abonné (#3889) (3cb1e1b)
  • Mise à jour de l'instrumentation aws-sdk/dynamodb vers un middleware d'abonné (#3891) (ff677a2)
  • Instrumentation aws sdk v3 mise à jour pour séparer les utilitaires bedrock du véritable middleware encapsulé (#3883) (eed340e)
  • Mise à jour de l'instrumentation Lambda vers un middleware d'abonné (#3890) (12f8284)
  • Refactoring de l'instrumentation SNS vers le type abonné (#3876) (b9f3326)
  • Refactoring de l'instrumentation SQS vers le type abonné (#3880) (de46dee)

• Refactoring de LlmErrorMessage pour utiliser des sous-classes spécifiques au fournisseur (#3882) (5b0fd2b)

• Refactoring de amqplib pour utiliser les constantes du courtier de messages (#3879) (77621fb)

Documentation

• Rapport de compatibilité mis à jour (#3874) (ae887c4)

Tâches diverses

• Mise à jour de @apm-js-collab/tracing-hooks vers 0.6.0 (#3884) (f6ef470)
• Mise à jour des tests Undici pour couvrir la version 8 (#3896) (f27e75f)

Déclaration de soutien :

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

Consultez la politique EOL de l'agent New Relic Node.js pour obtenir des informations sur la sortie de l'agent et les dates de support. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Remarques

Caractéristiques

• Instrumentation du flux de serveur grpc pour lier le contexte asynchrone aux gestionnaires d'événements de flux (#3855) (92c70a8)

Refactoring de code

• Refactorisation de l'instrumentation when pour s'abonner aux événements émis (#3866) (1b55c5a)
• Refactorisation de l'instrumentation memcached pour s'abonner aux événements émis (#3849) (915b320)
• Refactorisation de l'instrumentation bluebird pour s'abonner aux événements émis (#3858) (e3d84c2)
• Refactorisation de l'instrumentation q pour s'abonner aux événements émis (#3853) (9fdb0b8)
• Refactorisation de l'instrumentation du client grpc-js vers le type abonné (#3856) (057fca2)
• Refactorisation de l'instrumentation du serveur grpc-js en type abonné (#3805) (ca3010a)
• Mise à jour des abonnés @langchain/core pour instrumenter correctement les méthodes de la classe d'outils (#3850) (2d17eed)

Documentation

• Rapport de compatibilité mis à jour (#3831) (9156a6a)

Tâches diverses

• Ajout des packages d'abonnés à load-externals (#3868) (83adcc4)

Tests

• Suppression de l'indicateur de fonctionnalité inutilisé du gestionnaire de contexte pour l'exécution des tests versionnés (#3851) (15c9757)
• Mise à jour des tests inter-agents de tracing de base (#3860) (08e4570)
• Correction d'un problème avec le test des liens de span (#3863) (23a8594)
• Suppression du seuil de chronométrage de la durée du segment dans les tests memcached (#3869) (bd24410)

Déclaration de soutien :

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

Consultez la politique EOL de l'agent New Relic Node.js pour obtenir des informations sur la sortie de l'agent et les dates de support. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)