Vous pouvez utiliser monitoring des navigateurs dans New Relic pour ajouter un événement personnalisé et un attribut.
Les attributs personnalisés
Ajoutez un attribut personnalisé à tous les événements du navigateur afin de pouvoir interroger ou filtrer vos données pour répondre à plus de questions sur votre application.
Événements personnalisés
Utilisez la méthode recordCustomEvent
de l'API du navigateur pour capturer n'importe quel événement avec une attribution personnalisée.
Actions de la page
Utilisez l'appel addPageAction
de l'API du navigateur pour capturer un événement, des actions, des changements d'itinéraire ou tout utilisateur d'interaction finale avec votre application. L'appel addPageAction
ajoute un événement nommé PageAction
qui contient le nom de l'action, les métadonnées relatives à votre page et tous les noms et valeurs d'attributs personnalisés que vous capturez avec lui.
Prérequis
Afin de signaler l'événement Custom
, vérifiez ces prérequis :
Requirement | Comments |
---|---|
Version de l'agent | La version de votre agent monitoring de navigateurs doit être 1.277.0 ou supérieure. |
Version du navigateur client | Pour enregistrer |
événement par cycle |
|
nom de l'événement/attribut, type de données, taille | Assurez-vous de suivre les exigences générales concernant la syntaxe de dénomination des événements/attributs, les types de données et la taille. |
Afin de signaler l'événement PageAction
, vérifiez ces prérequis :
Requirement | Comments |
---|---|
Version de l'agent | La version de votre agent monitoring de navigateurs doit être 593 ou supérieure. |
Version du navigateur client | Pour enregistrer |
événement par cycle |
|
nom de l'événement/attribut, type de données, taille | Assurez-vous de suivre les exigences générales concernant la syntaxe de dénomination des événements/attributs, les types de données et la taille. |
Créer un événement personnalisé
Pour créer un événement custom
:
- Assurez-vous que l' agent de navigateur est installé pour votre application.
- Appelez la fonction
newrelic.recordCustomEvent
dans la partie appropriée du JavaScript de votre application. - Attendez quelques minutes que l’application s’exécute et signale les événements
custom
pertinents sous le type d’événement que vous avez spécifié. - Exécutez une requête NRQL de l’événement qui inclut l’attribut
eventType
que vous avez utilisé pour capturer l’événement (et tout attribut associé que vous avez envoyé avec l’événement).
- Par exemple, si vous avez envoyé un événement
custom
avec uneventType
deFoo
et un attribut debar: 123
, vous pouvez exécuter une requête comme celle-ci :SELECT * FROM Foo WHERE bar = 123
Créer un événement PageAction
Pour créer un événement PageAction
:
- Assurez-vous que l' agent de navigateur est installé pour votre application.
- Appelez la fonction
newrelic.addPageAction
dans la partie appropriée du JavaScript de votre application. - Attendez quelques minutes que l'application s'exécute et signale l'événement
PageAction
pertinent. - Exécutez une requête NRQL de l'événement
PageAction
qui inclut l'attributactionName
que vous avez utilisé pour capturer l'événement (et tout attribut associé que vous avez envoyé avec l'action).
- Par exemple, si vous avez envoyé un événement
PageAction
avec unactionName
deFoo
et un attribut debar: 123
, vous pouvez exécuter une requête comme celle-ci :SELECT * FROM PageAction WHERE actionName = 'Foo' AND bar = 123
Ajouter l'attribut personnalisé à l'événement Browser
Vous pouvez ajouter l'attribut personnalisé à tous les événements Browser . Tout attribut personnalisé que vous ajoutez à l'aide de l'API setCustomAttribute
sera ajouté à tous les événements capturés.
Il existe deux façons d'ajouter un attribut personnalisé :
Les considérations importantes et les bonnes pratiques comprennent :
Vous devez monitorer l'IA pour limiter le nombre total de types d'événements personnalisés à environ cinq. Les types d'événements personnalisés sont destinés à être utilisés pour encapsuler des catégories de haut niveau. Par exemple, vous pouvez créer un type d’événement appelé Gestes qui contient de nombreux événements ayant des objectifs divers.
Évitez d'utiliser événement type pour nommer événement personnalisé. Créez des types d'événements pour héberger une catégorie de données et utilisez des attributs dans cette catégorie pour différencier les événements. Bien que vous puissiez créer de nombreux événements personnalisés, il est important de garder vos données gérables en limitant le nombre de types d'événements signalés.
Attribution incluse
Les événements de navigateur personnalisés sont décorés avec l'attribut suivant destiné à vous aider à comprendre le contexte de l'environnement du navigateur lorsque l'événement s'est produit :
Dépannage
Voici quelques conseils de dépannage :
Problem | Comments |
---|---|
attribut personnalisé manquant | Si votre attribut personnalisé n'apparaît pas sur l'événement |
| Si votre événement Si les exigences sont remplies, vérifiez que vous n'utilisez pas de noms d'attributs réservés ou de valeurs non valides. |
| Si votre événement Si les exigences sont remplies, vérifiez que vous n'utilisez pas de noms d'attributs réservés ou de valeurs non valides. |