Syntaxe
newrelic_add_custom_parameter(string $key, scalar $value)Attache un attribut personnalisé (paire valeur clé) à la transaction en cours et au span actuel (si activé).
Exigences
Version de l'agent 4.4.5.35 ou supérieure.
Description
Ajoutez un attribut personnalisé (une paire de données clé et valeur) à la transaction Web en cours. (Le nom d'appel est newrelic_add_custom_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 toute trace de transaction résultant de cette transaction. Vous pouvez également rechercher l'événement Transaction pour votre attribut personnalisé.
Important
Recommandation de sécurité : vérifiez configuration de votre attribut de transaction. Tout paramètre d'inclusion ou d'exclusion d'attribut spécifique à l'événement de transaction doit être appliqué à votre configuration d'attribut Span ou à votre configuration d'attribut global.
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_parameter('user_email', $user_email);}Appels multiples
Si vous appelez newrelic_add_custom_parameter plusieurs fois avec la même valeur pour le paramètre $key dans le même site Web de transaction, le $value du dernier appel a la priorité. La valeur du dernier appel est enregistrée comme attribut personnalisé dans la transaction web.
Par exemple, si le code ressemble à ceci :
if (extension_loaded('newrelic')) { // Ensure PHP agent is available // Record custom data about this web transaction newrelic_add_custom_parameter('user_email', billy@newrelic.com); newrelic_add_custom_parameter('user_email', samantha@newrelic.com);}La valeur samantha@newrelic.com est enregistrée comme l'attribut user_email personnalisé dans la transaction Web, et billy@newrelic.com de l'appel précédent est écrasé.