• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Mettre à jour l'agent Node.js

Pour profiter pleinement des New Relic dernières fonctionnalités, améliorations et correctifs de sécurité importants de, nous vous recommandons de mettre à jour Node.js agent votre vers la dernière version. Pour plus agent d'informations sur les mises à jour spécifiques, reportez-vous aux Node.js agent notes de sortie Les notes de sortie incluent un lien de téléchargement, le cas échéant, ainsi que des instructions pour télécharger et installer la dernière version.

  • Si le module newrelic est répertorié dans votre package.json, exécutez npm install.
  • Si vous souhaitez cibler uniquement le module newrelic, exécutez npm update newrelic.

Recommandation : testez votre version mise à jour avant de la mettre en production. Si vous rencontrez des problèmes, suivez les procédures de dépannage de l'agent Node.js.

Mise à niveau vers la version 11 de l'agent Node.js

Avant de passer à la version 11 de Node.js, consultez ces informations pour connaître les modifications majeures.

Major changes with Node.js agent v11

Comments

Ajout du support de parité officiel pour Node.js 20.

BREAKING:Suppression du support de Node.js 14.

BREAKING: Chargeur ESM mis à jour pour prendre en charge Node.js 20.

  • Vous devez désormais utiliser les arguments --experimental-loader et -r lors de l'exécution d'une application.
  • node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js

BREAKING: Mise à jour du gestionnaire de contexte par défaut pour qu'il soit AsyncLocalContextManager.

BREAKING:Renommé shim.handleCATHeaders en shim.handleMqTracingHeaders.

Mise à jour de la dépendance New Relic vers les versions avec prise en charge de la version Node.js mise à jour

  • @newrelic/AWS-sdk v7.0.0
  • @newrelic/koa v8.0.0
  • @newrelic/native-métriques v10.0.0
  • @newrelic/superagent v7.0.0
  • @newrelic/test-utilities v8.0.0

Prise en charge des versions de Node.js

Node.js 16 est la première version prise en charge par l'agent New Relic Node.js v11. Node.js 14 et 15 ne sont pas pris en charge par la v11. Les clients exécutant Node.js 15 et versions antérieures ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v11.
  • Restez sur New Relic Node.js v10 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Conseil

Passez à une version plus récente de Node.js dès que possible. La prochaine version majeure de l'agent New Relic Node.js supprimera probablement la prise en charge de Node.js 16.

Mise à niveau vers la version 10 de l'agent Node.js

Avant de passer à la version 10 de Node.js, consultez ces informations pour connaître les modifications majeures.

Major changes with Node.js agent v11

Comments

  • Ajout de la possibilité d'enregistrer plusieurs hooks d'instrumentation (onRequire, onResolved) pour le même moduleName résolu.
  • Cela a été une limitation de l’agent depuis le début.
  • Si vous avez utilisé l' API pour instrumenter api.instrument, api.instrumentDatastore, api.instrumentWebframework, api.instrumentMessages, ou api.instrumentConglomerate, elle remplacerait les hooks d'instrumentation existants.
  • Le résultat était que l’agent Node.js ne fonctionnait pas comme prévu.

BREAKING: Mise à jour de la valeur par défaut de config.transaction_tracer.record_sql de désactivé à obscurci. Cela signifie que les instructions SQL seront capturées mais obscurcies.

