Gerenciar os erros
Revise as exceções agrupadas do APM, marque-as como novas, conhecidas, resolvidas ou ignoradas, e feche o incidente delas com «Declarar correção».
O APM agrupa as exceções iguais em um único erro: mesmo tipo, mesma mensagem (sem os dados que mudam) e mesmo ponto do código. Em vez de mil linhas repetidas, você vê um erro com quantas vezes ocorreu, desde quando, em qual versão e um trace de exemplo.
Antes de começar
Permissão Ver no módulo APM para revisar. Para alterar o status de um erro, permissão Operar.
Revisar os erros
Entre em APM → Erros.
Escolha o Status (Todos, Novos, Conhecidos, Resolvidos ou Ignorados) e o Período.
Para cada erro, confira:
Erro: o tipo de exceção, sua mensagem e o endpoint onde ocorreu.
Serviço, No período e Total.
Visto: a última vez e desde quando existe.
Versão: a última versão onde apareceu e, se mudou, desde qual versão.
Clique em Trace para ver uma requisição real que falhou com esse erro.
Na ficha de um serviço, aba Erros e logs, o botão Ver todos abre esta página filtrada por esse serviço. Para tirar o filtro, clique em Ver todos no aviso do topo.
Os status de um erro
Status | Quando usar |
|---|---|
Novo | Recém-aparecido ou reaparecido. É o status com que ele chega |
Conhecido | Você já o viu e alguém está trabalhando nele |
Resolvido | Você o corrigiu. Ele também fica assim quando o incidente dele é fechado. Se aparecer de novo, passa sozinho para Novo e avisa outra vez |
Ignorado | Não requer ação (por exemplo, um erro de validação esperado) |
Para alterá-lo, escolha o status na lista da coluna Status.
Erros e incidentes
Um erro novo abre um incidente no Núcleo, exceto na primeira meia hora de um serviço recém-aparecido (para não avisar pelo que já falhava antes de instrumentá-lo).
Um erro que estava Resolvido e aparece de novo avisa Um erro reapareceu e abre um incidente novo (ou se soma ao incidente, se ele continuar aberto).
No próprio serviço do ARGUNIS, a sessão expirada e a senha ou o código de verificação incorretos ao entrar não contam como erro (já ficam na auditoria).
Se o serviço tiver os alertas silenciados, não são abertos incidentes.
Os incidentes de erros do APM não se fecham assim que o erro deixa de ocorrer. Eles se fecham de quatro formas:
Declarar correção: a forma recomendada. Abra o incidente em Núcleo → Incidentes, clique em Declarar correção, descreva o que foi corrigido ou alterado e confirme. O incidente é fechado, a descrição fica no histórico dele e na auditoria, e o fechamento é notificado como uma recuperação.
Novo deploy: se você implantar uma nova versão do serviço (com outro
service.version) e o erro não voltar a aparecer nos 30 minutos seguintes, o ARGUNIS fecha o incidente sozinho e indica a versão.Dias sem se repetir: se o erro não voltar a aparecer nos dias de Fechar erros que não se repetem (dias) (por padrão 2; ajusta-se nos limites da empresa ou do serviço), o ARGUNIS fecha o incidente sozinho, com a nota «resolvido: o erro não se repetiu em 2 dias», e notifica o fechamento.
Taxa de erros normal: o incidente «Erros em …» (taxa acima do limite) se fecha sozinho quando a taxa fica 30 minutos abaixo do limite.
Os erros de cliente (HTTP 4xx, como 404 ou 409) ficam em APM → Erros e como evento, mas não abrem incidente.
Resolver manualmente a partir do incidente.
Quando o incidente é fechado, por qualquer uma dessas formas, o erro passa a Resolvido nesta lista (a menos que esteja Ignorado). Assim, se ele aparecer de novo, o ARGUNIS o detecta como uma reaparição e abre um incidente novo.
O contrário não funciona: marcar o erro como Resolvido em APM → Erros não fecha o incidente dele. O status do erro organiza a lista do APM; o incidente é fechado pelo Núcleo.