Métricas

A página Métricas (barra lateral > Métricas) oferece uma visão analítica mais detalhada do seu uso. Ela contém um painel, Uso, que divide seu tráfego em grupos e posiciona os totais de todo o período acima de uma página de linhas.

Para cards de resumo e gráficos de linha do tempo, use a página Visão Geral do Dashboard.

Produto

A página abre em uma opção de Produto: API para as requisições enviadas aos endpoints da API, Proxy para os túneis que suas próprias ferramentas abrem via proxy.foura.ai. Cada produto tem seu próprio painel de Uso com visualizações, escopos e colunas específicos, já que um túnel não possui contagem de requisições nem créditos. A seleção é salva e suporta links diretos como #metrics/proxy.

Filtros

Acima do painel: Produto, Endpoints (somente API), Proprietário, depois Chave (API) ou Usuário de proxy (Proxy), e Período. Proprietário e Período são os mesmos controles da Visão Geral e compartilham o mesmo estado, portanto alternar entre as duas páginas nunca altera o que você está visualizando.

Filtro de Proprietário

Tudo, Pessoal ou uma de suas organizações. Ele só aparece após você fazer parte de pelo menos uma. Selecionar um proprietário também recarrega os menus suspensos de Chave e Usuário de proxy, garantindo que uma credencial do proprietário anterior não permaneça selecionada e retorne dados vazios silenciosamente.

Quando o proprietário selecionado não possui nenhuma chave de API, incluindo chaves interrompidas, a linha abaixo do período exibe Você ainda não tem chaves de API aqui. Crie uma para ver o uso dela. Os painéis mostram zeros porque não há nada para contabilizar. Consulte Gerenciamento de Chaves de API.

Filtros de Chave e Usuário de Proxy

Defina o escopo da página para uma única credencial. Apenas as credenciais às quais você tem acesso são exibidas: as suas e as das organizações às quais você pertence.

Período

Oito opções rápidas, 30M, 3H, 12H, 24H, 7D, 30D, 90D e 1Y, além de Personalizado para um mês do calendário, os últimos 6 meses, todo o período ou um intervalo exato de datas.

Endpoints

No produto API, selecione Single, Proxy Finder, Browser ou Auto para restringir os cards e a tabela a um único endpoint. Uma chamada Auto é contabilizada uma vez, em Auto. O escopo de Simultaneidade não fica disponível enquanto um endpoint estiver selecionado.

O Painel de Uso

O painel responde a duas perguntas ao mesmo tempo. Os cards acima da tabela descrevem todo o período: quantos grupos existem e os totais acumulados entre todos eles. A tabela abaixo exibe uma página desses grupos, ordenada pela coluna que você selecionar.

Os dois blocos sempre refletem o mesmo tráfego: os cards utilizam o mesmo intervalo e os mesmos filtros das linhas. A contagem de grupos é exibida por extenso em vez de arredondada, pois um número exato responde à pergunta "quantos domínios alcançamos este mês", enquanto um valor arredondado não.

Alterar a visualização, o escopo ou o período reinicia a listagem a partir da primeira página. A página 4 de domínios não corresponde à página 4 de IPs de clientes.

Clique no cabeçalho de uma coluna para ordenar. Nas visualizações de Domínio e IP do Cliente do produto de API, a ordenação é aplicada sobre toda a lista antes da paginação, garantindo que a primeira linha seja realmente a maior, e a tabela reinicia a partir da primeira página. A visualização de Chave de API mantém todas as chaves em uma única lista e as ordena diretamente. A ordenação retorna ao padrão do escopo ao alternar de visualização ou escopo, ou ao recarregar a página: mais requisições primeiro ou, em Rotas, mais tentativas de navegador pelo Auto. Use Ctrl ou Cmd e clique em um cabeçalho para redefinir. O cabeçalho da primeira coluna também contém um campo de filtro (Filtrar Chaves de API..., Filtrar IPs... ou Filtrar Domínios...) que filtra as linhas por nome. Nas visualizações de IP do Cliente e Domínio, a busca é feita apenas na página atual, portanto um grupo em outra página não será exibido. Use Esc para limpar.

