Syntaxe
newrelic_add_custom_span_parameter(string $key, scalar $value)Attache un attribut personnalisé (valeur clé paire) au span actuel.
Exigences
Version de l'agent 9.12.0.268 ou supérieure.
Description
Ajoutez un attribut personnalisé (une paire de données clé et valeur) à la plage actuelle. (Le nom d'appel est newrelic_add_custom_span_parameter car « attribut personnalisé » était auparavant appelé « paramètre personnalisé ».) Par exemple, vous pouvez ajouter le nom complet d'un client à partir de votre base de données clients. Cet attribut apparaît dans n’importe quelle étendue. Vous pouvez également interroger le Span pour votre attribut personnalisé.
Important
Sur les spans, l'attribut ajouté avec newrelic_add_custom_span_parameter aura la priorité sur l'attribut ajouté avec newrelic_add_custom_parameter.
Important
Si vous souhaitez utiliser votre attribut personnalisé, évitez d'utiliser l'un des termes réservés utilisés par NRQL.
Paramètres
paramètres | Description |
|---|---|
chaîne | Requis. Le nom de l'attribut personnalisé. Seuls les 255 premiers caractères sont conservés. |
scalaire | Requis. La valeur à associer à cet attribut personnalisé. Si la valeur donnée est un float avec une valeur de NaN, Infinity, denorm ou moins zéro, le comportement de cette fonction est indéfini. Pour les autres valeurs à virgule flottante, l'agent peut ignorer 1 ou plusieurs bits de précision (ULP) de la valeur donnée. |
Valeurs de retour
Renvoie vrai si le paramètre a été ajouté avec succès.
Exemples
Signaler une variable comme valeur
if (extension_loaded('newrelic')) { // Ensure PHP agent is available // Record custom data about this web transaction newrelic_add_custom_span_parameter ('user_email', $user_email);}