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

Remarques

⚠ CHANGEMENTS CRITIQUES

Cette version de l'agent Node.js est une mise à jour majeure de SemVer et contient les modifications radicales suivantes. Les versions MAJEURES peuvent abandonner la prise en charge des environnements d'exécution de langage qui ont atteint la fin de vie selon le mainteneur. De plus, les versions MAJOR peuvent abandonner la prise en charge et supprimer certaines instrumentations. Pour plus de détails sur ces changements, veuillez consulter le guide de migration.

• Abandon de la prise en charge de Node.js 20
• Instrumentation @apollo/sever migrée d'un plug-in (@newrelic/apollo-server-plugin) vers une instrumentation traditionnelle
• Suppression de la fonctionnalité de tracing inter-applications (CAT)
• Suppression de la prise en charge des politiques de licence, d'application et de sécurité (LASP)
• Suppression de l'instrumentation pour koa-route
• Suppression de l'instrumentation pour koa-router
• Suppression de shim.prefixRouteParameters car la logique a été précédemment déplacée au moment où une transaction se termine
• Suppression de la création de segments MySQL Pool#query
• Supprimé shim.argsToArray
• Mise à jour de la version minimale prise en charge de @nestjs/cli et @nestjs/core vers 10.0.0
• Mise à jour de la version minimale prise en charge de next à 14
• Mise à jour de la version minimale prise en charge de bluebird vers 3.0.0
• Mise à jour de la version minimale prise en charge de mysql2 vers 3.0.0
• Mise à jour de la version minimale prise en charge pour cassandra-driver vers 4.0.0
• Abandon de la prise en charge de fastify 3.x
• config.distributed_tracing.exclude_newrelic_header mis à jour pour être défini sur true par défaut

Caractéristiques

• Fin de la prise en charge de fastify 3.x (#3980) (720979b)
• Fin de la prise en charge de Node.js 20 (#3980) (5306223)
• Migration de l'instrumentation @apollo/sever d'un plug-in (@newrelic/apollo-server-plugin) vers une instrumentation traditionnelle (#3980) (736e0a4)
• Suppression de shim.argsToArray (#3980) (9183d29)
• Suppression de shim.prefixRouteParameters car la logique a été précédemment déplacée au moment où une transaction se termine (#3980) (9f1408e)
• Suppression de la création de segments MySQL Pool#query (#3980) (1d5a6dd)
• Suppression de la fonctionnalité de tracing inter-applications (CAT) (#3980) (a87ed4d)
• Suppression de l’instrumentation pour koa-route (#3980) (40c10d9)
• Suppression de l'instrumentation pour koa-router (#3980) (038ecc7)
• Suppression de la prise en charge des politiques de licence, d'application et de sécurité (LASP) (#3980) (bc09485)
• config.distributed_tracing.exclude_newrelic_header mis à jour pour être défini sur true par défaut (#3980) (774ce08)
• Mise à jour de la version minimale prise en charge pour cassandra-driver vers 4.0.0 (#3980) (419337a)
• Mise à jour de la version minimale prise en charge de @nestjs/cli et @nestjs/core vers 10.0.0 (#3980) (120e6de)
• Mise à jour de la version minimale prise en charge de bluebird vers 3.0.0 (#3980) (369f920)
• Mise à jour de la version minimale prise en charge de mysql2 vers 3.0.0 (#3980) (2861406)
• Mise à jour de la version minimale prise en charge de next à 14 (#3980) (80c5c0c)

Refactoring de code

• Mise à jour de la façon dont le temps exclusif et le temps total de trace sont calculés (#3980) (b227ed6)
• Mise à jour des instances de tracer.bindFunction avec tracer.runInContext pour améliorer les performances dans les chemins chauds (#3811) (5d77085)

Documentation

• Rapport de compatibilité mis à jour (#3990) (f3bb380)

Tâches diverses

• Suppression de husky au profit des hooks git, ajout d'options de sécurité renforcées à npm install (#3988) (e3a7dda)
• Mise à jour des dépendances de production vers la dernière version (#3996) (b710bac)

Tests

• Ajout de minSupported au package.json des tests versionnés nest js pour s'assurer que le rapport de compatibilité indique que nous prenons en charge @nestjs/core (#3982) (bfa4aa1)
• Ajout de tests prisma 7 (#3980) (116ee9c)
• Déplacement du code du test runner versionné de @newrelic/test-utilties vers l'agent (#3980) (d4f9a0c)
• Suppression de @newrelic/test-utilities (#3980) (1751147)
• Diminuer la taille de l’échantillon des tests esm de type smoke (#3986) (40669fb)
• Correction de test/lib/get-package-version.js (#3993) (5d31f08)
• Correction du problème de recherche de version dans les tests aws-sdk-v3 (#3992) (7be3f4a)
• Restructurer l’exécuteur de tests aws-sdk-v3 pour utiliser groupedDependencies (#3984) (fc67490)
• Mise à jour de quelques blocs de test versionnés pour réduire le nombre de combinaisons exécutées (#3991) (d606305)

L'intégration continue

• Ajout de contents: write à post-release pour permettre le commit/push de la documentation de l’API (#3978) (90c4e61)
• Mise à jour des actions restantes pour qu'elles s'exécutent sur Node 24 (#3980) (ea21934)
• Mise à jour de la version de actions/download-artifact vers la v8 (#3980) (54a58b9)
• Versions des actions mises à jour pour s'assurer qu'elles s'exécutent sur node 24 (#3980) (6302002)

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

• Ajout de l’instrumentation pour Google ADK BaseAgent.runAsync (#3905) (c6c51d5)
• Instrumenter Google ADK FunctionTool.runAsync (#3935) (57f9ed7)
• Mise à jour de l'instrumentation @azure/functions en type abonné (#3915) (227e779)
• Mise à jour de la façon dont les clés de licence sont masquées dans les logs (#3945) (6289502)

Débogage

• Mise à jour des requêtes d’instrumentation connect pour gérer la restructuration des fichiers dans <3.4.0 (#3923) (00b615c)
• Mise à jour de tracer.bindFunction pour toucher le segment si une promesse est résolue ou rejetée (#3967) (712db61)
• Mise à jour de l'instrumentation aws sdk v3 pour prendre en charge l'utilisation de @smithy/smithy-client 4.13.0+ (#3965) (5e0fe24)

Refactoring de code

• Suppression de la dépendance à AsyncLocalStorage.enterWith pour l'instrumentation d'undici, du domaine et de process._fatalException (#3894) (612b449)

Documentation

• Rapport de compatibilité mis à jour (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

Tâches diverses

• Ajout d'une ligne de log lorsque max_trace_segments est atteint (#3933) (46b9238)
• Placer en commentaire assertSegmentDuration pour le test client-dynamodb (#3972) (590cd3e)
• Correction d'un problème avec les tests amqplib (#3969) (a770000)
• Refactoring de l'instrumentation Connect vers le type abonné (#3912) (e5d87b7)
• Refactoring de l'instrumentation kafkajs vers le type abonné (#3958) (72e383c)
• Supprimer l'assertion actualTime vs segmentDuration dans les tests memcached (#3932) (98c50e0)
• Mise à jour de @apm-js-collab/tracing-hooks vers 0.7.0 (#3949) (5c99cd1)

Tests

• Ajout de l'assertion personnalisée assertSegmentDuration et ajout à memcached tests (#3875) (b28d866)

L'intégration continue

• Application du modèle de moindre privilège à tous les workflows pour satisfaire CodeQL (#3961) (237d5b9)

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

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