Uso, Produto de API

Três visualizações:

View Groups data by
Chave de API Cada chave à qual você tem acesso
IP do Cliente Endereços de origem que fazem as requisições
Domínio Domínios de destino nas suas requisições

Os seletores de escopo alteram as colunas e os cards:

Scope What it shows
Largura de banda Contagem de requisições, bytes de entrada, bytes de saída e a parcela premium desses bytes (tráfego servido por saída premium, incluído nos totais em vez de somado a eles)
Tempo de resposta Contagem de requisições, latência mínima, média e máxima
Concorrência Contagem de requisições mais contagens de requisições simultâneas (apenas na visualização de Chave de API)
Resultados Contagem de requisições mais detalhamento por resultado, com o gráfico de rosca de resultados
Orçamento Contagem de requisições, créditos faturados e créditos gastos. Para visualizar um endpoint específico, selecione-o na linha de Endpoints
Rotas Contagem de requisições, suas requisições por rota, o que o Auto executou sob suas chamadas e a etapa que respondeu a cada chamada do Auto (veja abaixo)

O escopo de Orçamento mantém créditos faturados e gastos separados. Créditos faturados contabilizam apenas requisições com o resultado success: é pelo que o seu plano paga. Créditos gastos são os créditos reportados pela API a cada requisição (veja Response Headers), incluindo requisições com falha, e nunca são faturados.

Os cards de Orçamento exibem Créditos faturados com de N gastos logo abaixo, e Por requisição, a média de créditos faturados por requisição. A tabela possui as colunas Créditos faturados e Créditos gastos, e você pode ordenar por qualquer uma delas.

Escopo de Rotas

Rotas divide as requisições de cada chave, IP de cliente ou domínio por rota e mostra o que o Auto executou em suas chamadas. Suas colunas são divididas em três grupos, cada um com uma legenda superior:

Grupo Colunas O que contam
Requests by route Single, Proxy Finder, Browser, Auto Suas requests, pela rota para a qual você as enviou. Juntas, elas formam Requests. Uma chamada Auto conta uma vez, sob Auto. Abaixo de cada número: sua fatia de Requests.
Auto attempts Single, Proxy Finder, Browser As requests que o Auto executou em cada mecanismo por trás de suas chamadas, incluindo as que falharam. Abaixo de cada número: tentativas por chamada Auto.
Auto answered by Saved session, Plain request, Proxy Finder, Browser, Failed A etapa que entregou cada chamada Auto. Juntas, elas formam Auto. Abaixo de cada número: sua fatia de Auto.

Saved session é uma sessão que o Auto já possuía para o host. Browser inclui as chamadas em que um navegador abriu a página primeiro e a repetição de sua sessão a entregou. Failed inclui chamadas recusadas antes da execução do Auto.

Para ver onde o Auto usa um navegador real, consulte a coluna Browser sob Auto attempts. Um navegador geralmente abre uma página uma vez, e o Auto então reutiliza essa sessão com requests mais leves, portanto esta coluna costuma ser muito maior do que Browser sob Auto answered by. Routes abre ordenado por ela, de modo que os domínios que mais precisam de navegador apareçam primeiro; grupos sem tentativas de navegador seguem pela contagem de requests.

Os cards acima da tabela mostram as tentativas do Auto no período com as tentativas por chamada Auto, e cada navegador aberto, diretamente ou pelo Auto.

Tentativas do Auto nunca contam em Requests ou na taxa de sucesso. Elas contam para os limites de taxa e de concorrência de Single, Proxy Finder e Browser do seu plano, como no card Auto attempts da visão geral. Com um endpoint selecionado na linha Endpoints, Routes exibe apenas essa rota: Browser lista então as requests de navegador enviadas por você mesmo, e as executadas pelo Auto permanecem sob Auto.

