Ahora puede ver la cantidad de usuarios afectados por un grupo de errores, lo que le permite centrar su esfuerzo en los grupos de errores de mayor impacto. El usuario afectado se enumera junto a la métrica de ocurrencias en la vista de lista. También puede configurar alertas para grupos de errores que afecten a más de un determinado número de usuarios.
Empezando
Las métricas de impacto del usuario se recopilan automáticamente si su error incluso tiene un atributo que identifica al usuario final. Para los agentes que no admiten de forma nativa agregar un identificador de usuario a la telemetría, recomendamos agregar un atributo personalizado y seguir el atributo de convención de OpenTelemetry para los atributos de identidad, que es enduser.id
. El proceso de envío de atributo personalizado a New Relic se detalla aquí.
Convenciones de atributos para capturar usuarios impactados.
Existen múltiples convenciones comunes para nombrar los atributos del usuario final. Primero, comprobaremos enduser.id
según el estándar OpenTelemetry. Luego usaremos el siguiente atributo en orden de prioridad:
userId
user
Consultando usuario impactado
La cantidad de usuarios afectados por un grupo de errores se registra como un tipo de datos de métrica con el nombre newrelic.error.group.userImpact
. Puede utilizar esta métrica con la siguiente cadena NRQL:
SELECT uniqueCount(newrelic.error.group.userImpact) FROM Metric WHERE metricName='newrelic.error.group.userImpact'
La métrica captura el número aproximado de usuarios únicos en el período de tiempo seleccionado. Los atributos adicionales proporcionados por la métrica userImpact
que se pueden usar en una cláusula FACET
son error.group.guid
, entity.guid
.
Alerta sobre usuario impactado
Al crear una condición de alerta NRQL, los desarrolladores pueden activar cuando la cantidad de usuarios afectados por errores supera un umbral.
La creación de esta alerta requiere determinar la consulta NRQL que mide la cantidad de usuarios afectados de la manera que mejor capture su caso de uso.
Como ejemplo, la siguiente consulta NRQL mide la cantidad de usuarios únicos que se han visto afectados por un grupo de errores procedente de una entidad específica:
SELECT uniqueCount(newrelic.error.group.userImpact) FROM Metric WHERE metricName='newrelic.error.group.userImpact' AND entity.guid='RXxCUk9XU9182nNEFQUExJQ0FLsU9OfDgzNzgwNw' FACET error.group.guid TIMESERIES
Lea más sobre el uso de la función uniqueCount()
, cómo encontrar el GUID de entidad para sus entidades.
De manera similar, la siguiente consulta NRQL mide el número total de usuarios afectados por errores de todas las entidades de la cuenta en la última hora:
SELECT count(newrelic.error.group.userImpact) FROM Metric WHERE metricName='newrelic.error.group.userImpact' SINCE 1 hour ago TIMESERIES
Una vez que haya decidido una consulta NRQL, puede usarla para crear una condición de alerta NRQL.
Para mejorar la relación señal-ruido de sus alertas activadas, consulte los consejos para la creación de alertas, cómo se evalúan los umbrales de alerta y ejemplos de condición de alerta.
Establecer usuario impactado con el método setUser
Puede utilizar un método de agente para identificar a un usuario final. Consulte los detalles de implementación para cada agente a continuación: