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.
Ce document décrit les attributs de l'agent Node.js de New Relic, détaille comment activer ou désactiver l'attribut et décrit les règles que l'suit agent pour déterminer quel attribut inclure ou exclure pour une destination.
Conseil
Ces paramètres d’attribut s’appliquent à l’agent Node.js version 2.7.1 ou supérieure. Si vous utilisez une ancienne version de l'agent, consultez legacy Mettre à jour des configuration attributs .
Vous pouvez personnaliser exactement quel attribut sera envoyé à chacune de ces destinations.
Conseil
À partir de l'agent Node.js version 6.10.0 , lorsque vous activez le traçage distribué et/ou le traçage infini, les informations de Transaction l'événement sont appliquées au actuellement disponible Span de la transaction. Pour cette raison, vous souhaiterez peut-être appliquer les paramètres d'attribut de l'événement Transaction à l'événement Span ou les appliquer en tant que paramètres d'attribut globaux.
Attributs spécifiques à Node.js
En plus de l'attribut APM par défaut, l'agent Node.js collecte les attributs à partir de ces sources :
Le code d'état de réponse pour une requête Web. La clé de cet attribut est httpResponseCode.
Le paramètre par défaut pour chaque destination est :
trace de transaction : Activé
Analyse des erreurs : activée
Événement APM : Activé
navigateur événement: Disabled
Note: L'attribut httpResponseCode (string value) est supprimé à partir de la version 7.0.0 de l'agent. http.statusCode (integer value) doit être utilisé à la place.
Le message d'état de réponse s'il est présent pour une demande Web. La clé de cet attribut est httpResponseMessage.
Le paramètre par défaut pour chaque destination est :
trace de transaction : Activé
Analyse des erreurs : activée
Événement APM : Activé
navigateur événement: Disabled
Note: L'attribut httpResponseMessage (string value) est supprimé à partir de la version 7.0.0 de l'agent. http.statusText (string value) doit être utilisé à la place.
Attributs ajoutés à un appel addCustomAttribute() à l'API de l'agent Node.js. Le nom de clé de cet attribut dépend de ce que vous spécifiez lorsque vous appelez la méthode.
Le paramètre par défaut pour chaque destination est :
trace de transaction : Activé
Analyse des erreurs : activée
Événement APM : Activé
navigateur événement: Disabled
Important
Avant de créer des attributs personnalisés, consultez la liste des termes réservés utilisés par NRQL de New Relic. Dans le cas contraire, des résultats inattendus pourraient survenir.
Attribut ajouté à un appel noticeError() de l'API de l'agent Node.js. Le nom de clé de cet attribut dépend de ce que vous spécifiez lorsque vous appelez la méthode.
Le paramètre par défaut pour chaque destination est :
trace de transaction : indisponible
Analyse des erreurs : activée
Événement APM : Indisponible
navigateur événement: Unavailable
L'agent Node.js peut capturer les en-têtes de réponse et de demande en tant qu'attribut. Par défaut, l'agent Node.js collectera tous les en-têtes de requête qui ne sont pas exclus.
En-têtes de requête HTTP exclus par défaut :
request.headers.cookie
request.headers.authorization
request.headers.proxy-authorization
request.headers.set-cookie*
request.headers.x-*
En-tête de réponse capturé : response.headers.content-type
Vous pouvez désactiver la collecte de tous les en-têtes en définissant allow_all_headers sur false dans votre fichier newrelic.js .
Le paramètre par défaut pour chaque destination est :
trace de transaction : Activé
Analyse des erreurs : activée
Événement APM : Activé
navigateur événement: Disabled
Demander un paramètre de la transaction. L'agent Node.js ne capture pas les paramètres par défaut. Tous les paramètres GET peuvent être capturés si l'entrée request.parameters.* est ajoutée à attributes.include, ou un paramètre de demande spécifique peut être ajouté à la liste, par exemple, request.parameters.foo ou request.parameters.bar. Afin de capturer le paramètre POST, utilisez l'appel addCustomAttribute() de l'API de l'agent Node.js.
Configurer l'attribut
Vous pouvez personnaliser les types d'attributs que l'agent Node.js envoie à chaque destination. Cela est particulièrement courant pour des raisons de sécurité, lorsque vous avez certains attributs sensibles que vous ne souhaitez pas signaler à New Relic.
Utilisez les propriétés configuration suivantes avec les règles d’attribut pour activer ou désactiver l’attribut :
Désactivé par défaut. Définissez cette valeur sur true pour que l'agent collecte uniquement tous les en-têtes, à l'exception de ceux filtrés par les règles exclude .
Activé par défaut. Réglez ceci sur false pour désactiver l'éventail attributes.include .
Activer ou désactiver complètement l'attribut. Si vous définissez une destination sur false, aucun attribut ne sera envoyé à cette destination, quels que soient vos paramètres d'inclusion/exclusion. Si une destination est activée, tous les attributs utilisateur sont envoyés à cette destination par défaut.
Spécifiez les clés d’attribut particulières que vous souhaitez que l’agent signale à New Relic. Pour toutes les destinations, il s'agit d'une liste de chaînes qui est vide par défaut. Les propriétés .exclude remplacent les propriétés .include . Pour désactiver toutes les valeurs .include , définissez attributes.include_enabled sur false.
Spécifiez les clés d’attribut particulières que vous ne souhaitez pas que l’agent signale à New Relic. Pour toutes les destinations, il s'agit d'une liste de chaînes qui est vide par défaut. Les propriétés .exclude remplacent les propriétés .include .
Règles d'attribut
L'agent Node.js suit ces règles pour déterminer quel attribut inclure ou exclure pour une destination :
Si vous définissez la propriété principale attributes.enabled sur false, l'agent ne signale aucun attribut.
configuration de l'agent :
attributes.enabled: false
attributes.include: request.parameters.*
error_collector.attributes.enabled: true
Touches de saisie :
foo
bar
request.parameters.foo
request.parameters.bar
Sortie de l'agent :
trace de transaction : Aucun attribut
Analyse des erreurs : aucun attribut
Événement APM : Aucun attribut
navigateur événement: No attribut
Lorsque vous définissez l'option activée sur false pour une destination, l'agent ignore vos paramètres d'inclusion/exclusion et ne signale aucun attribut pour cette destination.
configuration de l'agent :
transaction_tracer.attributes.enabled: false
attributes.include: one, two*
transaction_tracer.attributes.include: three, four
Touches de saisie :
one
two
three
four
Sortie de l'agent :
trace de transaction : Aucun attribut
Analyse des erreurs : one, two
Événement APM : one, two
navigateur événement: No attribut
Les propriétés .exclude remplacent les propriétés .include .
configuration de l'agent :
attributes.enabled: true
attributes.include: foo, myCustomAtt
attributes.exclude: password, myCustomAtt
Touches de saisie :
foo
myCustomAtt
password
Sortie de l'agent :
trace de transaction: foo
Analyse des erreurs : foo
Événement APM : foo
événement du navigateur : foo
Si plusieurs attributs d'inclusion ou d'exclusion affectent la même clé, le paramètre le plus spécifique aura la priorité.
configuration de l'agent :
attributes.enabled: true
attributes.include: foo, myCustomAtt
attributes.exclude: password, myCustomAtt
browser_monitoring.attributes.enabled: true
Touches de saisie :
food
food.bread
food.fruit.banana
food.fruit.apple
Sortie de l'agent :
trace de transaction: food.fruit.apple
Analyse des erreurs : food.fruit.banana, food.fruit.apple