Se uma operação de API na sua aplicação SAE apresentar lentidão ou falhas, o monitoramento de API fornece os dados necessários para diagnosticar o problema. Para cada operação, analise chamadas SQL e NoSQL, inspecione exceções Java, rastreie dependências upstream e downstream e consulte traces individuais.
Pré-requisitos
Antes de começar, verifique se você possui:
Uma aplicação SAE implantada e em execução
Um agente de monitoramento de aplicação anexado à sua aplicação
Frameworks suportados
Os agentes de monitoramento detectam e instrumentam automaticamente as operações de API expostas pelos seguintes frameworks web e de chamada de procedimento remoto (RPC):
|
Framework |
Versão mínima |
|
Tomcat |
7+ |
|
Jetty |
8+ |
|
Resin |
3,0+ |
|
Undertow |
1,3+ |
|
WebLogic |
11,0+ |
|
SpringBoot |
1.3.0+ |
|
HSF |
2.0+ |
|
Dubbo |
2,5+ |
Visualizar chamadas de API
Faça login no console do SAE. No painel de navegação à esquerda, escolha Applications > Applications. Selecione uma região na barra de navegação superior e um namespace na lista suspensa Namespace e clique em o nome da aplicação.
No painel de navegação à esquerda, escolha Application Monitoring > API Calls.
O painel esquerdo da página API Calls lista todas as operações de API detectadas automaticamente pelos agentes de monitoramento. Ordene a lista para priorizar sua investigação:
|
Opção de ordenação |
Mais indicado quando |
|
Response time (RT) |
For necessário encontrar as operações mais lentas |
|
Number of requests |
O objetivo for identificar as operações com maior tráfego |
|
Number of errors |
For preciso localizar as operações com mais falhas |
|
Number of exceptions |
For necessário buscar as operações que geram mais exceções Java |
As métricas disponíveis variam conforme a linguagem de programação. Verifique as métricas correspondentes à linguagem da sua aplicação.
Categorias de métricas
Selecione uma operação de API no painel esquerdo para visualizar suas métricas detalhadas nas abas a seguir.
Visão geral
A aba Overview exibe a topologia de chamadas da operação de API selecionada e gráficos de séries temporais para:
Número de solicitações
Número de erros
Response time (RT)
Códigos de status HTTP
Análise de SQL e análise de NoSQL
As abas SQL Analysis e NoSql Analysis listam as instruções SQL e NoSQL executadas no código da operação de API selecionada. Use essas abas para identificar instruções que causam respostas lentas.
Para qualquer instrução, clique em Trace Query na coluna Actions para visualizar o trace completo que contém a execução SQL ou NoSQL.
Análise de exceções
A aba Exception Analysis mostra as exceções Java lançadas pelo código da operação de API selecionada.
Para qualquer exceção, clique em Interface Snapshot na coluna Actions para visualizar o trace completo onde reside a pilha de exceções. Para obter mais informações, consulte Visualizar traces.
Serviços upstream e serviços downstream
As abas Upstream Services e Downstream Services apresentam as métricas de desempenho — tempo de resposta, número de solicitações e número de erros — dos serviços que chamam sua aplicação e dos serviços chamados por ela.
As abas Upstream Traces e Downstream Traces permitem explorar detalhes no nível de trace:
Clique em Expand/Collapse All para mostrar ou ocultar todas as operações de API simultaneamente.
Insira uma palavra-chave na caixa de pesquisa e clique em o ícone Search para filtrar por nome da aplicação ou da operação de API.
Clique em o painel recolhível ou na seta ao final de uma linha para mostrar ou ocultar as métricas de desempenho de uma operação de API específica.
Análise de erros
A aba Error Analysis exibe erros e códigos de status HTTP da aplicação. Clique em um valor na coluna TraceId para abrir os detalhes do trace em uma nova página. Para obter mais informações, consulte Visualizar traces.
Interface Snapshot
A aba Interface Snapshot apresenta os parâmetros da operação de API selecionada, além de dois gráficos e uma tabela de detalhes de trace:
Gráfico Total Traces: Exibe o número total de chamadas e a quantidade de chamadas lentas. Uma chamada é considerada lenta quando seu RT ultrapassa 500 milissegundos. Ajuste esse limiar nas configurações da aplicação. Chamadas locais geradas em cenários assíncronos são excluídas da contagem de chamadas lentas.
Gráfico RT: Mostra a tendência do tempo de resposta ao longo do tempo. O gráfico reflete estatísticas de chamadas e sofre influência da taxa de amostragem configurada.
Tabela de detalhes de trace: Lista traces individuais. Clique em um valor na coluna TraceId para visualizar todos os detalhes do trace. Para obter mais informações, consulte Consulta de trace. Clique em View Logs na coluna Actions para visualizar os logs de uma chamada específica.
Para utilizar IDs de trace na correlação de logs durante a solução de problemas, associe os IDs de trace aos logs de negócios da sua aplicação. Para obter mais informações, consulte Associar IDs de trace a logs para uma aplicação Java .