Gráfico de Rosca de Resultados

Sob o escopo Outcomes, um gráfico de rosca fica dentro do painel e mostra o detalhamento de sucesso e erro para o período selecionado. Passe o cursor sobre qualquer fatia para ver a contagem exata de requests e a porcentagem. Ele é exibido apenas sob esse escopo, já que uma imagem de toda a janela sobre uma tabela que responde a uma pergunta diferente pareceria dois elementos desconexos.

Uso, Produto Proxy

Cinco visualizações:

Visualização Agrupa dados por
Proxy user Cada usuário de proxy ao qual você tem acesso
Target O host que cada túnel alcançou
Exit country O país de saída do túnel
Client IP O endereço de onde a conexão partiu
Outcome O resultado e seu motivo

Quatro escopos:

Escopo Colunas
Traffic Tunnels, Bytes In, Bytes Out, Premium
Setup Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max
Outcomes Tunnels mais uma coluna por resultado, com o gráfico de rosca de resultados
Budget Tunnels, Standard, Premium, Total

Setup é o tempo de espera antes da entrega de um túnel. Duration é quanto tempo ele permaneceu aberto em seguida. Premium é a parte do tráfego que saiu pela rede premium, contabilizada dentro do total e nunca somada a ele.

Nenhum escopo possui coluna de créditos ou contagem de requests. O que trafega dentro de um CONNECT é o seu próprio tráfego criptografado, portanto a porta conta túneis e bytes e nada mais.

Tipos de resultado

Cada request de API é classificado em exatamente um resultado. Apenas success é cobrado.

Resultado Camada Significado
success n/d O request entregou uma response válida. Sem regras validate, isso significa HTTP 200. Com regras validate, qualquer response que suas regras aceitaram, qualquer que seja o status. Uma página de verificação ou página de recusa reconhecida pela FourA nunca é um sucesso.
application_error target O target retornou HTTP 200, mas o body continha um campo de erro, ou o body era uma página de verificação ou de recusa reconhecida pela FourA.
application_fail target O target retornou um código não-2xx não aceito pelas suas regras validate, ou não enviou nenhuma response.
client_error caller Seu request foi rejeitado antes de sair da FourA: parâmetros inválidos, valor de proxy malformado ou uma URL que resolve para um endereço privado ou reservado.
rate_limit FourA O request foi rejeitado pelo seu limite de RPM ou de concorrência. Consulte Rate Limits.
service_error FourA O motor respondeu com um erro de servidor ou com um body que não pôde ser analisado.
service_fail FourA Uma falha de rede: timeout, conexão recusada, erro de DNS, desconexão do cliente.

A coluna de camada informa quem é o responsável. target indica o site chamado por você, caller indica que seu request era inválido, FourA indica que não foi possível processá-lo.

Se você usar validate.status.accept para permitir códigos específicos diferentes de 200 (por exemplo [200, 403]), eles retornam como success em vez de application_fail. A classificação segue o veredito do motor sobre suas regras, não o código HTTP bruto.

Um túnel pela porta de proxy é classificado no mesmo vocabulário, com exceção dos dois resultados target: a resposta de um túnel é o seu próprio tráfego criptografado, portanto a FourA nunca detecta se o site de destino respondeu satisfatoriamente. Para ver a taxonomia completa e como ela é mapeada na cobrança, consulte Request Outcomes.

  • Dashboard Overview: Cards de resumo, gráficos de linha do tempo, Period e Detail (Detail existe apenas em Overview)
  • Request Outcomes: Os valores de resultado explicados em detalhes, para requests e túneis
  • Response Headers: De onde vêm os créditos
  • Proxy Port: O produto sobre o qual as visualizações de Proxy geram relatórios
  • Organizations: O que o filtro Owner cobre
  • API Errors: Como os erros são retornados na conexão
Atualizado em: 5 de novembro de 2026