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
    ]
  }

  Copier

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

Description

Effectuez cet appel avant que l'événement de chargement de la fenêtre ne se déclenche (lorsque ces données sont transmises) afin que l'attribut soit inclus dans l'événement PageView . Une fois qu'un attribut est défini, la plateforme New Relic l'enregistre avec tous les événements jusqu'à ce que la page soit rechargée ou que l'attribut soit désactivé manuellement.

Si vous utilisez monitoringSPA avec une version d'agent compatible, l'attribut défini avec cet appel sera également inclus dans l'événement BrowserInteraction. Cependant, l'attribut défini à l'aide de la méthode SPA setAttribute aura la priorité sur ces attributs.

Les erreurs pour l'attribut personnalisé seront incluses dans l'événement sur la page Erreurs JS. Pour afficher ou log les erreurs d'un attribut personnalisé via l'API, utilisez l'appel noticeError de l'API Browser.

Actuellement, toutes les fonctionnalités ou événements du navigateur auront ces attributs globaux, à l'exception de SessionReplay et BrowserSessionChunk (trace de session).

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 .

Paramètres

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);
}