Métricas
A página Metrics (barra lateral > Metrics) oferece uma visão analítica mais detalhada do seu uso. Ela contém um painel, Usage, que divide seu tráfego em grupos e posiciona os totais de todo o período acima de uma página de linhas.
Para cartões de resumo e gráficos de linha do tempo, use a página Dashboard Overview.
Product
A página abre em um seletor de Product: API para as requests enviadas aos endpoints da API, Proxy para os túneis que suas próprias ferramentas abrem por meio do proxy.foura.ai. Cada produto tem seu próprio painel Usage com visualizações, escopos e colunas específicos, pois um túnel não possui contagem de requests nem créditos. A seleção é salva e permite link direto como #metrics/proxy.
Filters
Acima do painel: Product, Endpoints (apenas API), Owner, depois Key (API) ou Proxy user (Proxy), e Period. Owner e Period são os mesmos controles do Overview e compartilham o estado, de modo que alternar entre as duas páginas nunca altera os dados exibidos.
Filtro Owner
Everything, Personal ou uma de suas organizações. Ele só aparece quando você pertence a pelo menos uma. Selecionar um proprietário também atualiza os menus suspensos de Key e Proxy user, evitando que uma credencial do proprietário anterior permaneça ativa e não retorne nada.
Filtros Key e Proxy User
Restrinja a página a 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.
Period
Oito opções rápidas, 30M, 3H, 12H, 24H, 7D, 30D, 90D e 1Y, além de Custom 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 cartões e a tabela a um endpoint. Uma chamada Auto é contabilizada uma vez, em Auto. O escopo Concurrency não fica disponível enquanto um endpoint estiver selecionado.
O painel Usage
O painel responde a duas perguntas simultaneamente. Os cartões acima da tabela descrevem todo o período: quantos grupos ele contém e os totais de todos eles. A tabela abaixo é uma página desses grupos, ordenada pela coluna selecionada.
Ambos cobrem exatamente o mesmo tráfego: os cartões usam a mesma janela e os mesmos filtros das linhas. A contagem de grupos é exibida por extenso em vez de arredondada, pois um número exato responde a "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 o conjunto 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. A ordenação volta para o maior valor primeiro quando você altera a visualização ou recarrega a página. Use Ctrl ou Cmd e clique em um cabeçalho para redefinir.
Usage, produto API
Três visualizações:
| View | Groups data by |
|---|---|
| API Key | Cada chave à qual você tem acesso |
| Client IP | Endereços de origem que fazem as requests |
| Domain | Domínios de destino nas suas requests |
Os seletores de escopo à direita alteram as colunas e os cartões:
| Escopo | O que mostra |
|---|---|
| Bandwidth | Contagem de requests, bytes de entrada, bytes de saída e a parcela premium desses bytes (tráfego atendido por uma saída premium, incluído nos totais em vez de somado a eles) |
| Response Time | Contagem de requests, latência mínima, média e máxima |
| Concurrency | Contagem de requests mais contagens de requests simultâneos (somente visualização por API Key) |
| Outcomes | Contagem de requests mais detalhamento por outcome, com o gráfico de rosca de outcomes |
| Budget | Contagem de requests e créditos gastos, incluindo todos os outcomes. Para ver um endpoint específico, selecione-o na linha Endpoints |
O escopo Budget lê a métrica de créditos que a API informa a cada request (consulte Response Headers). Essas somas representam o gasto bruto medido. O faturamento contabiliza apenas o outcome success no seu plano, e o card Overview Credits exibe ambos lado a lado.
Gráfico de rosca de outcomes
No escopo Outcomes, um gráfico de rosca é exibido no painel mostrando a divisão entre sucessos e erros para o período selecionado. Passe o cursor sobre qualquer fatia para ver a contagem exata de requests e a porcentagem. Ele é exibido apenas nesse escopo, pois uma visão geral da janela inteira sobre uma tabela com outra finalidade pareceria desconexa.
Uso, produto Proxy
Cinco visualizações:
| Visualização | Agrupa os dados por |
|---|---|
| Proxy user | Cada usuário de proxy ao qual você tem acesso |
| Target | O host alcançado por cada túnel |
| Exit country | O país de saída do túnel |
| Client IP | O endereço de origem da conexão |
| Outcome | O outcome 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 outcome, com o gráfico de rosca de outcomes |
| Budget | Tunnels, Standard, Premium, Total |
Setup é o tempo de espera antes da entrega do túnel. Duration é o tempo em que ele permaneceu aberto. Premium é a parcela do tráfego que saiu pela rede premium, já contabilizada no 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 contabiliza túneis e bytes, e nada mais.
Tipos de outcome
Cada request de API é classificado em exatamente um outcome. Apenas success é faturado.
| Outcome | Layer | Meaning |
|---|---|---|
success |
n/a | A request entregou uma response válida. Sem regras de validate, isso significa HTTP 200. Com regras de validate, qualquer response que suas regras aceitaram, independentemente do status. |
application_error |
target | O destino retornou HTTP 200, mas o body continha um campo de erro. |
application_fail |
target | O destino retornou um status não-2xx que suas regras de validate não aceitaram, ou nenhuma response. |
client_error |
caller | Sua request foi rejeitada antes de sair do FourA: parâmetros inválidos, um valor de proxy malformado ou uma URL que resolve para um endereço privado ou reservado. |
rate_limit |
FourA | A request foi rejeitada pelo seu rate limit de RPM ou de concorrência. Consulte Rate Limits. |
service_error |
FourA | O engine respondeu com um erro de servidor ou com um body que não conseguimos analisar. |
service_fail |
FourA | Uma falha de rede: timeout, conexão recusada, erro de DNS, desconexão do cliente. |
A coluna de layer indica quem é o responsável. target indica o site que você chamou, caller indica que sua request era inválida, FourA indica que não conseguimos processá-la.
Se você usa 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 engine sobre suas regras, não o código HTTP bruto.
Um túnel através da porta de proxy é classificado no mesmo vocabulário, exceto pelos dois outcomes de target: a resposta de um túnel é seu próprio tráfego criptografado, portanto o FourA nunca vê se o site de destino respondeu com sucesso. Para ver a taxonomia completa e como ela é mapeada para o faturamento, consulte Request Outcomes.
Relacionados
- Dashboard Overview: Cartões de resumo, gráficos de linha do tempo, Period e Detail (Detail está apenas no Overview)
- Request Outcomes: Os valores de outcome 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 do Proxy geram relatórios
- Organizations: O que o filtro Owner cobre
- API Errors: Como os erros são retornados na rede