Monitoramento de erros com Errors Inbox

Experiência unificada de monitoramento de erros

Errors Inbox fornece uma experiência unificada de monitoramento de erros para detectar e fazer triagem de erros:

• Visualize e faça a triagem de problemas em aplicativos e serviços importantes para sua equipe para soluções de erros mais rápidas.

• Envio proativo com informações detalhadas de erros no Slack.

• Perfis de erro para mostrar semelhanças entre eventos de erro e revelar a causa raiz analisando o atributo.

• Analise erros no contexto da stack completa e resolva erros com precisão.

• Erros para

  APM

  ,

  monitoramento de browser

  ,

  monitoramento de mobile

  e AWS função do Lambda são todos capturados na mesma caixa de entrada.

Pronto para começar? Consulte nossos documentos sobre como criar sua primeira workload.

Monitor erros

Depois de configurar sua Errors Inbox, você pode começar a monitorar proativamente todos os erros em sua stack:

Grupos de erros

Grupos de erros são conjuntos de eventos que constituem um erro único. Os grupos de erros são armazenados a longo prazo e contêm métricas, registro de atividades, discussões e informações básicas sobre o erro único. Os grupos de erros estão vinculados à entidade, portanto, fazer uma alteração no estado de um grupo de erros em uma Errors Inbox afetará todas as outras caixas de entrada que contêm essa entidade.

Como funcionam os grupos de erros

Os eventos de erro são agrupados em um grupo de erros quando compartilham a mesma impressão digital. À medida que os eventos são ingeridos pelo New Relic, executamos o evento por meio de um conjunto de regras gerenciadas que geram uma impressão digital. Cada impressão digital exclusiva possui um único grupo de erros associado a ela.

As regras gerenciadas da New Relic normalizam os dados de erro, identificando e ignorando valores exclusivos, como UUIDs, valores hexadecimais e endereços de e-mail que causariam o agrupamento de erros "semelhantes" em grupos exclusivos. New Relic account ID, entity ID, error class, error message, stack trace e exception são todos dados que podem afetar uma impressão digital.

Alguma das seguintes opções se aplica à sua Errors Inbox hoje?

• Erros não agrupados da maneira que faça mais sentido para o seu aplicativo.
• Vários grupos não mesclados que você gostaria de ver mesclados.
• Uma caixa de entrada “barulhenta” devido ao agrupamento inadequado que leva você a exceder o limite diário de grupos de erros exclusivos.
• Um grupo de erros na sua caixa de entrada que contém erros não relacionados.

Ter erros bem agrupados ajuda a Errors Inbox a fazer uma melhor triagem e diagnosticar problemas em seu sistema. Embora a Errors Inbox forneça um conjunto de agrupamentos padrão, ocasionalmente é necessário fazer ajustes.

Existem duas opções para ajustar grupos de erros: atualizar a mensagem de erro através de atributo personalizado ou criar seus próprios grupos de erros.

Crie seus próprios grupos de erros

Muitos de nossos agentes agora possuem um recurso que permite que seu código analise um erro e designe um grupo de erros antes de ser enviado ao New Relic. O grupo designado é então adicionado como o atributo error.group.name no evento de erro. Para começar, confira os links do APM abaixo ou a documentação do agente browser para obter informações sobre como especificar um grupo de erros personalizado. Isso garantirá que os erros e atributos coletados pelo agente sejam preservados e agrupados ao seu gosto.

Agente APM compatível:

• Browser
• Go
• Java
• Node.js
• .Net
• Python
• Ruby
• PHP

Mesmo que não ofereçamos suporte ao seu idioma, você ainda poderá definir error.group.name como um atributo personalizado. Isso nos sinaliza que o evento pertence a um grupo customizado, mas os eventos capturados não terão outro atributo de agente.

Práticas recomendadas para criação significativa de grupos de erros

Embora nossas regras gerenciadas sejam capazes de fornecer agrupamento automático de erros com base em um conjunto predefinido de padrões, é impossível reconhecer todas as combinações possíveis. Assim, remover valores de alta variabilidade da mensagem de erro garantirá que seus erros sejam agrupados corretamente.

Por exemplo, considere estas duas mensagens de erro:

• "Erro de análise: você colocou 124 e isso não é permitido"
• "Erro de análise: você colocou 456 e isso não é permitido"

Essas mensagens de erro parecem semelhantes, mas é menos provável que essas ocorrências de erro sejam agrupadas corretamente devido aos números com menos de 4 dígitos (124). Se houver informações adicionais (por exemplo SQL, ids, etc) que você deseja incluir na mensagem de erro, ela pode ser enviada via atributo personalizado.

Nossas recomendações:

