Real User Monitoring (RUM) vous permet de capturer les événements qui se produisent dans votre navigateur et vos applications mobiles à l’aide des SDK Datadog RUM et de collecter des données à partir d’événements à un taux d’échantillonnage. Datadog conserve ces données d’événement dans le RUM Explorer, où vous pouvez créer des requêtes de recherche et des visualisations.
Les métriques personnalisées basées sur RUM sont une option rentable pour résumer les données de votre ensemble d’événements RUM. Vous pouvez visualiser les tendances et les anomalies dans vos données RUM à un niveau granulaire jusqu’à 15 mois. Après avoir créé une métrique personnalisée, consultez Créer des graphiques avec RUM Custom Metrics pour l’ajouter à un dashboard.
Remarque : Les métriques personnalisées sont calculées sur la base de 100 % du trafic RUM ingéré, et non uniquement sur les données conservées dans le RUM Explorer. Cela garantit des métriques précises même lors de l’utilisation de filtres de rétention RUM without Limits qui peuvent ne conserver qu’un sous-ensemble de vos sessions.
Remarque sur la facturation : Les métriques créées à partir d’événements RUM sont facturées en tant que Custom Metrics.
Pour créer une métrique personnalisée à partir d’une requête de recherche dans le RUM Explorer, cliquez sur le bouton Export et sélectionnez Generate new metric dans le menu déroulant.
Donnez à votre métrique personnalisée un nom qui ne commence pas par datadog.estimated_usage, tel que rum.sessions.count_by_geography. Pour plus d’informations, consultez la convention de nommage.
Sélectionnez un type d’événement pour lequel vous souhaitez créer une métrique personnalisée, tel que Sessions. Vos options incluent Sessions, Views, Actions, Errors, Resources et Long Tasks. Pour plus d’informations, consultez Rechercher des événements RUM.
Créez une requête de recherche qui filtre vos événements RUM en utilisant la syntaxe de recherche du RUM Explorer, telle que @session.type:user.
Choisissez un champ à suivre dans le menu déroulant à côté de Count.
Sélectionnez * pour générer un décompte de tous les événements RUM qui correspondent à votre requête de recherche.
Optionnellement, saisissez un attribut d’événement tel que @action.target pour agréger une valeur numérique et créer une métrique count ou distribution correspondante.
Si la facette utilisée pour les attributs RUM est une mesure, la valeur de la métrique correspond à celle de l’attribut RUM.
Sélectionnez un chemin à regrouper par dans le menu déroulant à côté de group by. Le nom du tag de métrique est l’attribut ou le nom de tag d’origine sans le @. Par défaut, les métriques personnalisées générées à partir d’événements RUM ne contiennent pas de tags à moins qu’ils ne soient explicitement ajoutés. Vous pouvez utiliser une dimension d’attribut ou de tag qui existe dans vos événements RUM, telle que @error.source ou env, pour créer des tags de métrique.
Les métriques personnalisées basées sur RUM sont considérées comme des métriques personnalisées et facturées en conséquence. Évitez de regrouper par des attributs non bornés ou à cardinalité extrêmement élevée tels que les horodatages, les ID utilisateur, les ID de requête et les ID de session.
Pour les métriques personnalisées créées sur des sessions et des vues, sélectionnez The active session/view starts matching the query ou The session/view becomes inactive or is completed pour définir les critères de correspondance pour les sessions et les vues. Pour plus d’informations, consultez Ajouter une métrique basée sur RUM pour les sessions et les vues.
Optionnellement, ajoutez des agrégations de centiles pour les métriques de distribution. Consultez Agrégation de centiles.
Cliquez sur Create Metric.
Votre métrique personnalisée basée sur RUM apparaît dans la liste sous Custom RUM Metrics, et un court délai peut être nécessaire pour que votre métrique soit disponible dans dashboards et monitors.
Aucun point de données n’est créé pour les métriques avec des données historiques. Les points de données pour votre métrique personnalisée basée sur RUM sont générés à un intervalle de dix secondes. Les données des métriques sont conservées pendant 15 mois.
Agrégation de centiles
Vous pouvez opter pour une fonctionnalité de requête avancée et utiliser des centiles globalement précis (tels que P50, P75, P90, P95 et P99) pour les métriques de distribution.
Ajoutez une métrique basée sur RUM pour les sessions et les vues
Les sessions et les vues sont considérées comme actives lorsqu’il y a une activité continue de l’application ou de l’utilisateur dans une application RUM. Par exemple, lorsqu’un utilisateur ouvre de nouvelles pages, ces pages vues sont collectées dans la session utilisateur. Lorsqu’un utilisateur interagit avec des boutons sur une page, ces actions sont collectées dans les pages vues.
Supposons que vous ayez une métrique personnalisée basée sur le RUM qui compte le nombre de sessions utilisateur contenant plus de cinq erreurs, et un ID de session 123 qui atteint cinq erreurs à 11 h et se ferme à 12 h.
En comptabilisant la session ou la vue dès qu’elle correspond à la requête, vous incrémentez la valeur de la métrique de comptage de un à l’horodatage de 11 h.
En comptabilisant la session ou la vue qui est inactive, vous incrémentez la valeur de la métrique de comptage de un à l’horodatage de 12 h.
Gérez les métriques personnalisées basées sur RUM
Vous pouvez générer une métrique count représentant le nombre d’événements RUM qui correspondent à une requête, ou une métrique de distribution représentant une valeur numérique contenue dans des événements RUM, comme la durée des requêtes.
Mettez à jour une métrique personnalisée basée sur RUM
Pour mettre à jour une métrique, survolez une métrique et cliquez sur l’icône Edit dans le coin droit.
Requête de filtrage : modifiez l’ensemble des événements RUM correspondants qui sont agrégés dans les métriques.
Groupes d’agrégation : mettez à jour les tags pour gérer la cardinalité des métriques générées.
Sélection de centile : cliquez sur le bouton Calculate percentiles pour supprimer ou générer des métriques de centile.
Comme il est impossible de renommer une métrique existante, Datadog recommande d’en créer une autre.
Supprimez une métrique personnalisée basée sur RUM
Afin d’arrêter le calcul des points de données de votre métrique personnalisée et la facturation, survolez une métrique et cliquez sur l’icône Delete dans le coin droit.
Utilisation
Vous pouvez utiliser des métriques custom basées sur RUM pour les actions suivantes :
Visualisez les tendances sur une période donnée dans un dashboard
Déclenchez une alerte lorsqu’une métrique se comporte différemment de ce qu’elle a fait par le passé dans un monitor d’anomalie
Déclenchez une alerte lorsqu’une métrique est censée franchir un seuil à l’avenir dans un monitor de prévision
Créez des SLO basés sur des métriques pour suivre les objectifs de performance centrés sur l’utilisateur pour vos équipes et organisations
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