BREAKING: Les paramètres de route (URL) sont désormais stockés en tant qu'attribut request.parameters.route.* sur les transactions, les segments racine et les étendues.

  • Le paramètre requête sera disponible sous forme d'attribut préfixé par request.parameters.* sur les transactions et les portées.
  • Le paramètre de route sera disponible sous forme d'attribut préfixé par request.parameters.route.* sur les transactions et les portées.
  • Les paramètres de route (alias paramètre d'url) sont une fonctionnalité commune de divers frameworks Web, où vous pouvez créer un espace réservé dans le cadre d'une définition de route API.

BREAKING:Suppression de captureUrlParams de la classe WebFrameworkShim.

DEPRECATION NOTICE: shim.unwrap et shim.unwrapOnce ne fonctionneront plus si vous essayez de déballer un élément qui a été emballé plusieurs fois.

  • C'est parce que, puisque nous autorisons désormais l'instrumentation du même module plus d'une fois, vous ne pouvez pas le déballer en toute sécurité sans casser toute instrumentation enregistrée. Nous prévoyons de supprimer shim.unwrap et shim.unwrapOnce lors de la prochaine sortie majeure.

Mise à jour de la dépendance New Relic vers les versions avec prise en charge de la version Node.js mise à jour

  • @newrelic/AWS-sdk v7.0.0
  • @newrelic/koa v8.0.0
  • @newrelic/native-métriques v10.0.0
  • @newrelic/superagent v7.0.0
  • @newrelic/test-utilities v8.0.0

Prise en charge des versions de Node.js

Node.js 14 est la première version prise en charge par l'agent New Relic Node.js v10. Node.js 12 et 13 ne sont pas pris en charge par la v10. Les clients exécutant Node.js 13 et versions antérieures ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v10.
  • Restez sur New Relic Node.js v8 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Conseil

Passez à une version plus récente de Node.js dès que possible. La prochaine version majeure de l'agent New Relic Node.js supprimera probablement la prise en charge de Node.js 14.

Mise à niveau vers la version 9 de l'agent Node.js

Avant de passer à la version 9 de Node.js, consultez ces informations pour connaître les modifications majeures.

Major changes with Node.js agent v9

Comments

Ajout du support de parité officiel pour Node.js 18.

BREAKING:Suppression du support de Node.js 12.

BREAKING:L'agent n'inclut plus automatiquement le bundle de certificats New Relic lors de l'utilisation de la configuration « certificats » (généralement avec les proxys).

  • L'agent n'inclut plus le bundle de certificats New Relic lors de l'utilisation de la configuration « certificats » (généralement avec les proxys). Si vous trouvez que cela perturbe votre environnement actuel, nous vous recommandons d'obtenir un bundle CA tel que celui de Mozilla.

BREAKING:L'agent exclut désormais le port lors des requests HTTPS externes sur le port 443 pour être conforme à la spécification et aux autres agents

  • Les segments externes précédents seraient nommés External/example.com:443 lors de l'utilisation du port HTTPS par défaut.
  • Le segment externe sera désormais nommé External/example.com.

BREAKING: Suppression de la possibilité de désactiver le suivi du contexte de promesse basé sur les hooks asynchrones via l'indicateur de fonctionnalité await_support . Cela supprime également l'legacy Promise instrumentation.

  • Sortez l'indicateur de fonctionnalité await_support . L'agent s'appuie désormais sur async_hooks pour suivre la propagation des promesses asynchrones. Le résultat net est que si vous aviez feature_flag.await_support défini sur false, l'legacy instrumentation suivait chaque fonction dans une chaîne de promesse en tant que segment distinct.

BREAKING:Suppression de l'instrumentation pour le package npm Oracle obsolète.

BREAKING: Mise à jour de la version minimale de pg à 8.2.x. Il s'agit de la première version de support qui s'exécute sur Node.js 14+.

BREAKING: Mise à jour de la version minimale prise en charge de hapi pour être v20.0.0.

  • Toutes les versions inférieures à v20.0.0 sont obsolètes par hapi pour des raisons de sécurité. Voir leur politique de support.

Mise à jour de la dépendance New Relic vers les versions avec prise en charge de la version Node.js mise à jour

  • @newrelic/AWS-sdk v5.0.0
  • @newrelic/koa v7.0.0
  • @newrelic/native-métriques v9.0.0
  • @newrelic/superagent v6.0.0
  • @newrelic/test-utilities v7.0.0

Prise en charge des versions de Node.js

Node.js 14 est la première version prise en charge par l'agent New Relic Node.js v9. Node.js 12 et 13 ne sont pas pris en charge par la v9. Les clients exécutant Node.js 13 et versions antérieures ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v9.
  • Restez sur New Relic Node.js v8 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Conseil

Passez à une version plus récente de Node.js dès que possible. La prochaine version majeure de l'agent New Relic Node.js supprimera probablement la prise en charge de Node.js 14.

Mise à niveau vers la version 8 de l'agent Node.js

Avant de passer à la version 8 de Node.js, consultez ces informations pour connaître les modifications majeures.

Major changes with Node.js agent v8

Comments

Ajout du support de parité officiel pour Node.js 16.

BREAKING:Suppression du support de Node.js v10.x.

BREAKING: serverless_mode a été supprimé en tant qu'indicateur de fonctionnalité.

  • La configuration standard serverless_mode existe toujours.

BREAKING:L'agent n'inclut plus automatiquement le bundle de certificats New Relic lors de l'utilisation de la configuration « certificats » (généralement avec les proxys).

  • Si vous constatez que cela perturbe votre environnement actuel, vous pouvez utiliser un indicateur de fonctionnalité pour restaurer temporairement cette fonctionnalité. Exemple de configuration : feature_flag: { certificate_bundle: true }. Dans ce cas, nous vous recommandons d'obtenir un ensemble de certificats pour votre environnement, tel que celui de Mozilla. Le pack New Relic et le drapeau de fonctionnalité seront entièrement supprimés lors de la prochaine sortie majeure.
  • Defaulted config.feature_flags.certificate_bundle à false.

Mise à jour de la dépendance New Relic vers les versions avec prise en charge de la version Node.js mise à jour

  • @newrelic/AWS-sdk v4.0.1
  • @newrelic/koa v6.0.1
  • @newrelic/native-métriques v7.0.1
  • @newrelic/superagent v5.0.1
  • @newrelic/test-utilities v6.0.0

Prise en charge des versions de Node.js

Node.js v12 est la première version prise en charge par l'agent New Relic Node.js v8. Node.js 10 et 11 ne sont pas pris en charge par la v8. Les clients exécutant Node.js 11 et versions antérieures ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v8.
  • Restez sur New Relic Node.js v7 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Conseil

Passez à une version plus récente de Node.js dès que possible. La prochaine version majeure de l'agent New Relic Node.js supprimera probablement la prise en charge de Node.js 12.

Mise à niveau vers la version 7 de l'agent Node.js

Avant de passer à la version 7 de Node.js, consultez ces informations pour connaître les modifications majeures.

Major changes with Node.js agent v7

Comments

BREAKING Suppression des attributs de réponse http obsolètes httpResponseCode, response.status et httpResponseMessage

  • v6.4.2-v6.14.0: À partir de agent v6.4.2, ces attributs ont été marqués comme obsolètes mais conservés pour donner une période de transition pour le nouvel attribut.
  • v7: Lorsque le rapport d'attribut de réponse http est activé, http.statusCode et http.statusText seront signalés.

BREAKING Méthode d'API obsolète setIgnoreTransaction supprimée

  • v5 - v6: À partir de l'agent v5.0.0, cette méthode a été marquée comme obsolète mais conservée pour donner une période de transition pour les nouvelles méthodes.
  • v7: l'application doit utiliser la méthode API transactionHandle.ignore().

BREAKING Suppression de l'élément de configuration api.custom_parameters_enabled et de la variable d'environnement associée NEW_RELIC_API_CUSTOM_PARAMETERS.

BREAKING Suppression des méthodes obsolètes de tracing distribué d'API, createDistributedTracePayload() et acceptDistributedTracePayload()

Mise à jour de la dépendance New Relic vers les versions avec prise en charge de la version Node.js mise à jour

  • @newrelic/AWS-sdk v3.0.0
  • @newrelic/koa v5.0.0
  • @newrelic/native-métriques v6.0.0
  • @newrelic/superagent v4.0.0
  • @newrelic/test-utilities v5.0.0

Prise en charge des versions de Node.js

Node.js v10 est la première version prise en charge par l'agent New Relic Node.js v7. Node.js 8 et 9 ne sont pas pris en charge par la v7. Les clients exécutant Node.js 9 et versions antérieures ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v7.
  • Restez sur New Relic Node.js v6 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Node.js 10 ne reçoit pas de mises à jour. Passez à une version plus récente de Node.js dès que possible. La prise en charge de Node.js 10 a été interrompue avec l'agent New Relic Node.js v8.

Mise à niveau vers la version 6 de l'agent Node.js

Avant de procéder à la mise à niveau vers la version 6 de l'agent Node.js, consultez ces informations pour connaître les modifications majeures.

Major changes with Node.js agent v6

Comments

Mise à niveau du module d'instrumentation officiel du framework Koa vers la version 3.0.0

  • v6: Prise en charge ajoutée pour @koa/router jusqu'à la version 8.0.2. @koa/router v8.0.3 et supérieur ne sont actuellement pas pris en charge.
  • v6: Prise en charge ajoutée pour Node.js v12 et suppression de la prise en charge pour Node.js v6, 7 et 9. La version minimale prise en charge est Node.js v8.
  • Voir également les notes de sortie de Koa de New Relic sur Github..

Paramètre configuration obsolète max_samples_per_minute supprimé, qui est remplacé par le comportement max_samples_stored

  • v1 - v5: max_samples_per_minute défini le nombre maximum d'événements que l' agent collecte par minute. Si votre application utilisait auparavant max_samples_per_minute comme limite supérieure, vous devrez peut-être abaisser le seuil à un maximum valide pour éviter que des données ne soient supprimées sur le serveur. Nous recommandons moins de 10 000.
  • v5: Dans agent v5 et les versions antérieures, max_samples_stored définissait le nombre maximal d'événements que l' agent stocke s'il ne parvient pas à communiquer avec le collecteurNew Relic .
  • v6: Le nouveau comportement de max_samples_stored définit le nombre maximal d'événements que l' agent collecte par minute. S'il y en a plus que ce nombre, l'agent collecte un échantillon statistique. Cette utilisation de la configuration est cohérente avec l'autre agent APM.
  • Troubleshooting tips: Si des données d'événement manquent, augmentez la valeur de max_samples_stored ou revenez à la valeur par défaut. La valeur de max_samples_stored ne doit pas dépasser 10 000.

Prise en charge des versions de Node.js

Node.js 8 est la première version prise en charge par l'agent New Relic Node.js v6. Node.js 6, 7 et 9 ne sont pas pris en charge par la v6. Les clients exécutant Node.js 6, 7 et 9 ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v6.
  • Restez sur New Relic Node.js v5 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Node.js 8 ne reçoit plus de mises à jour, mais New Relic continuera à prendre en charge ces versions de Node.js pour le moment.

Conseil

Passez à une version plus récente de Node.js dès que possible. La prochaine version majeure de l'agent New Relic Node.js supprimera probablement la prise en charge de Node.js 8.

Mise à niveau vers la version 5 de l'agent Node.js

Avant de procéder à la mise à niveau vers l’agent Node.js v5, consultez ces informations pour connaître les modifications majeures. Consultez également le guide de migration Node.js v5 de New Relic sur GitHub.

Major changes with Node.js v5 agent

Comments

Suppression des méthodes addCustomParameter obsolètes.

  • v2 - v4: À partir de l'agent v2.7.0, ces méthodes ont été marquées comme obsolètes mais conservées pour donner une période de transition pour les nouvelles méthodes.
  • v5: l'application doit utiliser les méthodes API newrelic.addCustomAttribute() et newrelic.addCustomAttributes(). Il s’agit de remplacements immédiats des anciennes méthodes.

Suppression des méthodes create*Transaction obsolètes.

Suppression de la méthode createTracer obsolète.

  • v3 - v4: À partir de l'agent v3.3.0, cette méthode a été marquée comme obsolète au profit de newrelic.startSegment().
  • v5: l'application doit être mise à jour vers newrelic.startSegment().

Suppression de l'instrumentation node-cassandra-cql .

  • v4: l'application utilisant le package npm node-cassandra-cql obtiendrait les métriques datastore pour Cassandra.
  • v5: l'application doit migrer vers le cassandra-driver package pour obtenir les datastore métriques Cassandra. Ce module est activement maintenu par les mêmes développeurs. Le package node-cassandra-cql a été abandonné en février 2014 au profit du package cassandra-driver .

Suppression des configurations obsolètes capture_params et ignored_params .

  • v2 - v4: À partir de agent v2.7.0, ces paramètres configuration ont provoqué l'enregistrement d'un avertissement et les valeurs ont été automatiquement mises à niveau vers la nouvelle configuration d'attribut.
  • v5: Un avertissement sera toujours enregistré, mais la configuration sera ignorée et aucune mise à niveau automatique ne se produira plus.
  • Troubleshooting tips: Si votre application avait des paramètres répertoriés dans la configuration ignored_params, vous devrez les déplacer vers attributes.exclude.

Prise en charge des versions de Node.js

Node.js 6 est la première version prise en charge par l'agent New Relic Node.js v5. Node.js 4 et 5 ne sont pas pris en charge par la v5. Les clients exécutant Node.js 4 ou 5 ont deux options :

  • Passez à une version prise Node.js en charge de et profitez de la New Relic Node.js agentnouvelle fonctionnalité de v5.
  • Restez sur New Relic Node.js v4 agent sans la possibilité d'utiliser la nouvelle fonctionnalité disponible uniquement avec les versions de mise agent à jour.

Node.js 7 et 9 ne reçoivent plus de mises à jour, mais New Relic continuera à prendre en charge ces versions de Node.js pour le moment.

Conseil

Passez à une version plus récente de Node.js dès que possible. La prochaine version majeure de l'agent New Relic Node.js supprimera probablement la prise en charge de Node.js 6 et 7.

drapeaux de fonctionnalités à partir de la v5

À partir de New Relic pour Node.js v5 :

  • custom_instrumentation:Cette fonctionnalité n'est plus configurable.
  • custom_metrics:Cette fonctionnalité n'est plus configurable.
  • synthetics:Cette fonctionnalité n'est plus configurable.
  • native_metrics:Cette fonctionnalité est désormais contrôlée par la valeur de configuration plugins.native_metrics.enabled .

Mise à niveau vers la version 4 de l'agent Node.js

Avant de procéder à la mise à niveau vers l'agent Node.js v4, consultez ces informations pour connaître les modifications majeures. Consultez également le guide de migration Node.js v4 de New Relic sur GitHub.

Mise à niveau vers la version 3 de l'agent Node.js

Avant de procéder à la mise à niveau vers l'agent Node.js agent v3, consultez ces informations pour connaître les modifications majeures. Consultez également le guide de migration Node.js v3 de New Relic sur GitHub.

Mise à niveau vers la version 2 de l'agent Node.js

Avant de procéder à la mise à niveau vers l'agent Node.js v2, consultez ces informations pour connaître les modifications majeures. Consultez également le guide de migration Node.js v2 de New Relic sur GitHub.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.