Activer et désactiver l'attribut (Ruby)

Ceci décrit les propriétés permettant d'activer ou de désactiver l'attribut, ainsi que les règles que New Relic utilise pour déterminer l'attribut à inclure ou à exclure pour une destination. Cela inclut également un résumé des propriétés de l'agent Ruby qui ont été déconseillées ou supprimées avec la sortie de l'attribut de l'agent New Relic.

Propriétés

Utilisez les propriétés suivantes pour activer ou désactiver l’attribut :

Type	Booléen
Défaut	`true`
Variable d'environnement	`NEW_RELIC_ATTRIBUTES_ENABLED`

Si true, active la capture de l'attribut pour toutes les destinations.

Type	Booléen
Défaut	(Dynamique)
Variable d'environnement	`NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED`

Si true, l'agent capture l'attribut de .

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE`

Préfixe d'attribut à exclure de l'événement de transaction. Autorise * comme caractère générique à la fin.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE`

Préfixe de l'attribut à exclure de la collecte des erreurs. Autorise * comme caractère générique à la fin.

Pour éviter la collecte de error.message , utilisez plutôt la strip_exception_messages configuration.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE`

Préfixe de l'attribut à exclure de . Autorise * comme caractère générique à la fin.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDE`

Préfixe d'attribut à exclure des segments de transaction. Autorise * comme caractère générique à la fin.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE`

Préfixe d'attribut à inclure dans la trace de transaction. Autorise * comme caractère générique à la fin.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE`

