Node.js agent release notesRSS

Notes

Bug fixes

• Updated winston instrumenting to assign handleExceptions to the first NrTransport to avoid registering duplicate uncaughtException handlers (#4108) (d60a48d)
  • This would create a linear memory leak because the NrTransport objects for loggers no longer in use, would not be freed because of the global process.on('uncaughtException') handler

Documentation

• Updated compatibility report (#4099) (058fde6)

Continuous integration

• Pinned CI npm to 11 so native versioned suites build on Node 22 (#4114) (b844e94)
• Removed the 8 minute versioned shard timeout (#4111) (0ef6374)
• Attempted to fix memcached CI issue again (#4098) (f67fef5)
• Shard versioned tests across CI runners (#4101) (1471734)

Tests

• Added samples to prisma and next to cut down on versions under test on packages we recommend using hybrid ageninstrumentation (#4112) (7d8bd7c)
• Resolved grpc proto-loader from the running suite's node_modules (#4110) (5b5a9f8)

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 Node.js 26 support (#4084) (4a7f777)
• Added span_id and trace_id labels to CpuProfiler sample data (#4049) (c2b1737)
• Added new GCP Cloud Run hostname logic to include K_REVISION (#4069) (02855dc)
• Added profiling.source_mapping.enabled config option (#4090) (43add80)
• Removed spanId in outgoing tracestate header (#4091) (40a8bf1)

Code refactoring

• Refactored mongodb instrumentation to subscribe to events emitted (#4059) (d2777ba)

Documentation

• Updated compatibility report (#4078) (047a063)

Miscellaneous chores

• Addressed long standing CI flakes (#4093) (ae973a0)
• Fixed package version resolution on Node 26 (#4094) (73d14a9)

Continuous integration

• Updated release-creation to use lts/* for node-version (#4080) (7eaed22)
• Updated setup-node job to include check-latest to ensure we are getting the latest version of node (#4079) (4a425f6)

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

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.

Remarques

Documentation

• Suppression de la documentation Next.js obsolète dans le référentiel (repository) (#4060) (185bb66)
• Rapport de compatibilité mis à jour (#4047) (25cbd38)

Tâches diverses

• Ajout de la prise en charge de la configuration du proxy pour les métriques OTEL (#4041) (6c04b8a)
• Ajout de métriques de supportabilité à l’exportation de métriques OTEL (#4051) (db6e4e3)
• Mise à jour de la version minimale des packages @opentelemetry 0.x vers ^0.219.0 (#4065) (3f58ad0)

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 la prise en charge de l’instrumentation OTEL native de Next.js via l’agent hybride (#4040) (1944f39)

Débogage

• Mise à jour de l'analyseur d'étiquettes pour gérer les valeurs vides dans une clé d'objet (#4004) (73c00d7)

Refactoring de code

• Migrer @hapi/hapi et @hapi/vision vers un modèle basé sur les abonnés (#3995) (54c60a8)
• Refactorisation de l'instrumentation koa pour s'abonner aux événements émis (#4016) (e1f6c27)
• Mise à jour de MiddlewareWrapper maybeHandleError pour marquer l’erreur comme traitée uniquement s’il y avait une erreur précédemment stockée (#4032) (1b21cc8)

Documentation

• Suppression du lien vers @newrelic/apollo-server-plugin car l’instrumentation a été fusionnée dans l’agent (#4003) (9afd9cb)
• Déplacement des documents apollo-server vers le site Web de documentation (#3994) (11ca2ae)
• Mise à jour du rapport de compatibilité (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

Tâches diverses

• Déprécier l'API instrumentLoadedModule (#4034) (306ff86)

• Ajout du logging d’audit pour les métriques OTEL (#4018) (494c836)

• Ajout de la règle OTEL pour prendre en charge Prisma 7 (#4013) (c142c60)

• Correction de l'ordre des règles OTEL (#4025) (150476a)

• Refactoring des règles de transformation OTEL (#3999) (48ff739)

• Correction de node-version dans le workflow CI (#4042) (dd05ea9)

• Mise à jour de l’action codecov (#4039) (31b9c84)

• Mise à jour de remote-method pour utiliser la méthode audit de l’enregistreur (#4038) (0e4507e)

• Ajout d’instructions de base de référence pour le bot Claude (#4036) (c8f6649)

• Dépendances mises à jour

  • Suppression des dépendances de développement inutilisées (#4005) (e00f7d3)
  • Mise à jour de @apm-js-collab/tracing-hooks vers 0.9.1 (#4043) (f05e5d4)
  • Mise à jour de commander vers la dernière version (#4021) (83b1d58)
  • Mise à jour de nock vers la dernière version (#4022) (9bf79ab)
  • Mise à jour de sinon vers la dernière version (#4020) (0ced304)
  • Mise à jour de protobufjs vers la dernière version (#4006) (45c61f3)
  • Mise à niveau de glob vers 13 (#4008) (3053545)
  • Mise à niveau de got et rimraf vers la dernière version (#4007) (b967593)

Tests

• Ajouter un shim http.request stable pour que la configuration de l'agent de test AWS fonctionne avec smithy >=4.7.3 (#4010) (c5fd80a)
• Ajout d'un test versionné undici pour vérifier le comportement en utilisant un certificat auto-signé et undici.Agent (#4026) (27507bc)
• Refactoring des tests mongodb-esm pour tester >=4.1.4 (#4023) (d85767f)
• Suppression de la dépendance à glob au profit de fs.glob (#4019) (204f124)
• Mise à jour du test versionné undici.Agent pour ignorer l'utilisation du dispatcher personnalisé sur les versions <5.2.0 car il n'était pas pris en charge (#4029) (08cd079)

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

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