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.recordCustomEventdans la partie appropriée du JavaScript de votre application. - Attendez quelques minutes que l’application s’exécute et signale les événements
custompertinents 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
eventTypeque 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
customavec uneventTypedeFooet 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.addPageActiondans la partie appropriée du JavaScript de votre application. - Attendez quelques minutes que l'application s'exécute et signale l'événement
PageActionpertinent. - Exécutez une requête NRQL de l'événement
PageActionqui inclut l'attributactionNameque 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
PageActionavec unactionNamedeFooet 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. |