Syntaxe
newrelic.setApplicationVersion(value: string|null)
Ajoute une chaîne de version d'application définie par l'utilisateur à l'événement ultérieur sur la page.
Exigences
Agent navigateur Lite, Pro ou Pro+SPA (v1.238.0 ou supérieur)
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
Lors de l'exécution de cette fonction avec une valeur valide, l'agent du navigateur ajoute un attribut application.version
à tous les événements suivants jusqu'à ce que l'attribut soit désactivé manuellement ou que la page soit déchargée. Si la fonction est appelée plusieurs fois, seule la valeur la plus récente fournie sera envoyée lors de l'événement suivant. Si cette fonction est appelée avec une valeur de null
, toute version d'application existante cessera d'envoyer lors de l'événement suivant.
La définition de l’attribut application.version
vous aidera à identifier les versions de votre logiciel qui produisent les erreurs. Une prochaine version de la boîte de réception des erreurs suivra automatiquement les versions de votre logiciel qui génèrent des erreurs. Si vous utilisez monitoringSPA avec une version d'agent compatible, la version de l'application sera également incluse dans l'événement newrelic.interaction
.
Paramètres
paramètres | Description |
---|---|
chaîne OU null | Requis. Une chaîne représentant la version de l'application Web, utile pour lier tous les événements du navigateur à une balise de sortie spécifique. Le paramètre La transmission d'une valeur |
Exemples
Décoration d'événement avec une version applicative
newrelic.setApplicationVersion('1.2.3') // decorates events with the property 'application.version':'1.2.3'
Arrêt d'un événement depuis la version de l'application de décoration
newrelic.setApplicationVersion(null) // events will no longer have an 'application.version' property set