Registro de atividades
O Activity Log mostra o seu tráfego mais recente. Ele é carregado quando você abre a página; clique no botão de atualização ao lado do título para buscar as linhas mais novas. Use-o para depurar chamadas individuais, verificar códigos de resposta e confirmar se uma nova integração está funcionando.
Produto
A página abre em um seletor de Produto: API para as requests enviadas aos endpoints da API, Proxy para os túneis que suas próprias ferramentas abrem via proxy.foura.ai. Ambos os feeds cobrem a última hora e aceitam o mesmo seletor de limite. O seletor é memorizado e permite link direto como #activity/proxy.
O restante desta página descreve primeiro o feed da API e depois o feed de Proxy.
O que você verá no feed da API
O log exibe requests feitas na última hora, com as mais recentes no topo. Nove colunas compõem a linha completa:
| Coluna | O que mostra |
|---|---|
| Hora | Quando a request foi feita |
| Chave | Qual API key foi usada |
| Request | A chamada em si: uma marcação colorida de endpoint (Single, Proxy, Browser ou Auto), o método HTTP e o domínio de destino. Ordena por domínio. |
| Status | Dois valores em uma célula, separados por uma barra: o status HTTP da sua chamada para a FourA e depois o status retornado pelo destino. Um traço significa que o destino nunca respondeu. |
| Resultado | Classificação da request (Success, Client Error, Rate Limited e assim por diante) |
| Duração | Tempo total de resposta em milissegundos |
| Bytes | Transferência em ambos os sentidos em uma célula: seta para baixo para o payload da request, seta para cima para a resposta. Uma linha que utilizou tráfego premium exibe uma marcação premium nessa célula, incluindo casos em que uma saída premium foi tentada e o pool padrão respondeu; esse tráfego conta para o seu tráfego premium. |
| Créditos | Créditos gastos na chamada (consulte Headers de resposta) |
| IP do cliente | O endereço que fez a request. Requests enviadas do Playground ou do MCP hospedado da FourA exibem FourA em vez de um endereço. |
Clique no cabeçalho de qualquer coluna para ordenar a tabela por ela; a direção alterna entre decrescente, crescente e desativada. Ctrl ou Cmd clique redefine para o padrão (mais recentes primeiro).
Filtragem
Quatro controles refinam o log.
Por proprietário
Se você pertencer a pelo menos uma organização, um menu suspenso Proprietário aparecerá primeiro: Tudo, Pessoal ou uma de suas organizações. Alterá-lo reconstrói o menu suspenso de chaves ao lado, evitando que uma chave pertencente ao proprietário anterior permaneça após a troca e não retorne nada silenciosamente. O mesmo controle em Visão geral, Métricas e API Keys acompanha a sua escolha. Consulte Organizações.
Por API key
Use o menu suspenso de API key para exibir requests de uma única chave. Apenas chaves às quais você tem acesso são exibidas: suas chaves pessoais e as chaves das organizações às quais você pertence.
Por endpoint
Com Produto definido como API, filtre para um endpoint usando os seletores Single / Proxy Finder / Browser / Auto. Útil quando você deseja depurar falhas exclusivas do Browser separadamente de requests Single. Auto lista suas chamadas Auto, uma linha por chamada.
Por limite
O log de atividade exibe por padrão 50 entradas. Use o seletor de limite para alterar quantas entradas são exibidas:
| Limite | Observações |
|---|---|
| 10 | Varredura rápida |
| 50 | Padrão |
| 100 | Visualização estendida |
| 200 | Máximo |
Todas as entradas são da última hora. Para dados históricos, use a seção Métricas, que agrega dados ao longo de dias e semanas.
Chamadas Auto
Uma linha Auto representa uma chamada. A segunda linha indica quantas tentativas o Auto fez e quantas tiveram sucesso, e seus Créditos e Bytes são os totais dessas tentativas. Por alguns segundos após o término de uma chamada, ela exibe attempts settling…, e a linha é preenchida automaticamente. Uma chamada recusada antes que o Auto tentasse qualquer ação exibe no attempts recorded.
Abra a linha para ver uma tabela de Attempts: Engine, Rung, Status, Outcome, Time, Bytes, Credits. As tentativas contam para os seus limites de Single, Proxy Finder e Browser, nunca na sua contagem de requests ou taxa de sucesso.
Abrindo uma request
Clique em qualquer linha para abrir um painel de detalhes com a pré-visualização completa do payload da request e do response. O painel abre em uma grade de metadados construída a partir da própria linha, mantendo-se útil mesmo após a expiração do payload armazenado: horário, chave de API, IP do cliente, destino, status HTTP, status do app, resultado, Gateway total (a chamada inteira como o FourA a registrou), Upstream fetch (o tempo gasto na tentativa que respondeu), bytes, créditos e o X-FourA-Request-Id da request. Quando aplicável, também mostra a cadeia de proxies de uma chamada Proxy Finder (cada tentativa de proxy, incluindo repetições), o proxy utilizado, o tamanho do corpo do response e o erro da engine.
Abaixo da grade, um painel é exibido por vez, selecionado por aba:
| Aba | O que ela exibe |
|---|---|
| Request | JSON formatado do corpo exato enviado |
| Headers de resposta | Os headers retornados pelo destino, um bloco por salto de redirecionamento. Quando o destino redireciona, a aba mostra a quantidade de saltos. |
| Corpo da resposta | A pré-visualização do corpo armazenado, com marcações de truncado e binário onde se aplicam |
| Outros campos | Qualquer outro dado retornado pela engine além de status, tempos, proxy e headers. Oculto quando não há dados extras. |
Um botão Copiar copia o painel que estiver aberto. Os payloads são mantidos por 24 horas, limitados aos últimos 200 por chave de API. Linhas mais antigas que isso mostram apenas a linha, sem payload.
Mensagens do painel do corpo
O painel do corpo utiliza diferentes textos de espaço reservado dependendo do que aconteceu:
| Mensagem | O que significa |
|---|---|
(no body — the request failed: <error>) |
A request falhou antes do destino retornar um corpo |
(no body captured for this request) |
O payload expirou ou não foi armazenado |
(empty body — the server returned 0 bytes) |
O destino retornou uma resposta vazia real |
Abrir no Playground
A caixa de diálogo de detalhes possui o botão Open in Playground. Clique nele para carregar a request arquivada e a response arquivada no formulário do Playground. A partir daí, você pode ajustar parâmetros e reproduzir contra a API em produção, ou apenas inspecionar o retorno sem executar a request novamente.
O botão fica desativado para chamadas Auto e para payloads que não podem ser reproduzidos (stubs de request excessivamente grandes e rotas que não pertencem à API), exibindo uma dica com o motivo.
O feed do proxy
Alterne Product para Proxy e o feed passa a exibir uma linha por túnel, também referente à última hora. Um túnel é uma conexão aberta pela sua ferramenta; o conteúdo enviado dentro dele é o seu próprio tráfego criptografado, portanto a linha descreve para onde a conexão foi, por onde saiu, quanto tempo levou para abrir e quanto tráfego transportou.
| Coluna | O que ela mostra |
|---|---|
| Hora | Quando o túnel foi encerrado, com a idade relativa ao lado |
| Usuário do proxy | Qual usuário de proxy realizou a conexão |
| Destino | O host e a porta de destino do túnel |
| Saída | Compartilhado ou Premium, além do país de saída quando conhecido |
| Resultado | Success, Client Error, Service Error, Service Fail ou Rate Limited, com o motivo nos seus próprios termos em caso de recusa |
| Configuração | Tempo desde a conexão da sua ferramenta até a entrega do túnel |
| Duração | Por quanto tempo o túnel permaneceu aberto |
| Bytes | Ambas as direções em uma única célula, com a marcação premium quando a saída ocorreu na rede premium |
| IP do cliente | O endereço de onde partiu a conexão |
Não há colunas de Status, Créditos ou payload, e não há caixa de diálogo de detalhes. Um CONNECT não possui status retornado pelo destino nem corpo para o FourA armazenar.
O menu suspenso Owner e o seletor de limite funcionam da mesma forma. No lugar do menu suspenso de chaves, um menu suspenso Proxy user restringe o feed a uma credencial específica. Todas as colunas permitem ordenação.
Uma linha que exibe Rate Limited indica o limite do seu plano, não uma recusa por parte do destino. O motivo especifica qual regra: túneis simultâneos, aberturas por minuto, limite de tráfego esgotado, premium indisponível ou porta não inclusa no seu plano. Consulte Proxy Port.
Usando o ID da request
Toda response da API traz um header X-Foura-Request-Id. Registre esse valor no seu sistema para poder colá-lo em um chamado de suporte e apontar com precisão a request no Registro de Atividades. O ID é o mesmo utilizado nesta caixa de diálogo e corresponde ao X-Foura-Request-Id retornado pela API. Consulte Response Headers para obter detalhes.
Relacionados
- Métricas e Analytics: Dados agregados de desempenho em períodos mais longos, para ambos os produtos
- Porta do Proxy: O produto sobre o qual o feed do Proxy relata
- Playground: Reproduza requests a partir de Activity
- Headers de Resposta: De onde vêm o ID da request e os créditos
- Endpoints da API: Formatos de request e response
- Organizações: O que o filtro Owner cobre
- Solução de Problemas: Problemas comuns e soluções