Alcance del error: usuarios, sesiones y dispositivos afectados

El agente New Relic captura automáticamente datos sobre el alcance de los errores que afectan a su aplicación. Al organizar por grupo de errores, puedes ver el impacto a través de tres métricas clave:

• Usuario impactado: El número de usuarios únicos afectados por errores
• Sesiones afectadas: la cantidad de sesiones únicas del navegador afectadas (respaldo para la entidad del navegador)
• Dispositivos afectados: la cantidad de dispositivos celulares únicos afectados (respaldo para la entidad móvil)

Cuando los datos afectados por el usuario no están disponibles, New Relic muestra automáticamente la métrica de respaldo adecuada según el tipo de entidad. Esto lo ayuda a priorizar dónde centrar sus esfuerzos de depuración mostrándole los errores con el mayor alcance de impacto.

Impacto de retroceso métrico

New Relic prioriza mostrar los datos de impacto más relevantes para su tipo de aplicación específica. Cuando los datos de Users impacted no están disponibles, el sistema recurre automáticamente a la métrica específica de la entidad:

• Entidad de Browser : muestra las Sessions impacted : la cantidad de sesiones de navegador únicas afectadas por errores
• Entidad móvil: muestra los Devices impacted: la cantidad de dispositivos celulares únicos afectados por errores

Estas métricas de respaldo se recopilan automáticamente sin requerir configuración adicional, a diferencia del usuario impactado que puede necesitar un atributo personalizado. Esto garantiza que siempre tenga visibilidad del alcance de los errores que afectan a su aplicación, independientemente de su configuración.

atributo personalizado para rastrear al usuario impactado

En algunos casos, un evento de error puede no tener atributos que identifiquen al usuario final afectado por ese evento de error. Puede agregar manualmente un atributo personalizado para que nuestro agente capture metadatos que identifiquen al usuario en el momento de la ingesta.

Para los casos en los que necesite agregar un atributo personalizado, recomendamos revisar las convenciones de atributos deOpenTelemetry porque existen múltiples convenciones comunes para nombrar el atributo usuario final.

Por ejemplo, los estándaresOpenTelemetry emplean los siguientes atributos en orden de prioridad:

• userId
• user

Puedes revisar cómo New Relic procesa los atributos personalizados leyendo nuestro documento sobre cómo recopilar eventos personalizados.

Consulta para impacto métrico

El impacto métrico para los grupos de errores se registra como tipos de datos métricos con nombres métricos específicos:

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'

alerta sobre impacto métrico

Al crear una condición de alerta NRQL, los desarrolladores pueden activar alertascuando el alcance de los errores excede un umbral. Puedes crear alertas para cualquiera de las métricas de impacto:

• Usuario impactado: alerta cuando el impacto del usuario excede su umbral
• Sesiones afectadas: alerta cuando el impacto en la sesión del navegador supera su umbral
• Dispositivos afectados: alerta cuando el impacto del dispositivo móvil supera su 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

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

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 emplear un método de agente para identificar un usuario final para la métrica de Users impacted. Las sesiones y los dispositivos afectados se recopilan automáticamente sin configuración adicional. Vea los detalles de implementación de cada agente a continuación: