Les attributs sont des paires valeur clé contenant des informations qui déterminent les propriétés d'un événement ou d'une transaction. Vous pouvez afficher ces paires valeur-clé à certains endroits de l'UI ou en interrogeant ces données à l'aide de NRQL. New Relic donne à l'utilisateur la possibilité de personnaliser exactement quel attribut sera envoyé à chacune de ces destinations.
Vous pouvez également collecter des attributs personnalisés pour envoyer des données supplémentaires à New Relic.
Flux de destination d'attribut
Ce diagramme illustre comment un agent décide d'envoyer un attribut à chaque destination.
Agent attribute collection: Un agent prend trois décisions différentes lors de l'envoi d'un attribut à n'importe quelle destination New Relic en fonction des paramètres de propriété pertinents. Les noms de propriété et la syntaxe varient selon l'agent. (Les propriétés de ce diagramme sont spécifiques à l'agent PHP, mais le flux général est le même pour tous les agents. (Les noms de propriété et la syntaxe varient selon l'agent.)
Types d'attributs
L'attribut peut être collecté de diverses manières :
- Message property attributes: Ce sont les propriétés définies sur un message reçu d'une file d'attente ou d'une rubrique.
- HTTP request attributes: Ce sont les paramètres d'une requête HTTP.
- User attributes: Il agent APIs'agit d'attributs fournis par l'utilisateur via de chaque .
- Agent attributes: Il s'agit d'attributs capturés par l'agent; par exemple,
http.statusCodeethttpResponseMessage.
Destinations pour l'attribut
Les attributs collectés apparaissent à ces emplacements :
Collected attributes | Location |
|---|---|
Chaque minute, la trace de transaction collecte des données pour vos requests HTTP individuelles les plus lentes. Ces traces signaleront les attributs collectés lors de la transaction. | |
Si une transaction entraîne une erreur, ces erreurs de trace seront signalées à APM. Une erreur de trace contiendra l'attribut collecté pendant la transaction. | |
Les transactions APM contiendront les attributs collectés pendant la transaction. | |
monitoring de navigateurs événement contiendra l’attribut collecté lors de la transaction. Cependant, l'attribut collecté à la fin d'une transaction peut ne pas apparaître sur l'événement | |
L'événement Span collecté pour le traçage distribué contiendra les attributs collectés pendant le span. L'agent suivant prend en charge l'ajout d'un attribut utilisateur personnalisé à l'événement span : | |
Chaque segment d'une trace de transaction contiendra un attribut enregistré pour ce segment. |
Attribut de demande de visualisation
Les attributs de demande sont associés à une trace de transaction spécifique, à une trace de navigateur et à des erreurs dans APM et dans le dashboard. Vous pouvez voir l'attribut enregistré avec une demande lors de la visualisation de trace ou de l'erreur individuelle. L'attribut personnalisé peut être requête via NRQL exactement comme n'importe quel autre attribut.
one.newrelic.com > All capabilities > APM & services > (select an app) > Monitoring > Transactions > (select a transaction) > (select a trace): Voici un exemple de l'agent Ruby des Request attributes et Custom attributes pour une trace de transaction. L'attribut exact dépend de votre agent et de votre configuration d'attribut.
Limites
L'attribut utilisateur, l'attribut de demande et le fichier d'attente des paramètres des messages sont limités en nombre et en taille.
Parameter | Limitations |
|---|---|
Transaction | Limité à 64 attributs utilisateur |
Clé d'attribut | Limité à 256 octets chacun Si la clé est supérieure à 256 octets, l'attribut ne sera pas enregistré. |
Valeur de l'attribut | Limité à 256 octets chacun Si la valeur est supérieure à 256 octets, la valeur de l'attribut sera tronquée. |
attribut spécifique à l'agent
Chaque agent APM collecte l'attribut personnalisé. L'attribut pris en charge dépend de l'agent spécifique :