Logs de requisições
Por padrão, a OfoxAI opera com retenção zero de dados (ZDR) e não salva o conteúdo das requisições. Para investigar problemas, a equipe pode ativar a retenção de logs (Log retention) e ver no console a entrada e a saída completas de cada requisição.
Os logs de requisições vêm desativados. Enquanto a equipe não os ativar, o conteúdo das requisições não é salvo, e as requisições feitas antes da ativação não podem ser consultadas depois.
O que você vê
Depois de ativar, as novas requisições passam a salvar a entrada, a saída, as chamadas de ferramentas e o motivo do erro. As imagens da requisição e da resposta só são salvas se você marcar à parte Salvar também as imagens (Also save images).
Na página Atividade (Activity), as requisições com log aparecem marcadas. Ao abrir uma delas, você vê cada etapa em uma linha do tempo, além de um resumo com duração, tokens e custo.
Ativar a retenção de logs
Somente proprietários e administradores da equipe podem ativar.
- Abra a página Atividade (Activity) no console
- Clique em Retenção de logs (Log retention), no canto superior direito
- Clique em Ativar retenção de logs (Turn on log retention)
- Em Quais requisições salvar (Which requests to save), escolha o escopo:
- Todas as API Keys (All API keys): é possível excluir keys específicas
- API Keys selecionadas (Selected API keys): salva apenas as keys listadas
- Se precisar, marque Salvar também as imagens (Also save images)
A configuração vale apenas para as novas requisições feitas daí em diante.
Limites de armazenamento
Quando qualquer um desses limites é atingido, os logs mais antigos são apagados automaticamente. Se precisar manter os logs por mais tempo, escreva para hi@ofox.ai.
Tratamento de dados sensíveis
Antes de salvar, API Keys, tokens, senhas, cookies, chaves privadas e parâmetros de URLs assinadas são substituídos por [REDACTED].
Dados pessoais como números de telefone e e-mails não são tratados. Se as suas requisições contêm dados pessoais dos seus usuários, avalie isso antes de ativar ou use o cabeçalho abaixo para não salvar a requisição.
Não salvar uma requisição específica
Adicione este cabeçalho à requisição para que ela não seja salva:
X-OfoxAI-Log-Content: offfrom openai import OpenAI
client = OpenAI(
base_url="https://api.ofox.ai/v1",
api_key="<Sua OFOXAI_API_KEY>",
)
response = client.chat.completions.create(
model="anthropic/claude-sonnet-5.5",
messages=[{"role": "user", "content": "Esta requisição não terá log salvo"}],
extra_headers={"X-OfoxAI-Log-Content": "off"},
)Quem pode ver
Membros que precisem ver o conteúdo completo de uma requisição devem falar com um administrador da equipe.
Apagar e desativar
- Apagar um único log: apague-o nos detalhes da requisição.
- Apagar por período: nas configurações de retenção de logs, clique em Apagar logs salvos (Delete saved logs) e escolha a última hora, hoje, tudo ou um período personalizado. Logs apagados não podem ser recuperados; o histórico de chamadas, o uso de tokens e os custos não são afetados.
- Desativar a retenção de logs: depois de desativar, as novas requisições deixam de ser salvas. Os logs já salvos não são apagados na hora: eles são removidos automaticamente quando o prazo de retenção termina. Para apagá-los imediatamente, use a função de exclusão acima.
Perguntas frequentes
Por que uma requisição mostra “Nenhum log foi salvo para esta requisição” ao abrir?
Pode ser que: a requisição tenha sido feita antes da ativação; a API Key dela esteja fora do escopo de retenção; a requisição tenha enviado X-OfoxAI-Log-Content: off; ou o log tenha expirado ou sido apagado.
Ativar os logs gera cobrança adicional?
Não. A retenção de logs não tem custo extra, e o histórico de chamadas, o uso de tokens e a forma de cobrança continuam iguais.
Qual a relação com a retenção zero de dados (ZDR)?
Equipes que não ativaram a retenção de logs continuam com retenção zero de dados. Depois de ativar, o conteúdo das requisições dentro do escopo é salvo respeitando os limites acima. Veja Segurança e dados.