DocumentaciónAjuda

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».

Nesta página

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

  1. Entre em APM → Erros.

  2. Escolha o Status (Todos, Novos, Conhecidos, Resolvidos ou Ignorados) e o Período.

  3. 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.

  4. 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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  1. 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.

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar