Visão Geral do Painel
O FourA Dashboard é onde você gerencia chaves de API e usuários de proxy, executa requisições de teste, monitora o desempenho, cuida do faturamento e configura sua conta. Esta página aborda a tela principal Overview 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 ainda não tiver uma.
Dois Produtos, Um Conjunto de Páginas
Overview, Metrics e Activity abrem cada um em um seletor de Product com duas opções:
| Product | O que contabiliza | Unidade |
|---|---|---|
| API | As requisições que você envia para /api/single, /api/proxy, /api/browser e /api/auto |
Requisições e créditos |
| Proxy | Os túneis que suas próprias ferramentas abrem via proxy.foura.ai |
Túneis e bytes |
Um túnel transporta o que seu cliente enviar por ele, e o que ocorre dentro de um CONNECT é 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 para detalhes sobre o produto em si.
O seletor está sempre em uma das duas opções, sua escolha é lembrada entre visitas e fica registrada no endereço como #overview/proxy, #metrics/proxy ou #activity/proxy. Cole um desses links e a página abrirá naquele produto.
Não confunda o produto Proxy com a tag do endpoint Proxy Finder. O 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 exibe seus números principais para o período selecionado. A página recarrega automaticamente a cada 60 segundos, e o botão de atualização ao lado do título exibe a contagem regressiva e recarrega imediatamente.
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 já abre com um comando de teste, e Open Playground para enviar uma requisição. Em celulares ou tablets, as etapas direcionam você ao Playground, pois um celular não pode executar o comando. Sua primeira requisição real substitui os dados de exemplo em definitivo.
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 ou que sua primeira requisição real de API chegue. Fechar qualquer um dos banners oculta ambos.
Cards de Resumo
Seis painéis na parte superior:
| Painel | O que mostra |
|---|---|
| Concurrency | Requests em execução simultânea neste momento, além da média e do máximo no período |
| Requests | Total de chamadas, depois Single, Proxy, Browser e Auto, cada um com sua fatia do total abaixo. Uma chamada Auto conta uma vez, em Auto. |
| Auto attempts | Sempre exibido, com zeros quando o Auto não executou nada no período. Os requests de Single, Proxy e Browser que o Auto realizou 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 para os seus limites de rate limit e concurrency de Single, Proxy e Browser. |
| Credits | Créditos faturados como o valor principal, créditos gastos logo abaixo, para o total e para cada produto, incluindo Auto |
| 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, independentemente de essa saída ter entregue a página ou não. Premium fica dentro dos dois totais e nunca é somado a eles. |
| Response Time | Médio, mínimo e máximo ao longo do período |
Faturado e gasto são números diferentes. Apenas uma request com sucesso é faturada, portanto faturado é o que você paga. Gasto representa todos os resultados, pois uma 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 duas contas diferentes em páginas distintas. Consulte Request Outcomes para saber quais resultados são faturados.
Os painéis Requests e Credits rotulam os quatro endpoints como Single, Proxy, Browser e Auto. A linha de filtros Endpoints acima deles chama Proxy de Proxy Finder, que é a mesma coisa: POST /api/proxy/.
A soma dos quatro nem sempre bate com o total. Um número pequeno de chamadas não se enquadra em nenhum deles; elas entram na contagem total e em nenhum endpoint específico.
Gráficos de Linha do Tempo
Abaixo dos painéis, seis gráficos temporais traçam o volume de requests, gasto de créditos, divisão por resultado, tempo de resposta, largura de banda e concurrency. Cada gráfico tem um botão de alternância no cabeçalho que substitui o visual pela tabela de dados correspondente.
Página de Visão Geral, Produto Proxy
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. O seu plano limita essa métrica somando todos os seus usuários de proxy. |
| Tunnels | Success e Failed, cada um com sua fatia do total. Failed engloba qualquer outro resultado, e a linha Outcome detalha qual foi. |
| Traffic | In é o que suas ferramentas enviaram, Out é o que retornou e Premium é a parte que saiu pela rede premium, contada dentro dos totais em vez de somada a eles. |
| Setup Time | Espera média, mínima e máxima antes de um túnel ser entregue, apenas para túneis bem-sucedidos. É o tempo de espera antes do seu primeiro byte, não a velocidade do site por trá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 de gráfico ou tabela que os gráficos da API.
Três painéis e seus gráficos de linha do tempo 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, e seu gráfico exibe uma badge Not filterable. Setup Time e Traffic ficam esmaecidos sob um resultado de falha, e seus gráficos exibem uma badge Success only, porque um túnel com falha nunca foi entregue e não transmitiu nada.
Período e Detalhe
Period indica até quando no passado você está analisando. Oito pills mais Custom:
| Pill | Janela |
|---|---|
| 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. O intervalo de datas vai 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, diariamente, semanalmente ou mensalmente. O padrão é Auto, que escolhe o intervalo mais amplo que ainda mantém pelo menos quinze barras no gráfico, para que um ano seja visualizado como uma forma em vez de 365 linhas finas. A opção Auto indica o intervalo escolhido.
Period e Detail se aplicam a ambos os produtos.
Os intervalos de Detail que vão mais longe do que o FourA armazena nessa resolução ficam esmaecidos em vez de ocultos:
| Resolução | Alcance no passado |
|---|---|
| Por request | 7 dias |
| 5 minutos | 30 dias |
| Horária | 12 meses |
| Diária | Todo o histórico |
Escolha um período mais antigo do que um nível permite e as opções mais detalhadas ficarão esmaecidas. O Auto nunca seleciona uma delas, garantindo que um gráfico nunca fique vazio por causa de dados agregados.
Filtros
Os filtros se acumulam e combinam, e Period e Detail operam lado a lado com eles.
| Filtro | Produto | O que faz |
|---|---|---|
| Product | ambos | API ou Proxy |
| Endpoints | API | Limita a um endpoint: Single, Proxy Finder, Browser ou Auto. Uma chamada Auto conta uma vez, em Auto; as requests Single, Proxy e Browser feitas pela sequência por trás são mostradas pelo nome no painel de tentativas de Auto, nunca como requests separadas. |
| Outcome | ambos | Isola uma categoria. A API oferece todas as sete; o produto Proxy oferece as cinco nas quais um túnel pode terminar. |
| Owner | ambos | Everything, Personal ou uma das suas organizações. Aparece apenas quando você pertence 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 Concurrency e seu gráfico no lado da API não aceitam o filtro Endpoints ou Outcome. Ambos ficam esmaecidos enquanto qualquer um estiver ativo, e o cabeçalho do gráfico indica essa condição.
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 sempre concordem.
Usage & Limits e Billing deliberadamente não o utilizam. Eles respondem a "o que é cobrado de mim", que para você são suas chaves pessoais e usuários de proxy mais os das organizações das quais você é proprietário. Consulte Organizations.
Seções da barra lateral
Onze páginas e um link para Docs, divididos em quatro grupos: Dashboard, Tools, Access e Account.
Painel: Visão geral, Métricas, Atividade
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 o período completo acima de uma tabela paginada. Consulte o guia de Metrics.
Activity exibe a última hora de tráfego. Ele carrega quando você abre a página, e seu botão de atualização busca as linhas mais recentes. 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.
Ferramentas: Playground, Extensão, Documentação
Teste requests em tempo real com sua chave de API real sem escrever código. Escolha Auto, Single, Proxy ou Browser, defina uma URL, ajuste flags e tempos limite, e clique em Send. Salve configurações comuns como predefinições e repita qualquer uma das suas últimas 20 execuções pelo History.
O uso é contabilizado na cota da chave, exatamente como uma chamada de produção. Consulte o guia do Playground.
Extension, marcada como Beta, é onde você baixa a extensão do FourA para o Chrome. O popup direciona o Chrome através de um dos seus usuários de proxy, e a aba FourA no DevTools transforma qualquer request feita por uma página em uma chamada de API pronta. Consulte Chrome Extension.
Docs abre esta documentação em uma nova aba, mantendo a página do painel onde você está intacta.
O botão de tema na parte superior da barra lateral alterna entre a configuração do seu dispositivo, claro e escuro. A escolha é compartilhada com foura.ai e com a documentação, de modo que o tema escolhido em qualquer um deles é aplicado ao painel.
Acesso: Chaves de API, Proxy
API Keys é onde você cria, visualiza e gerencia as chaves que seus aplicativos 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. Túneis e tráfego através da porta contam no seu plano, da mesma forma que a API. Consulte Usuários de Proxy e a referência de Porta de Proxy.
Conta: Organizações, Uso e Limites, Faturamento, Configurações
Organizações 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 ela precisar mudar de responsável. O uso em uma credencial da organização conta no plano do proprietário da organização. Consulte Organizações.
Uso e Limites mostra seu plano, o que você usou neste período de faturamento e todos os limites aplicados a você, com detalhamento por chave, por endpoint e por usuário de proxy. Consulte Uso e Limites.
Faturamento gerencia sua assinatura, compra mais créditos ou tráfego, mantém formas de pagamento e faturas, e mostra os créditos, tráfego e tráfego premium deste período em relação ao seu plano. Consulte Faturamento e Assinaturas.
Configurações armazena 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 souber de qual mecanismo um novo site precisa, comece com Auto e deixe-o escolher.
- Compare o faturado com o gasto no card Créditos. Um endpoint onde os dois estão distantes está falhando com frequência, e o relatório de tentativas diz o motivo.
- No produto Proxy, um bloco de Taxa Limitada 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 é.
- Mantenha suas chaves de API e usuários de proxy em segurança. Desative qualquer um deles imediatamente se suspeitar de exposição.
Próximos Passos
- Autenticação: Detalhes sobre criação e gerenciamento de chaves de API
- Início Rápido: Faça sua primeira solicitação 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