définir un attribut personnalisé

Syntaxe

newrelic.setCustomAttribute(name: string, value: string|number|boolean|null[, persist: boolean])

Ajoute un nom et une valeur d'attribut personnalisé défini par l'utilisateur à l'événement ultérieur sur la page.

Exigences

Agent navigateur Lite, Pro ou Pro+SPA (v593 ou supérieur)
- Pour la prise en charge du paramètre persist ou de la valeur null , la version de l'agent 1.230.0 ou supérieure est requise.
- Pour la prise en charge de la valeur boolean , la version de l'agent 1.245.0 ou supérieure est requise.
Si vous utilisez npm pour installer l'agent du navigateur, vous devez activer au moins une fonctionnalité lors de l'instanciation de la classe BrowserAgent . Par exemple, ajoutez ce qui suit dans l’éventailfeatures :
```
import { Metrics } from '@newrelic/browser-agent/features/metrics'

const options = {
  info: { ... },
  loader_config: { ... },
  init: { ... },
  features: [
    Metrics
  ]
}
```

Pour plus d'informations, consultez la documentation d'installation du navigateur NPM.

Description

Définit un attribut personnalisé pour votre session d'agent. Une fois qu'un attribut est défini, la plateforme New Relic l'enregistre avec tous les événements pris en charge jusqu'à ce que la page soit rechargée ou que l'attribut soit manuellement annulé.

Les événements de Browser suivants sont pris en charge :

Nom de l'événement	Remarques
`AjaxRequest`
`BrowserInteraction`	Les attributs définis à l’aide de la méthode SPA `setAttribute` prévalent sur les attributs définis par `setCustomAttribute`.
`BrowserPerformance`
`JavaScriptError`	Pour afficher ou consigner les erreurs d'un attribut personnalisé via l'API, utilisez l'appel d'API de navigateur `noticeError`.
`Log`	Les attributs personnalisés fournis à la méthode `log` dans l'argument `options.customAttributes` sont prioritaires sur les attributs définis par `setCustomAttribute`.
`PageAction`
`PageView`	Effectuez cet appel avant le déclenchement de l’événement de chargement de la fenêtre (lorsque ces données sont transmises) afin que les attributs soient inclus dans l’événement `PageView`.
`PageViewTiming`
`UserAction`

Avec l'indicateur persist , l'attribut peut également être stocké dans le navigateur, de sorte que les visites de pages ultérieures de la même origine within a session le conservent lors de l'événement. Veuillez noter que cette fonctionnalité peut varier en fonction des paramètres de confidentialité du navigateur de l'utilisateur final. Si cette fonction est appelée avec un value = null, l'attribut sera supprimé de l'événement both de la page courante et du stockage, quel que soit le flag persist .

Important

Soyez conscient que les attributs persistants ont priorité sur info.jsAttributes clés du même nom ! Par exemple, un attribut persistant someName défini sur somedomain.com/pageA remplacera tout someName défini statiquement sur le bloc d'informations de somedomain.com/pageB, en supposant qu'ils partagent le même stockage (session).

Paramètres

paramètres	Description
`name` chaîne	Requis. Nom de l'attribut. Apparaît comme colonne dans l'événement `PageView` . Il apparaîtra également comme une colonne dans l'événement `PageAction` si vous l'utilisez. Évitez d’utiliser des mots NRQL réservés lorsque vous nommez l’attribut/la valeur.
`value` chaîne OU entier OU booléen OU nul	Requis. Valeur de l'attribut. Apparaît comme valeur dans la colonne d’attribut nommée dans l’événement `PageView` . Il apparaîtra comme une colonne dans l'événement `PageAction` si vous l'utilisez. Les valeurs d'attribut personnalisées ne peuvent pas être des objets complexes, uniquement des types simples tels que des chaînes, des entiers et des booléens. La transmission d'une valeur `null` annule tout attribut existant du même nom. Évitez d’utiliser des mots NRQL réservés lorsque vous nommez l’attribut/la valeur.
`persist` booléen	Facultatif. Si défini sur `true`, la paire nom-valeur sera également définie dans l'API de stockage du navigateur. Ensuite, sur les pages instrumentées suivantes qui se chargent au sein de la même session, la paire sera réappliquée comme un attribut personnalisé. La valeur par défaut est `false`.

paramètres

Description

name

chaîne

Requis. Nom de l'attribut. Apparaît comme colonne dans l'événement PageView . Il apparaîtra également comme une colonne dans l'événement PageAction si vous l'utilisez.

Évitez d’utiliser des mots NRQL réservés lorsque vous nommez l’attribut/la valeur.

value

chaîne OU entier OU booléen OU nul

Requis. Valeur de l'attribut. Apparaît comme valeur dans la colonne d’attribut nommée dans l’événement PageView . Il apparaîtra comme une colonne dans l'événement PageAction si vous l'utilisez. Les valeurs d'attribut personnalisées ne peuvent pas être des objets complexes, uniquement des types simples tels que des chaînes, des entiers et des booléens.

La transmission d'une valeur null annule tout attribut existant du même nom.

Évitez d’utiliser des mots NRQL réservés lorsque vous nommez l’attribut/la valeur.

persist

booléen

Facultatif. Si défini sur true, la paire nom-valeur sera également définie dans l'API de stockage du navigateur. Ensuite, sur les pages instrumentées suivantes qui se chargent au sein de la même session, la paire sera réappliquée comme un attribut personnalisé.

La valeur par défaut est false.

Exemples

Obtenir JavaScript/jQuery pour les éléments HTML

Cet exemple utilise JavaScript/jQuery pour obtenir les valeurs des éléments HTML suivants sur une page générée par Drupal :

<link rel="shortlink" href="/node/1111" />
<h1>Using NRQL</h1>

New Relic les signale comme attribut personnalisé. Ceci est utile pour interroger les événements PageView et PageAction .

var node_id = jQuery("link[rel='shortlink']").attr("href");
var node_title = jQuery('h1').text();

if (typeof newrelic == 'object') {
  newrelic.setCustomAttribute('nodeId', node_id);
  newrelic.setCustomAttribute('title', node_title);
}

Cette traduction automatique est fournie pour votre commodité.

Syntaxe.css-21sua1{background:none;border:none;width:0;padding:0;}

Exigences

Description

Important

Paramètres

Exemples

Obtenir JavaScript/jQuery pour les éléments HTML

Syntaxe