Suivi des utilisateurs impactés par les erreurs de la boîte de réception

Les agents New Relic capturent automatiquement les données sur l’impact sur l’utilisateur. Lorsque vous organisez par groupe d'erreurs, vous pouvez voir combien d'utilisateurs sont affectés par des erreurs. Cela vous aide à prioriser où concentrer vos efforts de débogage en vous montrant les erreurs avec le plus grand nombre d'utilisateurs affectés.

attribut personnalisé pour suivre l'utilisateur impacté

Dans certains cas, un événement d'erreur peut ne pas avoir d'attribut permettant d'identifier l'utilisateur final affecté par cet événement d'erreur. Vous pouvez ajouter manuellement l'attribut personnalisé afin que nos agents capturent les métadonnées d'identification de l'utilisateur au moment de l'ingestion.

Pour les cas où vous devez ajouter un attribut personnalisé, nous vous recommandons de consulter les conventions d'attribut d' OpenTelemetry car il existe plusieurs conventions courantes pour nommer l'attribut final de l'utilisateur.

Par exemple, les normesOpenTelemetry utilisent l'attribut suivant par ordre de priorité :

• userId
• user

Vous pouvez voir comment New Relic traite les attributs personnalisés en lisant notre documentation sur la collecte d'événements personnalisés.

requête utilisateur impactée

Le nombre d'utilisateurs impactés par un groupe d'erreurs est enregistré sous forme de type de données métrique avec le nom newrelic.error.group.userImpact. Vous pouvez utiliser cette métrique avec la chaîne NRQL suivante :

SELECT uniqueCount(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact'

La métrique capture le nombre approximatif d'utilisateurs uniques dans la période sélectionnée. Les attributs supplémentaires fournis par la métrique userImpact qui peuvent être utilisés dans une clause FACET sont error.group.guid, entity.guid.

Alerte sur utilisateur impacté

En créant une condition d'alerte NRQL , les développeurs peuvent se déclencher alerteslorsque le nombre d'utilisateurs concernés par des erreurs dépasse un seuil.

La création de cette alerte nécessite de déterminer la requête NRQL qui mesure la quantité d'utilisateurs impactés d'une manière qui capture le mieux votre cas d'utilisation.

À titre d’exemple, la requête NRQL suivante mesure le nombre d’utilisateurs uniques qui ont été impactés par un groupe d’erreurs provenant d’une entité spécifique :

SELECT uniqueCount(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact' 
AND entity.guid='RXxCUk9XU9182nNEFQUExJQ0FLsU9OfDgzNzgwNw' FACET error.group.guid TIMESERIES

En savoir plus sur l'utilisation de la fonction uniqueCount(), comment trouver le GUIDd'entité pour votre entité.

De même, la requête NRQL suivante mesure le nombre total d'utilisateurs impactés par des erreurs de toutes les entités sous le compte au cours de la dernière heure :

SELECT count(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact' SINCE 1 hour ago TIMESERIES

Une fois que vous avez choisi une requête NRQL, elle peut être utilisée pour créer une condition d'alerte NRQL .

Pour améliorer le rapport signal/bruit de vos alertes déclenchées, consultez les conseils de création d'alertes, la manière dont les seuils d'alerte sont évalués et les exemples de conditions d'alerte.

Définir l'utilisateur impacté par la méthode setUser

Vous pouvez utiliser une méthode d’agent pour identifier un utilisateur final. Voir les détails d’implémentation pour chaque agent ci-dessous :