Métricas
A página Metrics (barra lateral > Metrics) oferece uma visão analítica mais profunda do seu uso de API. Ela mostra a sua distribuição geral de outcomes e detalha o tráfego por API key, IP do cliente ou domínio target.
Para cartões de resumo em tempo real e gráficos de linha do tempo (Concurrency, Requests, Bytes, Response Time), use a página Dashboard Overview.
Filtros
Dois controles estão posicionados acima da página: um seletor de API key e um seletor de intervalo.
Filtro de Chave
Use o menu suspenso de API Key para limitar o escopo da página a uma chave específica. Apenas chaves dentro do seu escopo de acesso são exibidas: chaves pessoais, chaves de organização que você administra ou chaves compartilhadas por meio de equipes.
Seletor de Intervalo
Use os botões de intervalo para controlar a janela de tempo:
| Botão | Janela |
|---|---|
| 1M | Último 1 minuto |
| 5M | Últimos 5 minutos |
| 30M | Últimos 30 minutos |
| 1H | Última 1 hora |
| 6H | Últimas 6 horas |
| 1D | Últimas 24 horas |
Tanto o gráfico de rosca quanto a tabela seguem a sua seleção.
Distribuição de Outcomes
Um gráfico de rosca no topo mostra o detalhamento de sucesso/erro para o intervalo selecionado. Passe o cursor sobre qualquer fatia para ver a contagem exata de requests e a porcentagem. Use-o para identificar rapidamente se uma queda repentina na taxa de sucesso se alinha a uma categoria de outcome específica.
Tipos de Outcomes
Cada request de API é classificado em exatamente um outcome. Apenas success conta contra sua cota faturável.
| Outcome | Camada | Significado |
|---|---|---|
success |
n/a | O request entregou uma response válida. Sem regras de validate, isso significa HTTP 200. Se você enviou regras de validate, qualquer response que suas regras aceitarem conta como sucesso, independentemente do status HTTP. |
application_error |
target | O target retornou HTTP 200, mas o corpo da response continha um campo de erro. |
application_fail |
target | O target retornou um status não-2xx que suas regras de validate não aceitaram, ou nenhuma response foi obtida. |
client_error |
caller | Seu request foi rejeitado antes de sair do FourA: parâmetros inválidos, valor de proxy malformado ou uma URL que resolve para um IP privado/reservado (proteção contra SSRF). |
rate_limit |
FourA | O request foi rejeitado pelo seu limite de RPM ou de concorrência. Consulte Rate Limits. |
service_error |
FourA | O backend retornou um 5xx ou respondeu com um corpo que não pudemos analisar. |
service_fail |
FourA | Uma falha de rede: timeout, conexão recusada, erro de DNS, cliente desconectado. |
A coluna de camada indica quem é o responsável: target significa o site que você chamou, caller significa que seu request estava incorreto, FourA significa que não pudemos processá-lo.
Se você usar validate.status.accept para permitir códigos não-200 específicos (por exemplo, [200, 403]), essas responses retornarão como success em vez de application_fail. A classificação segue o veredito do mecanismo sobre suas regras, não o código HTTP bruto.
Para obter a taxonomia completa e como ela se mapeia para o faturamento, consulte Request Outcomes.
Tabela de Uso Multi-Visualização
Abaixo do gráfico de rosca, uma tabela de uso detalha seu tráfego com três abas de visualização:
| Aba | Agrupa os dados por |
|---|---|
| API Key | Cada uma de suas API keys |
| Client IP | Endereços IP de origem que fazem requests |
| Domain | Domínios target em seus requests |
Cada aba suporta quatro seletores de escopo (chips) à direita que alteram as colunas exibidas:
| Escopo | O que exibe |
|---|---|
| Bandwidth | Contagem de requests, bytes de entrada, bytes de saída |
| Response Time | Contagem de requests, latência mínima, média e máxima |
| Concurrency | Contagem de requests mais contagens de requests concorrentes (apenas na visualização de API Key) |
| Outcomes | Contagem de requests mais um detalhamento por outcome |
Relacionado
- Dashboard Overview: Estatísticas em tempo real e gráficos de linha do tempo
- Request Outcomes: Os sete valores de outcome explicados em detalhes
- API Errors: Como os erros retornam pela rede