Visão geral do Dashboard
O Dashboard da FourA é onde você gerencia chaves de API e usuários de proxy, executa requisições de teste, monitora o desempenho, cuida do faturamento e configura a sua conta. Esta página apresenta a tela principal de Visão Geral e as seções da barra lateral.
Acessando o Dashboard
Faça login em foura.ai/dashboard. Você precisa de uma conta FourA: cadastre-se aqui se você não tiver uma.
Dois Produtos, Um Conjunto de Páginas
Overview, Metrics e Activity abrem em um seletor de Product com duas opções:
| Produto | O que contabiliza | Unidade |
|---|---|---|
| API | As requisições enviadas para /api/single, /api/proxy, /api/browser e /api/auto |
Requisições e créditos |
| Proxy | Os túneis que as suas próprias ferramentas abrem através de proxy.foura.ai |
Túneis e bytes |
Um túnel transporta o que o seu cliente enviar por ele, e o que acontece dentro de um CONNECT é o seu próprio tráfego criptografado. Portanto, as visualizações de Proxy contabilizam túneis e bytes, nunca requisições ou créditos. Leia Proxy Port sobre o produto em si.
O seletor está sempre em uma das duas opções, é memorizado entre visitas e fica no endereço como #overview/proxy, #metrics/proxy ou #activity/proxy. Cole um desses links e a página abrirá diretamente naquele produto.
Não confunda o produto Proxy com a tag do endpoint Proxy Finder. Proxy Finder é POST /api/proxy/, um dos quatro endpoints da API. O produto Proxy é a porta de proxy.
Página Overview, Produto API
A página inicial após o login mostra seus números principais para o período selecionado.
Antes da Sua Primeira Requisição
Até que sua primeira requisição chegue, a visualização da API exibe dados de exemplo, com uma tag Sample em cada painel e gráfico, sob um banner This is sample data. com duas etapas: Create API key, cuja nova chave é exibida com um comando de teste, e Open Playground para enviar uma requisição. Em um celular ou tablet, as etapas direcionam você para o Playground, pois um telefone não pode executar o comando. Sua primeira requisição real substitui os dados de exemplo definitivamente.
A visualização de Proxy tem seu próprio banner No traffic yet. com Create proxy user e Open Proxy, exibido até que um dos seus usuários de proxy trafegue dados. Fechar qualquer um dos banners oculta ambos.
Cards de Resumo
Cinco painéis na parte superior, e um sexto quando o Auto executou algo no período:
| Painel | O que mostra |
|---|---|
| Concurrency | Requests em execução simultânea neste momento, além da média e do máximo para o período |
| Requests | Total de chamadas, seguido por Single, Proxy, Browser e Auto, cada um com sua porcentagem do total abaixo. Uma chamada Auto conta apenas uma vez, sob Auto. |
| Auto attempts | Exibido apenas quando o Auto executou algo no período. Os requests de Single, Proxy e Browser feitos pelo Auto por trás das suas chamadas Auto, com as tentativas por chamada Auto. Eles nunca contam como requests ou na taxa de sucesso, e seus créditos estão dentro dos créditos do Auto. Eles contam contra os seus limites de taxa e de concorrência do Single, Proxy e Browser. |
| Credits | Créditos faturados como o valor principal, créditos gastos logo abaixo, para o total e para cada produto, Auto incluído |
| Bytes | Dados transferidos: In é o que você enviou, Out é o que retornou, e Premium é a parte desse tráfego que passou por uma saída premium, quer essa saída tenha entregue a página ou não. O valor Premium está contido dentro dos dois totais e nunca é somado a eles. |
| Response Time | Média, mínimo e máximo ao longo do período |
Faturado e gasto são números diferentes. Apenas um request bem-sucedido é faturado, então o faturado é o que você paga. Gasto inclui qualquer resultado, pois um request com falha ainda consome um proxy ou um browser. Ler um com o nome do outro faz com que a mesma conta pareça ter dois comportamentos diferentes em páginas distintas. Consulte Request Outcomes para ver quais resultados são faturados.
Os painéis Requests e Credits rotulam os quatro endpoints como Single, Proxy, Browser e Auto. A linha de filtro Endpoints acima deles chama Proxy de Proxy Finder, que se refere à mesma coisa: POST /api/proxy/.
A soma dos quatro nem sempre corresponde ao total. Um pequeno número de chamadas não utiliza nenhum deles; essas chamadas são incluídas no total, mas em nenhum endpoint específico.
Timeline Charts
Abaixo dos painéis, seis gráficos de linha do tempo exibem o volume de requests, gasto de créditos, detalhamento de resultados, tempo de resposta, largura de banda e concorrência. Cada gráfico possui uma alternância no cabeçalho que substitui o gráfico pela tabela correspondente.
Overview Page, Proxy Product
Mude Product para Proxy e a mesma página responderá em túneis. Quatro painéis:
| Painel | O que mostra |
|---|---|
| Tunnels at Once | Túneis abertos no mesmo instante. Current cobre os últimos segundos e atualiza a cada cinco; Avg e Max cobrem o período. Seu plano limita isso para todos os seus usuários de proxy somados. |
| Tunnels | Success e Failed, cada um com sua fatia do total. Failed engloba qualquer outro resultado, e a linha Outcome indica qual foi. |
| Traffic | In é o que suas ferramentas enviaram, Out é o que retornou, e Premium é a parte que saiu pela rede premium, contabilizada dentro dos totais em vez de adicionada a eles. |
| Setup Time | Tempo de espera médio (Avg), mínimo (Min) e máximo (Max) antes de um túnel ser disponibilizado, considerando apenas túneis bem-sucedidos. É a espera antes do seu primeiro byte, não a velocidade do site atrás do túnel. |
Cinco gráficos de linha do tempo ficam abaixo deles: Tunnel Timeline, Outcome Timeline, Setup Time Timeline, Traffic Timeline e Tunnels at Once Timeline. Cada um possui a mesma alternância entre gráfico ou tabela que os gráficos da API.
Três painéis ficam esmaecidos enquanto uma pill de Outcome está ativa, e o motivo em cada caso é que o número não existe para esse resultado. Tunnels at Once fica esmaecido sob qualquer resultado. Setup Time e Traffic ficam esmaecidos sob um resultado de falha e exibem uma badge Success only, porque um túnel com falha nunca foi entregue e não transportou nada.
Period e Detail
Period indica até onde no passado você está olhando. Oito pills mais Custom:
| Pill | Intervalo |
|---|---|
| 30M | Últimos 30 minutos |
| 3H | Últimas 3 horas |
| 12H | Últimas 12 horas |
| 24H | Últimas 24 horas |
| 7D | Últimos 7 dias |
| 30D | Últimos 30 dias |
| 90D | Últimos 90 dias |
| 1Y | Últimos 12 meses |
Custom abre uma caixa de diálogo com quatro predefinições, This month, Last month, Last 6 months e All time, além de um par de datas From e To. Um intervalo de datas se estende até o final do dia escolhido, nunca ultrapassando o momento atual.
Detail define a largura de cada barra: por minuto, a cada 5 minutos, a cada 30 minutos, a cada hora, a cada 6 horas, diário, semanal ou mensal. O padrão é Auto, que seleciona o intervalo mais amplo que ainda mantenha pelo menos quinze barras no gráfico, para que um ano seja exibido como um formato visível em vez de 365 linhas finas. A opção Auto mostra o nome do intervalo escolhido.
Period e Detail se aplicam a ambos os produtos.
Os intervalos de Detail que retrocedem além do período retido pelo FourA para essa resolução ficam esmaecidos em vez de ocultos:
| Resolução | Alcance no passado |
|---|---|
| Por request | 7 dias |
| 5 minutos | 30 dias |
| Por hora | 12 meses |
| Diária | Todo o histórico |
Se você escolher um período mais antigo do que um nível permite, as opções mais detalhadas ficam esmaecidas. O modo Auto nunca seleciona uma delas, garantindo que um gráfico nunca fique vazio devido à agregação dos dados.
Filters
Os filtros se acumulam e combinam, e Period e Detail ficam ao lado deles.
| Filtro | Produto | O que faz |
|---|---|---|
| Product | ambos | API ou Proxy |
| Endpoints | API | Limita o escopo a um endpoint: Single, Proxy Finder, Browser ou Auto. Uma chamada Auto conta uma única vez, em Auto; as requests Single, Proxy e Browser geradas pela sua sequência em segundo plano são listadas por nome no painel de tentativas de Auto, nunca como requests individuais. |
| Outcome | ambos | Isola uma categoria. A API oferece todas as sete; o produto Proxy oferece as cinco opções de encerramento de um túnel. |
| Owner | ambos | Everything, Personal ou uma das suas organizações. Aparece apenas se você pertencer a pelo menos uma. |
| Key | API | Restringe a uma única chave de API |
| Proxy user | Proxy | Restringe a um único usuário de proxy |
O painel e o gráfico de Concurrency no lado da API não aceitam o filtro de Endpoints ou Outcome. Ambos ficam esmaecidos enquanto qualquer um estiver ativo, e o gráfico indica isso em seu cabeçalho.
O filtro Owner
O menu suspenso Owner responde a "de quem é o tráfego que estou visualizando". Ele oferece Everything, Personal e uma entrada para cada organização à qual você pertence, e o mesmo controle em Metrics, Activity, API Keys e Proxy segue a sua escolha, garantindo que as páginas nunca entrem em conflito.
As seções Usage & Limits e Billing deliberadamente não o utilizam. Elas respondem a "o que é faturado para mim", o que, no seu caso, inclui suas chaves pessoais e usuários de proxy, além daqueles das organizações das quais você é proprietário. Consulte Organizations.
Sidebar Sections
Onze seções em quatro grupos: Dashboard, Tools, Access e Account.
Dashboard: Overview, Metrics, Activity
As três páginas que respondem a "o que aconteceu". Todas as três possuem o seletor de Product.
Overview é a página acima e sempre o ponto de partida após o login.
Metrics contém o painel Usage: um detalhamento agrupado por chave de API, IP do cliente ou domínio no lado da API, e por usuário de proxy, destino, país de saída, IP do cliente ou resultado no lado do Proxy, com cartões para todo o período acima de uma tabela paginada. Consulte o guia de Metrics.
Activity é um feed em tempo real da última hora. No lado da API, cada linha representa uma request: método, domínio de destino, status, resultado, duração, tamanho da transferência e créditos. No lado do Proxy, cada linha representa um túnel: usuário de proxy, destino, saída, resultado, configuração, duração, bytes e IP do cliente. Consulte o Activity Log.
Tools: Playground, Extension
Teste requests em tempo real com sua chave de API real sem escrever nenhum código. Escolha Auto, Single, Proxy ou Browser, defina uma URL, ajuste flags e timeouts e clique em Send. Salve configurações comuns como predefinições e repita qualquer uma das suas últimas 20 execuções a partir do History.
O uso consome a cota da chave, da mesma forma que uma chamada em produção consumiria. Consulte o guia do Playground.
Extension, marcada como Beta, é onde você baixa a extensão FourA para o Chrome. Seu popup direciona o Chrome através de um dos seus usuários de proxy, e sua aba FourA no DevTools transforma qualquer request feita por uma página em uma chamada de API pronta. Consulte Chrome Extension.
Access: API Keys, Proxy
API Keys é onde você cria, visualiza e gerencia as chaves que suas aplicações usam para chamar a API. As chaves usam o prefixo pk_live_. Consulte Managing API Keys.
Proxy é onde você cria usuários de proxy e copia uma string de conexão para qualquer cliente que aceite uma URL de proxy. Os túneis e o tráfego pela porta contam para o seu plano, da mesma forma que a API. Consulte Proxy Users e a referência de Proxy Port.
Account: Organizations, Usage & Limits, Billing, Settings
Organizations compartilham chaves de API e usuários de proxy com colegas sob um único proprietário. Adicione pessoas por e-mail, defina a função delas e transfira a organização quando a titularidade precisar mudar. O uso em uma credencial de organização é cobrado no plano do proprietário da organização. Consulte Organizations.
Uso e Limites mostra seu plano, o que você utilizou neste período de faturamento e cada limite aplicado a você, com detalhamento por chave, por endpoint e por usuário de proxy. Veja Uso e Limites.
Faturamento gerencia sua assinatura, compra mais créditos ou tráfego, armazena métodos de pagamento e faturas, e mostra os créditos, tráfego e tráfego premium deste período em relação ao seu plano. Veja Faturamento e Assinaturas.
Configurações contém seu nome de exibição, senha, sessões ativas e provedores de login conectados. Alterações de e-mail não estão disponíveis no painel: entre em contato com o suporte.
Dicas
- Use o Playground antes de escrever código. Se você não sabe qual engine um novo site precisa, comece com Auto e deixe-o escolher.
- Compare o faturado com o gasto no cartão de Créditos. Um endpoint onde os dois estão muito distantes está falhando com frequência, e o relatório de tentativas explica o motivo.
- No produto Proxy, um bloco de Rate Limited na Linha do Tempo de Resultados reflete o limite do seu plano, não o destino recusando você. A visualização de Resultados em Métricas indica qual deles foi atingido.
- Mantenha suas chaves de API e usuários de proxy seguros. Desative qualquer um deles imediatamente se suspeitar de exposição.
Próximos Passos
- Autenticação: Detalhes de criação e gerenciamento de chaves de API
- Início Rápido: Faça sua primeira request a partir da CLI
- Como Seu Plano é Medido: Créditos, tráfego e qual teto se aplica a você
- Uso e Limites: Acompanhe créditos e tráfego em relação ao seu plano
- Endpoints da API: Use a API diretamente