Escopo do erro: usuários, sessões e dispositivos afetados

O agente New Relic captura automaticamente dados sobre o escopo dos erros que afetam seu aplicativo. Ao organizar por grupo de erros, você pode ver o impacto por meio de três métricas principais:

• usuário impactado: O número de usuários únicos afetados por erros
• Sessões afetadas: O número de sessões únicas do browser afetadas (valor padrão para a entidade do browser).
• Dispositivos afetados: Número de dispositivos móveis únicos afetados (recurso alternativo para entidades móveis)

Quando os dados que afetam o usuário não estão disponíveis, New Relic exibe automaticamente a métrica alternativa apropriada com base no tipo da sua entidade. Isso ajuda você a priorizar onde concentrar seus esforços de depuração, mostrando os erros com maior potencial de impacto.

Impacto de fallback Métrica

New Relic prioriza a exibição dos dados de impacto mais relevantes para o seu tipo específico de aplicativo. Quando os dados do Users impacted não estão disponíveis, o sistema recorre automaticamente à métrica específica da entidade:

• Entidade de Browser : Exibe as Sessions impacted - o número de sessões únicas do browser afetadas por erros.
• Entidade móvel: Exibe os Devices impacted - o número de dispositivos móveis únicos afetados por erros.

Essas métricas de fallback são coletadas automaticamente sem necessidade de configuração adicional, ao contrário do usuário impactado que pode necessitar de atributo personalizado. Isso garante que você sempre tenha visibilidade do escopo dos erros que afetam seu aplicativo, independentemente da sua configuração.

Atributo personalizado para rastrear usuário impactado

Em alguns casos, um evento de erro pode não ter atributos que identifiquem o usuário final afetado por esse evento de erro. Você pode adicionar manualmente um atributo personalizado para que nosso agente capture metadados de identificação do usuário no momento da ingestão.

Para casos em que você precisa adicionar um atributo personalizado, recomendamos revisar as convenções de atributo doOpenTelemetry porque há várias convenções comuns para nomear o atributo final do usuário.

Por exemplo, os padrõesOpenTelemetry usam o seguinte atributo em ordem de prioridade:

• userId
• user

Você pode revisar como New Relic processa o atributo personalizado lendo nosso documento sobre como coletar eventos personalizados.

consulta para impacto Métrica

As métricas de impacto para grupos de erros são registradas como tipos de dados métrica com nomes métrica 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étrica

Ao criar uma condição de alertaNRQL , os desenvolvedores podem acionar alertasquando o escopo dos erros exceder um limite. Você pode criar alertas para qualquer um dos indicadores de impacto da Métrica:

• Usuário impactado: alerta quando o impacto do usuário ultrapassa seu limite
• Sessões afetadas: Receba um alerta quando o impacto nas sessões do browser exceder o limite definido.
• Dispositivos afetados: Receba um alerta quando o impacto em dispositivos móveis ultrapassar o seu limite.

A criação desse alerta requer a determinação da consulta NRQL que mede a quantidade de usuários impactados da maneira que melhor captura seu caso de uso.

Como exemplo, a seguinte consulta NRQL mede a quantidade de usuários únicos que foram impactados por um grupo de erros vindo de uma entidade 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

Depois de decidir sobre uma consulta NRQL, ela pode ser usada para criar uma condição do alerta NRQL.

Para melhorar a relação sinal-ruído dos alertas acionados, consulte dicas de criação de alertas, como os limites de alerta são avaliados e exemplos de condição do alerta.

Definir usuário impactado pelo método setUser

Você pode usar um método agente para identificar um usuário final para a métrica do Users impacted. As sessões e os dispositivos afetados são coletados automaticamente, sem necessidade de configuração adicional. Veja abaixo os detalhes de implementação para cada agente: