A página API Request no Browser Monitoring rastreia todas as chamadas de API da sua aplicação web. Use-a para identificar endpoints lentos, requisições com falha e padrões de erro antes que afetem os usuários.
|
Problema |
Onde verificar |
|
Quais APIs estão falhando? |
Aba Success Rate -- classifica os endpoints por taxa de sucesso para destacar APIs instáveis. |
|
Quais erros estão sendo retornados? |
Aba Message -- agrupa chamadas de API por mensagem de resposta, ordenadas por volume. |
|
Quais APIs bem-sucedidas são mais lentas? |
Aba Success RT -- classifica os endpoints pelo tempo de resposta (RT) médio das chamadas bem-sucedidas. |
|
As falhas também são lentas? |
Aba Failure RT -- exibe o RT médio das chamadas com falha ao lado do volume de falhas. |
|
O problema é regional ou específico de dispositivo? |
Seções Geographical View, Terminal View e Version View -- detalham todas as métricas por localização, navegador, SO, dispositivo, resolução e versão do aplicativo. |
Métricas
A página API Request exibe quatro métricas principais para cada endpoint de API monitorado:
Success rate -- porcentagem de chamadas com resposta bem-sucedida.
Response messages -- mensagens de resposta de cada API, classificadas por volume de chamadas.
Average RT for successful calls -- tempo médio de conclusão das requisições bem-sucedidas.
Average RT for failed calls -- tempo decorrido até o retorno de erro nas requisições com falha.
É possível detalhar todas as quatro métricas em seis dimensões: localização geográfica, navegador, sistema operacional, dispositivo, resolução e versão.
Investigar taxas de sucesso de API
A aba Success Rate à esquerda classifica todas as APIs monitoradas pela taxa de sucesso das chamadas.
Selecione uma API para visualizar:
API Success Rate (painel direito) -- gráfico de série temporal com o volume de chamadas e a taxa de sucesso no intervalo selecionado.
API Link Trace (TOP 20) (painel direito) -- os 20 principais traces bem-sucedidos e com falha dessa API. Clique em Link Trace na coluna Actions para inspecionar o trace distribuído. Clique em View Details para ver os dados completos da requisição e da resposta.
Os detalhes do trace conectam as chamadas de API do frontend ao processamento do backend. Isso ajuda a determinar se o problema tem origem no código do cliente, na latência de rede ou no serviço de backend. Se uma API apresentar queda repentina na taxa de sucesso, analise os traces com falha para verificar timeouts de backend, erros de autenticação ou códigos de status inesperados.
Analisar mensagens de resposta de API
A aba Message à esquerda agrupa todas as respostas de API por mensagem e as classifica pelo volume total de chamadas.
Selecione uma mensagem para abrir o painel Message Request Details à direita. Esse painel lista todas as chamadas de API que retornaram essa mensagem, ordenadas por volume de chamadas em ordem decrescente.
Caso uma única mensagem de erro domine a lista, ela representa o principal alvo de depuração.
Verificar tempo de resposta para chamadas bem-sucedidas
A aba Success RT à esquerda classifica as APIs pelo RT médio das chamadas bem-sucedidas.
Selecione uma API para visualizar o painel Success API Response Time à direita, que exibe:
Gráfico de linhas do RT médio ao longo do tempo.
Gráfico de barras do volume total de chamadas bem-sucedidas ao longo do tempo.
Correlacione o RT com o volume de chamadas para distinguir lentidão real de outliers de baixo tráfego. Um pico de RT acompanhado de alto volume de chamadas geralmente indica um problema real de desempenho.
Verificar tempo de resposta para chamadas com falha
A aba Failure RT à esquerda classifica as APIs pelo RT médio das chamadas com falha.
Selecione uma API para visualizar o painel Failure API Response Time à direita, que exibe:
Gráfico de linhas do RT médio das chamadas com falha ao longo do tempo.
Gráfico de barras do volume total de chamadas com falha ao longo do tempo.
RT elevado em chamadas com falha frequentemente aponta para timeouts de backend, e não para erros de cliente com retorno rápido. Compare com a aba Message para verificar se falhas lentas se correlacionam com mensagens de erro específicas.
Detalhar métricas por localização
A seção Geographical View detalha as métricas de API por localização do usuário. Duas abas estão disponíveis:
China View -- estatísticas agregadas por província dentro da China.
World View -- estatísticas agregadas por país ou região em todo o mundo.
Use esta visualização para identificar problemas de desempenho ou confiabilidade específicos de uma região, que podem indicar problemas de CDN, DNS ou nível de rede.
Detalhar métricas por terminal
A seção Terminal View detalha as métricas de API pelo ambiente do cliente. Quatro abas estão disponíveis:
|
Aba |
O que exibe |
|
Browser |
Métricas agrupadas por tipo de navegador (Chrome, Firefox, Safari, etc.) |
|
OS |
Métricas agrupadas por sistema operacional |
|
Device |
Métricas agrupadas por tipo de dispositivo |
|
Resolution |
Métricas agrupadas por resolução de tela |
Se falhas ou respostas lentas se concentrarem em um navegador ou SO específico, o problema pode estar relacionado à compatibilidade do SDK ou ao comportamento da API específico do navegador.
Detalhar métricas por versão
A seção Version View exibe métricas agrupadas por versão do host e versão do aplicativo.
Compare a versão atual com versões anteriores após uma implantação para confirmar se uma nova release introduziu regressões de desempenho ou confiabilidade.
Controles da página
Estes controles estão disponíveis em todas as abas da página API Request:
Ordenar listas -- em qualquer aba à esquerda, clique em no ícone de seta para alternar entre ordem crescente e decrescente.
-
Alternar entre visualizações de gráfico e tabela -- em qualquer painel à direita, clique em no ícone de lista no canto superior direito para alternar entre as visualizações de gráfico e tabela.
-
Definir intervalo de tempo personalizado -- em qualquer painel à direita, clique em no ícone de relógio no canto superior direito para selecione um intervalo de tempo específico para os dados exibidos.
