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/severmigré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.prefixRouteParameterscar 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/cliet@nestjs/corevers10.0.0 - Mise à jour de la version minimale prise en charge de
nextà 14 - Mise à jour de la version minimale prise en charge de
bluebirdvers3.0.0 - Mise à jour de la version minimale prise en charge de
mysql2vers3.0.0 - Mise à jour de la version minimale prise en charge pour
cassandra-driververs4.0.0 - Abandon de la prise en charge de
fastify3.x config.distributed_tracing.exclude_newrelic_headermis à jour pour être défini surtruepar défaut
Caractéristiques
- Fin de la prise en charge de
fastify3.x (#3980) (720979b) - Fin de la prise en charge de Node.js 20 (#3980) (5306223)
- Migration de l'instrumentation
@apollo/severd'un plug-in (@newrelic/apollo-server-plugin) vers une instrumentation traditionnelle (#3980) (736e0a4) - Suppression de
shim.argsToArray(#3980) (9183d29) - Suppression de
shim.prefixRouteParameterscar 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_headermis à jour pour être défini surtruepar défaut (#3980) (774ce08)- Mise à jour de la version minimale prise en charge pour
cassandra-driververs4.0.0(#3980) (419337a) - Mise à jour de la version minimale prise en charge de
@nestjs/cliet@nestjs/corevers10.0.0(#3980) (120e6de) - Mise à jour de la version minimale prise en charge de
bluebirdvers3.0.0(#3980) (369f920) - Mise à jour de la version minimale prise en charge de
mysql2vers3.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.bindFunctionavectracer.runInContextpour améliorer les performances dans les chemins chauds (#3811) (5d77085)
Documentation
Tâches diverses
- Suppression de
huskyau 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
minSupportedau 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-utiltiesvers 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-v3pour utilisergroupedDependencies(#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-releasepour 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-artifactvers 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/functionsen 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
connectpour gérer la restructuration des fichiers dans<3.4.0(#3923) (00b615c) - Mise à jour de
tracer.bindFunctionpour 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-client4.13.0+ (#3965) (5e0fe24)
Refactoring de code
- Suppression de la dépendance à
AsyncLocalStorage.enterWithpour l'instrumentation d'undici, du domaine et deprocess._fatalException(#3894) (612b449)
Documentation
Tâches diverses
- Ajout d'une ligne de log lorsque
max_trace_segmentsest atteint (#3933) (46b9238) - Placer en commentaire
assertSegmentDurationpour le testclient-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
actualTimevssegmentDurationdans les testsmemcached(#3932) (98c50e0) - Mise à jour de
@apm-js-collab/tracing-hooksvers0.7.0(#3949) (5c99cd1)
Tests
- Ajout de l'assertion personnalisée
assertSegmentDurationet ajout àmemcachedtests (#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_processpour éviter la fuite de gestionnaires d'événements abonnés àonce(#3907) (ad0b1f6)
Documentation
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
Tests
- Updated
minAgentVersionfor 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-sdkv3 pour s'abonner aux événements émis- Ajout de l'abonné
@aws-sdk/smithy-client(#3877) (0e350fc) - Ajout de l'abonné
@smithy/smithy-clientsendavec AWS Bedrock Middleware (#3864) (5e0a6d1) - Déplacement du middleware AWS
Clientgénérique vers l'abonné (#3889) (3cb1e1b) - Mise à jour de l'instrumentation
aws-sdk/dynamodbvers 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)
- Ajout de l'abonné
Refactoring de
LlmErrorMessagepour utiliser des sous-classes spécifiques au fournisseur (#3882) (5b0fd2b)Refactoring de
amqplibpour utiliser les constantes du courtier de messages (#3879) (77621fb)
Documentation
Tâches diverses
- Mise à jour de
@apm-js-collab/tracing-hooksvers0.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/)
Notes
Features
Code refactoring
- Refactored
wheninstrumentation to subscribe to events emitted (#3866) (1b55c5a) - Refactored
memcachedinstrumentation to subscribe to events emitted (#3849) (915b320) - Refactored
bluebirdinstrumentation to subscribe to events emitted (#3858) (e3d84c2) - Refactored
qinstrumentation to subscribe to events emitted (#3853) (9fdb0b8) - Refactored
grpc-jsclient instrumentation to subscriber type (#3856) (057fca2) - Refactored
grpc-jsserver instrumentation to subscriber type (#3805) (ca3010a) - Updated
@langchain/coresubscribers to properly instrument the tool class methods (#3850) (2d17eed)
Documentation
Miscellaneous chores
Tests
- Removed unused context manager feature flag for running versioned tests (#3851) (15c9757)
- Updated core tracing cross agent tests (#3860) (08e4570)
- Fixed issue with span links test (#3863) (23a8594)
- Removed segment duration timing threshold in
memcachedtests (#3869) (bd24410)
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/)