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

Configuration de l'agent Node.js

Vous pouvez adapter l'agent Node.js aux exigences de votre application en modifiant votre fichier de configuration newrelic.js ou en définissant une variable d'environnement. Le fichier de configuration réside dans le répertoire racine de votre application. Vous pouvez également configurer quelques options depuis New Relic, ou utiliser Node.js API l'agent d' .

Démarrer

Vous pourrez configurer notre agent Node.js en fonction de votre environnement après avoir créé un compte New Relic (c'est gratuit, pour toujours) et installé l'agent Node.js.

Le paramètre license_key est obligatoire. De plus, nous vous recommandons vivement de définir le app_name afin que votre application ait un nom significatif au lieu du My Application par défaut.

Méthodes de configuration et priorité

La principale méthode pour configurer l’agent Node.js est le fichier de configuration de l’agent (newrelic.js). Vous pouvez également configurer la plupart des paramètres avec des variables d'environnement. Vous pouvez également ajuster certains paramètres avec la configuration côté serveur.

L'agent Node.js utilise cet ordre de priorité pour les méthodes de configuration :

Node.js agent configuration precedence

Node.js configuration hierarchy: Les paramètres de configuration côté serveur remplacent les variables d’environnement. Les variables d’environnement remplacent le fichier de configuration de l’agent. Le fichier de configuration remplace les valeurs par défaut de l'agent.

Voici des descriptions détaillées de chaque méthode de configuration :

Exporter des variables

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section exports.config = { du fichier de configuration newrelic.js de votre application.

Variables de logging

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section logging: { du fichier de configuration newrelic.js de votre application.

Monitoring de l'IA

Cette section comprend la Node.js agent configuration pour la mise en place monitoring de l'IA.

Important

Vous devez activer le tracing distribué pour capturer les données AI. Il est activé par défaut dans l'agent Node.js 8.3.0 et supérieur. Si vous avez activé le mode haute sécurité, monitoring de l'IA ne fonctionnera pas.

Important

Lorsque cette option est activée, le monitoring de l'IA enregistrera une copie en continu des entrées et des sorties envoyées vers et depuis les modèles que vous choisissez de monitorer, y compris toutes les informations personnelles qu'ils contiennent. Lorsque vous utilisez la fonctionnalité de monitoring de l'IA, vous êtes responsable d'obtenir le consentement de l'utilisateur de votre modèle pour que son interaction puisse être enregistrée par un tiers (New Relic) dans le but de fournir la fonctionnalité de monitoring de l'IA.

Variables du cloud

Cette section définit les Node.js agent variables pour créer une relation entre les cloud fournisseurs et APM l'application .

Logging d'audit

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section audit_log: { du fichier de configuration newrelic.js de votre application.

API configuration

Cette section vous permet de choisir les méthodes API à activer. Chaque option de configuration vous permet d'activer de manière modulaire les méthodes API responsables de l'envoi d'informations personnalisées à New Relic.

Important

Tous ces paramètres sont définis sur false lorsque l’agent est en mode haute sécurité.

Attributs

Cette section définit les variables des attributs de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la attributes: { section du newrelic.js configuration fichier de votre application.

Prudence

Toutes les règles d'inclusion/exclusion liées à l'en-tête doivent être au format camelCase pour être filtrées.

Variables du collecteur d'erreurs

Vous pouvez gérer la manière dont les erreurs sont traitées dans New Relic. Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section error_collector: { du fichier de configuration newrelic.js de votre application.

Variables de suivi des transactions

L'agent regroupe vos requests en transactions, qui servent à :

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section transaction_tracer: { du fichier de configuration newrelic.js de votre application.

Important

N'utilisez pas de crochets [suffix] à la fin du nom de votre transaction. New Relic supprime automatiquement les crochets du nom. Utilisez plutôt des parenthèses (suffix) ou d’autres symboles si nécessaire.

Variables de règles

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section rules: { du fichier de configuration newrelic.js de votre application.

Variables d'événement de transaction

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section transaction_events: { du fichier de configuration newrelic.js de votre application.

monitoring des variables des navigateurs

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section browser_monitoring: { du fichier de configuration newrelic.js de votre application.

événement personnalisé variable

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section custom_insights_events: { du fichier de configuration newrelic.js de votre application.

requête de variables lentes

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section slow_sql: { du fichier de configuration newrelic.js de votre application. Ces options contrôlent le comportement de la requête lente, mais n'affectent pas les nœuds SQL dans la trace de la transaction.

Variables de nom d'hôte personnalisées

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section process_host: { du fichier de configuration newrelic.js de votre application. Ces options contrôlent le comportement concernant le nom d'affichage de l'hôte dans l'UI APM.

Variables du traceur de datastore

Cette section définit les variables de l'agent Node.js dans l'ordre dans lequel elles apparaissent généralement dans la section datastore_tracer du fichier de configuration newrelic.js de votre application. Ces options contrôlent le comportement de collecte des datastore instance métriques .

Traçage inter-applications (OBSOLÈTE)

Les variables de l'agent Node.js qui contrôlent le traçage inter-applications apparaissent généralement dans la section cross_application_tracer du fichier de configuration newrelic.js de votre application :

Important

Le tracing inter-applicationa été abandonné au profit du tracing distribué et sera supprimé dans une future version agent .

Important

Le tracing inter-application (CAT) est obsolète et sera supprimé dans une future sortie majeure. Pour une visibilité interservices, nous vous recommandons d'utiliser le tracing distribué, qui est activé par défaut à partir de la version 8.3.0 agent . Avant l'activation, lisez le guide de transition.

variables de rédaction du message d'erreur

Les Node.js agent variables qui contrôlent la rédaction du message d'erreur apparaissent dans la strip_exception_messages section du newrelic.js configuration fichier de votre application :

Tracing distribué

Le tracing distribué vous permet de voir le chemin emprunté par une requête lorsqu'elle traverse un système distribué. Lors de la configuration via le fichier de configuration, placez l'option suivante dans la section distributed_tracing . Il est activé par défaut dans l'agent Node.js 8.3.0 et supérieur.

Important

L'activation du tracing distribué désactive le tracing inter-application et a des effets sur d'autres fonctionnalités APM . Avant l'activation, lisez le guide de transition. Nécessite l'agent Node.js version 4.7.0 ou supérieure.

Pour plus d'informations sur la configuration du tracing distribué, consultez Activer le tracing distribué pour votre application Node.js .

gRPC du serveur instrumentation

La section grpc contrôle le comportement de la manière dont le serveur gRPC est instrumenté.

Événements de span

Les données Span sont signalées pour le tracing distribué. Le tracing distribué doit être activé pour signaler les étendues. Définissez la configuration de l'étendue dans la section span_events . Les options incluent :

Infinite Tracing

Pour activer Infinite Tracing, ajoutez les paramètres ci-dessous. Définissez la configuration du Infinite Tracing dans la section infinite_tracing . De plus, le Infinite Tracing doit être activé. Notez que le tracing distribué est activé par défaut pour les Node.js agent APM versions 8.3.0 et supérieures de l' .

Logging des applications

Les application configuration paramètres de logging nécessitent Node.JS agent version 8.11.0 ou supérieure.

Pour obtenir des conseils sur la configuration du log pour l'agent Node.js, consultez Configurer les logs en contexte Node.js.

Métriques au niveau du code

Les paramètres de configuration des métriques au niveau du code nécessitent l'agent Node.JS version 9.7.5 ou supérieure.

Pour plus de détails, consultez notre documentation sur les métriques au niveau du code.

Erreurs configuration de la boîte de réception

La définition de l’une des balises suivantes vous aidera à identifier les versions de votre logiciel qui génèrent les erreurs.

  • NEW_RELIC_METADATA_SERVICE_VERSION créera tag.service.version sur les données d'événement contenant la version de votre code qui est déployée, dans de nombreux cas une version sémantique telle que 1.2.3, mais pas toujours.
  • NEW_RELIC_METADATA_RELEASE_TAG créera tag.releaseTag sur les données d'événement contenant la tag de sortie (comme v0.1.209 ou sortie-209).
  • NEW_RELIC_METADATA_COMMIT créera tag.commit sur les données d'événement contenant le commit sha. Le SHA entier peut être utilisé ou seulement les sept premiers caractères (par exemple, 734713b).

Une prochaine version de la boîte de réception des erreurs suivra automatiquement les versions de votre logiciel qui génèrent des erreurs. Toutes les données de version seront également affichées dans CodeStream.

obfuscationd'URL

Les obfuscation configuration paramètres d'URL Node.js agent nécessitent la version 9.9.0 ou supérieure

Pour un exemple de configuration, consultez notre documentation sur l'obfuscation d'URL de l'agent de nœud.

Agent de sécurité

New Relic sécurité agent interactif de test de sécurité des (IAST) de New Relic Security teste votre application pour détecter toute vulnérabilité exploitable en rejouant la requête HTTP générée avec une charge vulnérable.

Prudence

Exécutez IAST avec une déploiement de non-production uniquement pour éviter d'exposer les vulnérabilités de votre logiciel de production.

Important

Les paramètres de configuration de l'agent de sécurité nécessitent la version 10.3.0 ou supérieure de l'agent Node.js.

Heroku

Fils de discussion des travailleurs

Dans les versions d'agent antérieures à 11.0.0, l'agent s'exécutait à la fois dans les threads principaux et dans les threads de travail. Dans la version 11.0.0, l' agent a cessé de s'exécuter dans les threads de travail en raison de son incompatibilité avec notre propagation asynchrone du contexte. La possibilité d'exécution dans les threads de travail a été restaurée dans la version 11.3.0, mais vous devez définir worker_threads.enabled sur true. Le comportement de l'exécution dans les threads de travail varie et nous ne le prenons pas officiellement en charge. Certaines choses comme la génération de métriques et le suivi autonome des transactions peuvent fonctionner, mais il s'agit d'une capacité que vous utilisez à vos propres risques.

Remplacements de variables d'environnement

Cette section définit deux options de configuration disponibles uniquement avec les variables d'environnement. Ces remplacements ne sont pas utilisés dans la plupart des configurations.

Guide de référence des types de variables d'environnement

Cette section décrit comment formater correctement les types de données complexes.

Droits d'auteur © 2025 New Relic Inc.

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