Rastreie o usuário afetado pela Errors Inbox

O agente New Relic captura automaticamente dados sobre o impacto do usuário. Ao organizar por grupo de erros, você pode ver quantos usuários são afetados por erros. Isso ajuda você a priorizar onde concentrar seus esforços de depuração, mostrando os erros com o maior número de usuários afetados.

Acesse one.newrelic.com > APM & Services > Errors (errors inbox) > Triage: você pode encontrar o usuário impactado na segunda coluna da tabela Error groups , localizada abaixo da série temporal Error count e Error rate .

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 usuário impactado

O número de usuários impactados em um grupo de erros é registrado como um tipo de dados métrico com o nome newrelic.error.group.userImpact. Você pode usar essa métrica com a seguinte string NRQL:

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

A métrica captura o número aproximado de usuários únicos no período selecionado. Atributos adicionais fornecidos pela métrica userImpact que podem ser usados em uma cláusula FACET são error.group.guid, entity.guid.

Alerta sobre usuário impactado

Ao criar uma condição do alerta NRQL, os desenvolvedores podem acionar quando a quantidade de usuários impactados por erros exceder um 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

Leia mais sobre como usar a função uniqueCount() e como encontrar o GUID da entidade para suas entidades.

Da mesma forma, a seguinte consulta NRQL mede o número total de usuários impactados por erros de todas as entidades da conta na última hora:

SELECT count(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact' SINCE 1 hour ago 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 de agente para identificar um usuário final. Veja detalhes de implementação para cada agente abaixo:

Agente	Método para identificar um usuário final
Browser	`newrelic.setUserId(value: string\|null)`
Go	`txn.SetUserID("example user ID")`
Java	`NewRelic.setUserId(String userId);`
Mobile	`setUserId`
.NET	`SetUserId`
Node.js	`setUserID(id)`
PHP	`newrelic_set_user_id(string $user_id)`
Python	`newrelic.agent.set_user_id(user_id)`
Ruby	`NewRelic::Agent.set_user_id`