Registro de Atividades
O Activity Log mostra suas requisições de API mais recentes em tempo real. Use-o para depurar requisições individuais, verificar códigos de resposta e confirmar se sua integração está funcionando.
O Que Você Verá
O log exibe as requisições feitas na última hora, com as mais recentes no topo. Nove colunas compõem a linha inteira:
| Coluna | O que ela mostra |
|---|---|
| Time | Quando a requisição foi feita |
| Key | Qual chave de API foi usada |
| Request | A chamada em si: um ponto colorido indicando o produto (single, proxy ou browser), 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, seguido do status retornado pelo destino. Um traço significa que o destino nunca respondeu. |
| Outcome | Classificação da requisição (Success, Client Error, Rate Limited, etc.) |
| Duration | Tempo total de resposta em milissegundos |
| Bytes | Transferência em ambas as direções na mesma célula: seta para baixo para o payload da requisição, seta para cima para a resposta |
| Credits | Créditos gastos na chamada (veja Response Headers) |
| Client IP | O endereço que fez a requisição |
Clique em qualquer cabeçalho de coluna para ordenar a tabela por ela; a direção alterna entre decrescente, crescente e sem ordenação. Clique com Ctrl ou Cmd para restaurar o padrão (mais recentes primeiro).
Filtragem
Três controles limitam o log.
Por Chave de API
Use o menu suspenso de chave de API para mostrar as requisições de uma chave. Apenas as chaves dentro do seu escopo de acesso aparecem no menu suspenso.
Por Produto
Filtre para um endpoint com o seletor single / proxy / browser. Útil quando você deseja depurar falhas específicas do browser separadamente de requisições single.
Por Limite
O log de atividade tem como padrão 50 entradas. Use o seletor de limite para alterar quantas entradas são mostradas:
| Limite | Notas |
|---|---|
| 10 | Verificação 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 Metrics, que agrega dados ao longo de dias e semanas.
Abrindo uma Requisição
Clique em qualquer linha para abrir um painel de detalhes com a pré-visualização completa do payload da requisição e da resposta. O painel abre em uma grade de metadados construída a partir da própria linha, para que continue útil mesmo após o payload armazenado expirar: timestamp, chave, status HTTP, status do app, outcome, duration, credits, proxy e o X-FourA-Request-Id da requisição.
Abaixo da grade, um painel é exibido por vez, selecionado por aba:
| Aba | O que ela mostra |
|---|---|
| Request | JSON formatado (pretty-printed) do corpo exato enviado |
| Response headers | Os headers que o destino retornou, com uma contagem na aba |
| Response body | A pré-visualização armazenada do corpo, com marcadores de truncado e binário onde se aplicam |
| Outros campos | Qualquer outra coisa que o motor tenha retornado além de status, tempos, proxy e headers. Oculto quando não há nada extra. |
Um botão Copy copia qualquer painel que esteja aberto. Os payloads são mantidos por 24 horas, limitados aos últimos 200 por chave de API. As linhas mais antigas mostram apenas a linha, sem um payload.
Mensagens do painel Body
O painel body usa textos de placeholder diferentes dependendo do que aconteceu:
| Mensagem | O que significa |
|---|---|
(no body — the request failed: <error>) |
A request deu erro antes que o destino retornasse um body |
(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 response real vazia |
Abrir no Playground
O diálogo de detalhes tem um 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 na API em tempo real, ou apenas inspecionar o que retornou sem executar a request novamente.
O botão fica desativado para payloads não reproduzíveis (stubs de request muito grandes e rotas que não são da API), com uma dica explicando o motivo.
Usando o ID da Request
Toda response da API carrega um header X-Foura-Request-Id. Registre isso no seu lado e você pode colá-lo em um ticket de suporte para apontar para a request exata no Activity Log. O ID é o mesmo usado neste diálogo e corresponde ao X-Foura-Request-Id retornado pela API. Veja Headers da Response para mais detalhes.
Relacionado
- Métricas e Analytics: Dados de desempenho agregados em períodos mais longos
- Playground: Reproduza requests da Activity
- Headers da Response: De onde vêm o ID da request e os créditos
- Endpoints da API: Formatos de request e response
- Solução de problemas: Problemas comuns e soluções