• Evite usar números com menos de 4 dígitos na mensagem de erro.
• Evite incluir caracteres especiais na mensagem de erro.
• Evite incluir instruções SQL na mensagem de erro.
• Evite incluir stack trace na mensagem de erro. o rastreamento de pilha não será formatado quando enviado como mensagem de erro, portanto não funcionará com a integração CodeStream
• Evite incluir dados que tenham alta variabilidade (ex: ids, datas, JSON). o usuário ficará melhor atendido se esses valores forem recolhidos a título de atributo. Esses atributos podem ser visualizados no nível de ocorrência individual, bem como no nível do grupo de erros na Errors Inbox dentro da aba atributo.
• Advertimos o uso de datas/carimbo de hora. Embora capturemos e agrupemos algumas mensagens de erro que contêm carimbo de data/hora, não podemos garantir que reconheceremos todos os formatos.

Ocorrências

Sua Errors Inbox exibe o número total de ocorrências de cada grupo de erros dentro do período selecionado. O gráfico minigráfico correspondente exibe o número total de ocorrências por dia durante o período selecionado conforme você passa o mouse sobre ele.

Filtrar Classificar por

Usando o dropdown no canto superior direito, você pode classificar a lista de erros agrupados pelo número de ocorrências ou pelo erro visto pela última vez no intervalo de tempo selecionado. Por exemplo, se o seletor de hora selecionado for Jan 24 5:00pm ET -- Jan 24 5:45pm ET e você classificar por visto pela última vez, verá grupos de erros classificados com aqueles que contêm a ocorrência mais recente primeiro.

Tagde regressão

Um grupo de erros é marcado com uma tag de regressão quando um novo erro corresponde à impressão digital de um grupo de erros resolvido. A tag de regressão desaparecerá quando o estado de um grupo de erros regredido for alterado.

Erro esperado tag

Um grupo de erros será marcado com uma tag expected se todas as ocorrências de erros no grupo forem esperadas. Ele será marcado com uma tag contains expected se algumas ocorrências de erro forem esperadas e outras não. Essas tags estão disponíveis em todos os erros após 21 de janeiro de 2023.

Veja mais sobre como marcar erros como esperados.

Ações em massa

Você pode atualizar o status de vários grupos de erros (até 2.000) de uma só vez. Na visualização da caixa de entrada, marque a caixa de seleção Error groups para atualizar todos os seus grupos de erros na caixa de entrada. Você também pode selecionar grupos de erros individuais para atualizar seus status.

Datas da primeira e última visualização

Entendemos que é muito útil saber quando um grupo de erros foi visto pela primeira vez para correlacioná-lo com uma mudança no código/sistema. A precisão das datas da primeira e da última visualização depende dos três cenários descritos abaixo:

• Scenario 1: Se um grupo de erros foi criado pela primeira vez em ou após 17/05/2022, os primeiros e últimos valores vistos serão precisos.
• Scenario 2: Se um grupo de erros foi criado antes de 17/05/2022, a data vista pela primeira vez não será precisa. A primeira data vista é 17/05/2022 ou a data da primeira ocorrência (se a janela de tempo selecionada for anterior a 17/05/2022). O último valor visto será preciso.
• Scenario 3: Se um grupo de erros ocorrer uma vez por semana ou menos, a primeira e a última data vista serão estimativas baseadas no horário da única ocorrência. Rastreamos com precisão apenas as datas da primeira e da última visualização de erros que aparecem mais de uma vez por semana.

Erros de triagem

Errors Inbox permite fazer a triagem de grupos de erros diretamente na tela principal ou na página de detalhes do erro. A triagem ajuda a remover o ruído da sua Errors Inbox e permite que você se concentre nos erros de alto impacto que precisam de atenção.

Status de erros

Ao fazer a triagem da sua caixa de entrada, você pode escolher entre vários status. Você pode optar por resolver os erros imediatamente ou até mesmo marcá-los para que sejam ignorados. Em outros casos, você pode querer resolver os problemas na próxima versão ou em uma versão específica.

Você pode definir um dos seguintes status e filtrar sua caixa de entrada por status:

• Não resolvido: este é o status padrão dos grupos de erros.

• Resolver na próxima versão: Recomendamos que você use esse status se espera resolver esse grupo de erros em sua próxima versão. Para habilitar esta opção, você precisa configurar o Monitoramento de Alterações da sua aplicação para que Errors Inbox possa detectar uma nova versão e verificar se o grupo de erros foi realmente resolvido. Caso o grupo de erros ainda seja detectado na próxima versão ou em qualquer versão futura, o grupo de erros será resolvido automaticamente, marcado com uma regressão, e você receberá uma notificação do Slack sobre a regressão.

• Resolver em versão específica: Escolha esta opção para resolver grupos de erros nestas situações:

  • Se você sabe que o grupo de erros será resolvido em uma versão específica
  • Se você sabe que o grupo de erros foi resolvido em uma versão existente
  • Se você quiser inserir uma versão específica

  Para ativar esta opção, você precisa configurar o rastreamento de versão para seu aplicativo ou serviço. Se for detectada uma ocorrência de erro com uma versão semântica equivalente ou superior, o grupo de erros será resolvido automaticamente, marcado com uma regressão, e você receberá uma notificação do Slack sobre a regressão.

