Quando os erros de uma aplicação aumentam repentinamente, é essencial identificar rapidamente o que falhou, a frequência e o motivo. A análise de erros no Application Real-Time Monitoring Service (ARMS) destaca erros HTTP e exceções não capturadas nas instâncias da sua aplicação. O recurso oferece gráficos de séries temporais para identificar tendências e links diretos para rastreamentos distribuídos e logs de negócios, facilitando a investigação da causa raiz.
O que é considerado um erro
O ARMS classifica uma chamada de API como erro quando a resposta indica uma falha visível para o chamador:
|
Tipo de erro |
Critério |
|
Erros HTTP |
Qualquer resposta HTTP com código de status superior a 400 |
|
Exceções não capturadas |
Informações explícitas de erro retornadas quando uma instrução |
Excluir códigos de status HTTP da análise de erros
Nem todos os códigos de status HTTP representam erros que exigem ação. Por exemplo, talvez você queira excluir as respostas 404 da análise de erros se elas forem esperadas na sua aplicação.
Para excluir códigos de status HTTP específicos, configure condições de filtro na aba Custom Configuration da página Application Settings. O ARMS ignora os códigos de status excluídos durante a análise.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma aplicação monitorada pelo Application Monitoring. Para obter instruções de configuração, consulte Visão geral
Abrir a página de análise de erros
Faça login no console do ARMS. No painel de navegação à esquerda, escolha Application Monitoring > Applications.
-
Na página Applications, selecione uma região na barra de navegação superior e clique em nome da aplicação.
NotaSe o ícone
aparecer na coluna Language, a aplicação está conectada ao Application Monitoring. Se um hífen (-) for exibido, a aplicação está conectada ao Managed Service for OpenTelemetry. No painel de navegação à esquerda, clique em Application Details.
-
Selecione uma instância da aplicação, defina o período e clique em aba Error Analysis.
Monitorar contagens de erros ao longo do tempo
A seção Errors exibe uma curva de série temporal com as contagens de erros no período selecionado. Utilize este gráfico para identificar picos de erros e correlacioná-los com implantações ou alterações de configuração.
|
Ação |
Descrição |
|
Passe o mouse sobre o gráfico |
Visualize a contagem de erros em um momento específico |
|
Clique e arraste |
Aplique zoom em um intervalo de tempo mais restrito |
|
Clique em ícone |
Consulte estatísticas de erros de um período específico ou compare contagens entre datas diferentes dentro da mesma janela de tempo. Esse recurso é útil para verificar correções ou detectar regressões após uma implantação. |
|
Clique em ícone |
Acesse os detalhes da API da métrica |
Detalhar erros por código de status HTTP
A seção HTTP - Status Code apresenta curvas de série temporal das estatísticas de códigos de status HTTP da aplicação no período selecionado. Use este gráfico para identificar quais códigos de status (como 404, 500 ou 502) contribuem para os picos de erros.
|
Ação |
Descrição |
|
Passe o mouse sobre o gráfico |
Veja estatísticas detalhadas em um ponto específico do tempo |
|
Clique e arraste |
Faça zoom em um intervalo de tempo menor |
|
Clique em uma entrada da legenda |
Mostre ou oculte dados de um código de status específico |
|
Clique em ícone |
Analise estatísticas de um período determinado ou compare os mesmos períodos em datas distintas |
|
Clique em ícone |
Verifique os detalhes da API da métrica |
Investigar erros individuais
A lista de erros exibe todos os erros individuais ocorridos durante o período selecionado. A partir dessa lista, é possível examinar o rastreamento distribuído de um erro específico ou visualizar seus logs de negócios associados para identificar a causa raiz.
Rastrear um erro pela cadeia de chamadas
Clique em um ID de rastreamento na coluna TraceId para abrir o rastreamento distribuído desse erro. O rastreamento mostra toda a cadeia de chamadas entre serviços, ajudando a localizar exatamente onde ocorreu a falha. Para mais informações, consulte Consulta de rastreamento.
Visualizar logs de negócios de um erro
Clique em View Logs na coluna Actions para visualizar os logs de negócios associados ao erro.
Para usar este recurso, é necessário associar previamente os IDs de rastreamento aos logs de negócios da sua aplicação. Sem essa associação, o ARMS não consegue vincular logs a erros específicos. Para obter instruções de configuração, consulte Associar IDs de rastreamento a logs de negócios.