# Métricas

> URL: https://foura.ai/pt/docs/dashboard/metrics
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

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](https://foura.ai/docs/dashboard/overview).

## 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](https://foura.ai/docs/dashboard/api-keys).

### 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](https://foura.ai/docs/api/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](https://foura.ai/docs/api/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](https://foura.ai/docs/api/outcomes).

## Relacionados

- [Dashboard Overview](https://foura.ai/docs/dashboard/overview): Cards de resumo, gráficos de linha do tempo, Period e Detail (Detail existe apenas em Overview)
- [Request Outcomes](https://foura.ai/docs/api/outcomes): Os valores de resultado explicados em detalhes, para requests e túneis
- [Response Headers](https://foura.ai/docs/api/response-headers): De onde vêm os créditos
- [Proxy Port](https://foura.ai/docs/api/proxy-port): O produto sobre o qual as visualizações de Proxy geram relatórios
- [Organizations](https://foura.ai/docs/dashboard/teams-and-orgs): O que o filtro Owner cobre
- [API Errors](https://foura.ai/docs/api/errors): Como os erros são retornados na conexão
