Étendue des erreurs : utilisateurs, sessions et appareils concernés

Les agents New Relic capturent automatiquement des données sur l’étendue des erreurs affectant vos applications. Lorsque vous organisez par groupe d’erreurs, vous pouvez voir l’impact grâce à trois métriques clés :

• Utilisateurs concernés: le nombre d’utilisateurs uniques affectés par les erreurs
• Sessions concernées: le nombre de sessions de navigateur uniques affectées (solution de secours pour les entités de navigateur)
• Appareils concernés: le nombre d’appareils mobiles uniques affectés (solution de secours pour les entités mobiles)

Lorsque les données sur les utilisateurs concernés ne sont pas disponibles, New Relic affiche automatiquement la métrique de secours appropriée en fonction de votre type d’entité. Cela vous aide à hiérarchiser les efforts de débogage en vous montrant les erreurs ayant la plus grande portée d’impact.

Métriques d’impact de secours

New Relic donne la priorité à l’affichage des données d’impact les plus pertinentes pour votre type d’application spécifique. Lorsque les données Users impacted ne sont pas disponibles, le système revient automatiquement aux métriques spécifiques à l’entité :

• Entités Browser: affiche Sessions impacted - le nombre de sessions Browser uniques affectées par les erreurs
• Entités mobiles: affiche Devices impacted - le nombre d’appareils mobiles uniques affectés par les erreurs

Ces métriques de secours sont collectées automatiquement sans nécessiter de configuration supplémentaire, contrairement aux utilisateurs concernés, qui peuvent nécessiter des attributs personnalisés. Cela vous garantit une visibilité constante sur la portée des erreurs affectant vos applications, quelle que soit votre configuration.

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 pour les métriques d’impact

Les métriques d’impact pour les groupes d’erreurs sont enregistrées en tant que Types de données métriques avec des noms de métriques spécifiques :

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

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

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

Alerte sur les métriques d’impact

En créant une condition d’alerte NRQL, les développeurs peuvent déclencher alerteslorsque l’étendue des erreurs dépasse un seuil. Vous pouvez créer des alertes pour toutes les métriques d’impact :

• Utilisateurs concernés: alertez-vous lorsque l’impact sur les utilisateurs dépasse votre seuil
• Sessions concernées: alerte lorsque l’impact des sessions de navigateur dépasse votre seuil
• Appareils concernés: alerte lorsque l’impact des appareils mobiles dépasse votre 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

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

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

SELECT uniqueCount(newrelic.error.group.deviceUuidImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.deviceUuidImpact' 
AND entity.guid='YOUR_MOBILE_ENTITY_GUID' FACET error.group.guid 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 pour la métrique Devices impacted. Les sessions et les appareils concernés sont collectés automatiquement sans configuration supplémentaire. Consultez les détails de l’implémentation pour chaque agent ci-dessous :