Préfixe d'attribut à inclure dans l'événement de transaction. Autorise * comme caractère générique à la fin.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE`

Préfixe d'attribut à inclure dans monitoring des navigateurs. Autorise * comme caractère générique à la fin.

Type	Array
Défaut	`[]`
Variable d'environnement	`NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDE`

Préfixe d'attribut à inclure dans les segments de transaction. Autorise * comme caractère générique à la fin.

Règles d'attribut

New Relic suit ces règles pour déterminer quel attribut inclure ou exclure pour une destination.

Le champ attributes.enabled l'emporte sur tous les autres paramètres. Lorsque false, aucun attribut ne sera signalé à New Relic.

Exemple de configuration :

attributes.enabled: false
    attributes.include: foo, bar
    transaction_tracer.attributes.enabled: true

Exemple de sortie :

Keys passed in: foo, bar, baz
    Keys included for all destinations:
    Keys excluded for all destinations: foo, bar, baz

Les indicateurs YOUR_DESTINATION.attributes.enabled ont priorité sur les clés d'inclusion et d'exclusion.

Exemple de configuration :

transaction_tracer.attributes.enabled: false
    attributes.include: one, two
    transaction_tracer.attributes.include: three, four

Exemple de sortie :

Keys passed in: one, two, three, four
    Keys included for transaction traces:
    Keys excluded for transaction traces: one, two, three, four

Si une destination est activée, tous les attributs utilisateur sont envoyés à cette destination par défaut.

Note: Tous les attributs utilisateur sont par défaut true. Cependant, par défaut, les paramètres de demande sont désactivés pour toutes les destinations.

Exemple de configuration :

attributes.enabled: true
    attributes.exclude: baz

Exemple de sortie :

Keys passed in: foo, bar, baz
    Keys included: foo, bar
    Keys excluded: baz

Si la même clé est répertoriée dans les listes d'inclusion et d'exclusion, l'attribut avec la clé spécifiée sera exclu.

Exemple de configuration :

attributes.enabled: true
    attributes.include: foo, bar
    attributes.exclude: nerd, bar

Exemple de sortie :

Keys passed in: foo, bar, nerd
    Keys included: foo
    Keys excluded: nerd, bar

Les clés sont sensibles à la casse.

Exemple de configuration :

attributes.enabled: true
    attributes.exclude: username, UsErNaMe

Exemple de sortie :

Keys passed in: username, Username, USERNAME, UsErNaMe, userNAME
    Keys included: Username, USERNAME, userNAME
    Keys excluded: username, UsErNaMe

Vous pouvez utiliser un astérisque * à la fin d'une clé comme caractère générique. Cela correspondra à un ensemble d’attributs avec le même préfixe.

Exemple de configuration :

attributes.enabled: true
    attributes.include: custom*
    attributes.exclude: request.parameters.*

Exemple de sortie :

Keys passed in: custom, custom.key1, custom.key2, request.parameters., request.parameters.foo, request.parameters.bar
    Keys included: custom, custom.key1, custom.key2
    Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar

Si plusieurs attributs d'inclusion ou d'exclusion affectent la même clé, le paramètre le plus spécifique aura la priorité.

Exemple de configuration :

attributes.enabled: true
    attributes.include: request.parameters.foo
    attributes.exclude: request.parameters.*

Exemple de sortie :

Keys passed in: request.parameters., request.parameters.foo, request.parameters.bar
    Keys included: request.parameters.foo
    Keys excluded: request.parameters., request.parameters.bar

Si l'attribut include ou exclude est spécifié sur une destination, il n'impacte que cette destination.

Exemple de configuration :

attributes.include: foo
    transaction_events.attributes.exclude: foo

Exemple de sortie :

Keys passed in: foo
    Keys included for transaction events:
    Keys included for other destinations: foo
    Keys excluded for transaction events: foo

Propriétés liées à l'URI

Par défaut, l'agent Ruby signale les identifiants de ressources uniformes (URI) à New Relic à plusieurs endroits différents, notamment les destinations suivantes :

L'attribut request.uri de l'événement d'erreur
L'attribut http.url de span événement
L'attribut url de la trace SQL lente
L'attribut uri des segments de requête externes

New Relic recommande de signaler ces URI, car ils peuvent contenir des informations de débogage utiles. Si vos URI contiennent des données sensibles que vous ne souhaitez pas signaler, telles que des adresses e-mail ou des identifiants de compte, vous pouvez désactiver la création de rapports d'URI. Pour désactiver le rapport d'URI, ajoutez l'un des noms d'attribut ci-dessus à la liste attributes.exclude .

Par exemple, l’ajout de la clé suivante à votre fichier de configuration empêchera l’agent de signaler l’une des propriétés liées à l’URI :

attributes.exclude: uri

Propriétés obsolètes et supprimées

Les propriétés suivantes ont été obsolètes ou supprimées. Passez à la nouvelle configuration d’attribut pour ces propriétés lors de la mise à niveau de votre agent Ruby .

Deprecated property	New property	Removed Version
`capture_params`	`attributes.include: request.parameters.*`	N/A
`resque.capture_params`	`attributes.include: job.resque.args.*`	9.0.0
`sidekiq.capture_params`	`attributes.include: job.sidekiq.args.*`	9.0.0
`transaction_tracer.capture_attributes`	`transaction_tracer.attributes.enabled`	9.0.0
`error_collector.capture_attributes`	`error_collector.attributes.enabled`	9.0.0
`browser_monitoring.capture_attributes`	`browser_monitoring.attributes.enabled`	9.0.0
`analytics_events.capture_attributes`	`transaction_events.attributes.enabled`	9.0.0

Cette traduction automatique est fournie pour votre commodité.

Activer et désactiver l'attribut (Ruby)

Propriétés

attributes.enabled

transaction_tracer.attributes.enabled

transaction_events.attributes.enabled

error_collector.attributes.enabled

browser_monitoring.attributes.enabled

span_events.attributes.enabled

transaction_segments.attributes.enabled

attributes.exclude

transaction_tracer.attributes.exclude

transaction_events.attributes.exclude

attribut_collecteur_erreur.exclude

browser_monitoring.attributes.exclude

span_events.attributes.exclude

transaction_segments.attributes.exclude

attributes.include

transaction_tracer.attributes.include

transaction_events.attributes.include

error_collector.attributes.include

browser_monitoring.attributes.include

span_events.attributes.include

transaction_segments.attributes.include

Règles d'attribut

Le niveau racine est prioritaire pour l'activation.

La destination activée a priorité sur l'inclusion et l'exclusion.

L'attribut est inclus si la destination est activée.

Exclure remplace toujours inclure.

Les clés sont sensibles à la casse.

Utilisez `\*` pour les caractères génériques.

Le réglage le plus spécifique pour une clé est prioritaire.

Inclure ou exclure affecte la destination spécifique.

Propriétés liées à l'URI

Propriétés obsolètes et supprimées

Cette traduction automatique est fournie pour votre commodité.

Activer et désactiver l'attribut (Ruby)

Propriétés.css-21sua1{background:none;border:none;width:0;padding:0;}

transaction_tracer.attributes.enabled

transaction_events.attributes.enabled

error_collector.attributes.enabled

browser_monitoring.attributes.enabled

span_events.attributes.enabled

transaction_segments.attributes.enabled

attributes.exclude

transaction_tracer.attributes.exclude

transaction_events.attributes.exclude

attribut_collecteur_erreur.exclude

browser_monitoring.attributes.exclude

span_events.attributes.exclude

transaction_segments.attributes.exclude

attributes.include

transaction_tracer.attributes.include

transaction_events.attributes.include

error_collector.attributes.include

browser_monitoring.attributes.include

span_events.attributes.include

transaction_segments.attributes.include

Règles d'attribut

Le niveau racine est prioritaire pour l'activation.

La destination activée a priorité sur l'inclusion et l'exclusion.

L'attribut est inclus si la destination est activée.

Exclure remplace toujours inclure.

Les clés sont sensibles à la casse.

Utilisez \* pour les caractères génériques.

Le réglage le plus spécifique pour une clé est prioritaire.

Inclure ou exclure affecte la destination spécifique.

Propriétés liées à l'URI

Propriétés obsolètes et supprimées

Propriétés

Utilisez `\*` pour les caractères génériques.