• Solução: definir um grupo de erros como resolvido irá ocultá-lo da visualização da caixa de entrada padrão, a menos que os filtros sejam atualizados para incluir grupos de erros resolvidos. Se ocorrer um evento correspondente à impressão digital do grupo de erros após marcar um grupo de erros como resolvido, o status será redefinido automaticamente para Não resolvido. Isso pode ser útil para identificar regressões.

• Ignorar: Isso ocultará o grupo de erros da visualização da caixa de entrada, a menos que os filtros sejam atualizados para incluir erros ignorados ou até que você pare de ignorar o grupo de erros.

Erro esperado

Errors Inbox permite filtrar erros esperados para entidade APM. Você pode marcar os erros como esperados e filtrá-los da sua caixa de entrada para remover ruídos.

• error.expected != true

  : Este é o padrão. Ele oculta todos os grupos de erros que possuem apenas erros esperados e marca os grupos de erros que possuem uma mistura de erros esperados e inesperados com a tag "Contém esperado".

• error.expected = true

  : este filtro mostrará grupos de erros onde alguns ou todos os erros do grupo são esperados. Isso pode ser útil para identificar quais erros estão marcados como esperados.

• A remoção do filtro error.expected mostrará todos os grupos de erros, independentemente de eles conterem erros marcados como esperados ou não.

• Erros esperados são sempre removidos da notificação.

• Todos os recursos acima, bem como a tag erro esperado estão disponíveis para erros posteriores a 21 de janeiro de 2023.

Detalhes do erro

Clicar em um grupo de erros específico leva você à página de detalhes do erro, onde encontrará o contexto completo do problema. Este contexto pode ajudá-lo a fazer a triagem do erro e atribuí-lo à equipe ou indivíduo correto.

Veja como funcionam as várias guias da página de detalhes:

Guia Ocorrências

A guia Occurrences inclui não apenas o número e a frequência dos erros, mas também conta relacionada, stack trace, distributed tracing, contexto de login e informações de atribuição de erros.

Na visualização detalhada, você pode percorrer erros específicos usando o botão de alternância no canto superior direito para navegar entre a primeira instância do erro, a última ou qualquer instância intermediária.

Se você configurou distributed tracing e se houver amostras de rastreamento relacionadas a erros, você verá opções para visualizar detalhes trace . Esta é uma maneira rápida de visualizar informações trace sem acessar a página principal distributed tracing :

• No painel esquerdo denominado Distributed traces, você pode expandir o cabeçalho para mostrar uma lista de todos os rastreamentos associados a erros neste grupo de erros. Alternativamente, você pode clicar em Explore all para abrir uma lista de todos os rastreamentos.

  

• No painel direito denominado Distributed trace, você verá o trace associado à ocorrência de erro exibida nesta página. Para ver os intervalos do trace em uma visualização em cascata:

  • Clique diretamente no nome do trace ou clique no ícone com uma seta à direita, que abre a visualização de foco em cascata que destaca extensões trace com erros.

    

  • Clique em Explore para abrir uma cascata não filtrada onde você pode clicar em todos os trechos.

Aba atributo

A guia Attributes ajuda a observar tendências interessantes em todas as ocorrências de erros dentro de um grupo de erros específico. Você pode baixar essas informações como um arquivo CSV para análise posterior. Ao clicar em uma barra de atributo, uma tabela é renderizada mostrando o detalhamento de atributo e contagens.

Você também pode enviar um atributo personalizado.

Guia Atividade

A guia Activity exibe um log das alterações de status e atribuições de usuário de um grupo de erros.

Guia Discussões

A guia Discussions oferece espaço para colaboração detalhada e organizada. Isso é fundamental para envolver os colaboradores e garantir que toda a equipe tenha o mesmo contexto, independentemente de onde estejam. As discussões incluem:

• Threaded conversations

  : responda diretamente aos comentários de nível superior para vincular as respostas a postagens específicas.

• Comment deletion

  : Exclua comentários. O conteúdo da postagem será removido, a menos que seja pai de um tópico; nesse caso, a caixa permanecerá com a mensagem Comment deleted by user.

• Markdown support

  : adicione estilo e links aos seus comentários no Markdown.

Atribuir erros

Você pode atribuir um grupo de erros a qualquer pessoa. Basta selecionar o usuário no menu dropdown de atribuição. Você também pode atribuir um erro a qualquer endereço de e-mail, mesmo que ele não seja usuário do New Relic.

Você pode atualizar o filtro na Errors Inbox para mostrar apenas os erros atribuídos a você ou a um colega de equipe.

Perfil do usuário na Errors Inbox

As restrições de função padrão (somente leitura, padrão etc.) são aplicadas apenas no recurso de comentários do grupo de erros da Errors Inbox. Fora da capacidade de comentários, as restrições de função não são aplicadas. Portanto, um usuário somente leitura tem a capacidade de atribuir um grupo de erros dentro de uma conta, fora da conta, e atualizar os estados do grupo de erros (como ignorado, resolvido, não resolvido).