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.
Relacionados
- 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