Métricas
A página Metrics (barra lateral > Metrics) oferece uma visão analítica mais profunda do seu uso da API. Ela mostra a distribuição geral dos resultados e detalha o tráfego por chave de API, IP do cliente ou domínio de destino.
Para visualizar cartões de resumo e gráficos de linha do tempo em tempo real (Concurrency, Requests, Bytes, Response Time, Budget), use a página Dashboard Overview.
Filters
Dois controles ficam acima da página: um seletor de chave de API e um seletor de intervalo.
Key Filter
Use a lista suspensa API Key para limitar a página a uma chave específica. Apenas as chaves dentro do seu escopo de acesso aparecem: chaves pessoais, chaves de organizações que você administra ou chaves compartilhadas por meio de equipes.
Interval Selector
Use os botões de intervalo para controlar a janela de tempo:
| Button | Window |
|---|---|
| 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 o que você escolher.
Outcome Distribution
Um gráfico de rosca na parte superior mostra a divisão de sucesso/erro para o intervalo selecionado. Passe o mouse sobre qualquer fatia para ver a contagem exata de requisições e a porcentagem. Use-o para identificar rapidamente se uma queda repentina na taxa de sucesso se alinha com uma categoria de resultado específica.
Outcome Types
Toda requisição de API é classificada em exatamente um resultado. Apenas success conta contra sua cota faturável.
| Outcome | Layer | Meaning |
|---|---|---|
success |
n/a | A requisição entregou uma resposta válida. Sem regras validate, isso significa HTTP 200. Se você enviou regras validate, qualquer resposta que suas regras aceitaram conta como sucesso, não importa o status HTTP. |
application_error |
target | O alvo retornou HTTP 200, mas o corpo da resposta continha um campo de erro. |
application_fail |
target | O alvo retornou um status não-2xx que suas regras validate não aceitaram, ou nenhuma resposta. |
client_error |
caller | Sua requisição foi rejeitada antes de sair da FourA: parâmetros ruins, valor de proxy malformado ou uma URL que resolve para um IP privado/reservado (proteção SSRF). |
rate_limit |
FourA | A requisição foi rejeitada pelo seu limite de RPM ou de simultaneidade. Consulte Rate Limits. |
service_error |
FourA | O backend retornou um 5xx ou respondeu com um corpo que não conseguimos processar. |
service_fail |
FourA | Uma falha de rede: timeout, conexão recusada, erro de DNS, cliente desconectado. |
A coluna layer diz de quem é a responsabilidade: target significa o site que você chamou, caller significa que sua requisição era inválida, FourA significa que não conseguimos processá-la.
Se você usar validate.status.accept para permitir códigos não-200 específicos (por exemplo [200, 403]), essas respostas voltam como success em vez de application_fail. A classificação segue o veredito da engine sobre as suas regras, não o código HTTP bruto.
Para ver a taxonomia completa e como ela é mapeada para o faturamento, consulte Request Outcomes.
Multi-View Usage Table
Abaixo do gráfico de rosca, uma tabela de uso detalha seu tráfego com três guias de visualização:
| Guia | Agrupa dados por |
|---|---|
| API Key | Cada uma das suas chaves de API |
| Client IP | Endereços IP de origem fazendo requests |
| Domain | Domínios de destino nos seus requests |
Cada guia suporta chips de escopo à direita que alteram as colunas exibidas:
| Escopo | O que mostra |
|---|---|
| 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 simultâneos (apenas na visualização API Key) |
| Outcomes | Contagem de requests mais um detalhamento por resultado |
| Budget | Contagem de requests e créditos gastos, divididos por produto (Single, Proxy, Browser) |
O escopo Budget lê a métrica credits gravada pela API em cada request (veja Response Headers). As somas são o gasto medido bruto; o faturamento conta apenas o resultado success contra o seu plano.
Clique no cabeçalho de uma coluna para ordenar por ela. O estado de ordenação persiste por tabela em diferentes carregamentos de página. Clique com Ctrl ou Cmd em um cabeçalho para redefinir.
Relacionado
- Dashboard Overview: Estatísticas em tempo real e gráficos de linha do tempo
- Request Outcomes: Os sete valores de resultado explicados em detalhes
- Response Headers: De onde vêm os créditos
- API Errors: Como os erros retornam pela rede