Syntaxe
newrelic.agent.add_custom_span_attribute(key, value)Ajoute un attribut personnalisé à un événement span.
Description
Cet appel enregistre un attribut personnalisé (une paire valeur clé attachée à votre span événement).
l'attribut peut être trouvé dans le tracing distribué ou dans APM si une trace de transaction est créée par la transaction parent. L'attribut peut également être trouvé et interrogé dans l'UI New Relic.
Important
Avant de créer un attribut personnalisé, consultez notre liste de termes réservés utilisés par NRQL.
Paramètres
paramètres | Description |
|---|---|
chaîne | Requis. Le nom de la clé. Seuls les 255 premiers caractères sont conservés. |
chaîne, entier, virgule flottante, booléen | Requis. La valeur de chaîne à ajouter à l'événement span actuel. Seuls les 255 premiers caractères sont conservés. |
Valeurs de retour
Renvoie True si l'attribut a été ajouté avec succès.
Exemples
Ajout d'un attribut personnalisé à la tâche en arrière-plan
Un exemple d'ajout d'attribut personnalisé à une tâche en arrière-plan:
@newrelic.agent.background_task()def send_request(): with newrelic.agent.FunctionTrace(name='Trace'): newrelic.agent.add_custom_span_attribute('attribute', 'value')Utilisation de l'attribut span personnalisé pour résoudre les problèmes
Vous pouvez également utiliser l'attribut personnalisé pour résoudre les problèmes de performances. Par exemple, vous pouvez constater des temps de réponse lents occasionnels à partir d'un pool d'instances memcache, mais vous ne savez pas quelle instance est à l'origine du problème. Vous pouvez ajouter un attribut à l'étendue indiquant le serveur, comme ceci :
# Set server_ip to be the current server processing the transaction
newrelic.agent.add_custom_span_attribute("memcache_query_frontend_lookup", server_ip)