> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Solução de Problemas > Diagnostique sessões ausentes, políticas ausentes, falhas na entrega e ações bloqueadas do agente. Abra **Administração → Chaves** e confirme que a chave da máquina está ativa e possui `events:add`. Em seguida, abra **Observar → Eventos**, amplie o intervalo de tempo e limpe os filtros de ambiente e agente. Se houver eventos, pesquise o ID da sessão e verifique **Observar → Sessões** para agrupamento. Se não houver eventos, diagnostique o daemon do Failproof pela CLI. O stream de Eventos ao vivo com seus filtros principais visíveis e eventos recentes do agente chegando. ```bash theme={null} failproofai config --status failproofai flush --wait --timeout 60 fp list envs fp events --since 24h --limit 20 fp sessions --since 24h --limit 20 ``` Confirme que a captura está habilitada, que a chave configurada possui `events:add` e que o filtro do dashboard corresponde ao ambiente emitido. Limpe os filtros em **Observar → Eventos** e pesquise o ID exato da sessão do SDK. Se nada aparecer, inspecione o spool do SDK e o daemon do Failproof na máquina de origem. ```bash theme={null} failproofai config --status failproofai flush --wait ``` Confirme que o processo do agente define `AGENTEYE_SPOOL_TO_FAILPROOFAI=1` e que `$FAILPROOFAI_HOME/custom-agents`, ou `~/.failproofai/custom-agents`, existe antes de o SDK ser iniciado. Abra **Admin → enforcement**, selecione a máquina e compare suas versões atribuída, reportada e anterior. Confirme que o escopo de implantação inclui a máquina e que sua chave possui `policies:pull`. A ingestão pode funcionar mesmo quando a entrega de políticas não funciona. ```bash theme={null} failproofai config --status failproofai update failproofai config --status ``` Confirme que o ID e o rótulo da máquina correspondem ao destino no dashboard. Reconecte com uma chave habilitada para políticas se a credencial existente conceder apenas ingestão de eventos. Abra **Admin → enforcement** e inspecione o horário da última visualização da máquina e a versão reportada. Se a máquina estiver desatualizada, trate isso como um problema local do daemon. Não enfraqueça a política implantada apenas para contornar um daemon indisponível. ```bash theme={null} failproofai config --status failproofai update failproofai config failproofai config --status ``` Reinicie ou atualize o `failproofaid`; execute novamente a configuração quando as versões de protocolo da CLI e do daemon diferirem. O caminho do daemon configurado falha de forma fechada por design. Para uma política criada na Cloud, abra **Admin → policy editor**, selecione o rascunho e revise os erros de validação antes de publicar. Para uma política local, use a CLI para validá-la e, em seguida, abra **Observar → policy** após uma ação de teste para confirmar que as decisões chegam. Confirme que o nome do arquivo termina em `policies.js`, `policies.mjs` ou `policies.ts`, que o módulo chama `customPolicies.add(...)` e que as importações são resolvidas a partir do arquivo de política. ```bash theme={null} failproofai policies --install --custom ./checkout.policies.ts failproofai policies ``` Abra **Analisar → auditorias**, selecione a execução e verifique se a análise do modelo foi executada. Em seguida, compare seu escopo e janela com **Observar → sessões** e abra rastros representativos dessa população. Um resultado zero só é significativo quando a análise foi executada com sucesso. Se a análise foi ignorada ou falhou, a execução não produz resultados e mantém a janela não analisada aberta para uma futura execução bem-sucedida. Se a análise do modelo estiver desabilitada, a auditoria também não produz resultados, pois a verificação determinística de credenciais e PII registra estatísticas, mas não gera mais resultados. O formulário de auditoria onde ambiente, agente, cadência e janela de varredura definem a população de sessões. ```bash theme={null} fp audits show fp audits runs fp sessions --since 24h --env production fp audits context-show fp audits run fp audits findings --audit ``` Se a execução ficou na fila, aguarde a capacidade do agente de auditoria ou peça ao operador de implantação para inspecionar a frota de auditoria. Uma auditoria na fila é reexecutada; ela não é descartada imediatamente. Abra uma sessão concluída e verifique se uma avaliação manual é bem-sucedida. A Cloud hospedada atualmente não possui controle de endpoint do avaliador no dashboard; o operador do servidor deve configurá-lo. Verifique o próprio avaliador e, em seguida, inspecione os estados de avaliação recentes: ```bash theme={null} curl https://evaluator.example.com/health fp evals --since 1h ``` Na Cloud auto-hospedada, confirme que `EVALUATOR_ENDPOINT` está presente no servidor e que `EVALUATOR_TOKEN` corresponde ao avaliador. A avaliação automática é desabilitada quando o endpoint está ausente. Use o seletor de organização e confirme o slug e as permissões esperados antes de comparar os resultados com a CLI. ```bash theme={null} fp whoami fp orgs current fp orgs perms ``` No modo de chave de API, especifique `fp --org --api-key ...` ou defina `AGENTEYE_ORG`. O estado de organização de sessão humana salvo é intencionalmente ignorado para requisições com chave de API. Abra **Observar → policy**, preserve a decisão e a sessão vinculada, e identifique a condição de falso positivo. Em seguida, abra **Admin → enforcement** e reverta as máquinas afetadas para a versão anterior. Crie uma versão mais restrita no **Policy editor**, teste-a em um escopo pequeno e expanda apenas após o trabalho válido ser bem-sucedido. O rollback de implantação na Cloud é exclusivo do dashboard. Uma pausa de sessão local não desabilita políticas gerenciadas pela Cloud. Se o dashboard estiver indisponível, capture o estado da máquina e da implantação e restaure o acesso ao dashboard em vez de tentar repetidamente a ação bloqueada. ```bash theme={null} failproofai config --status ``` Ao entrar em contato com o suporte, inclua a versão da CLI, o harness, o ambiente, o ID relevante da sessão ou implantação, e a saída de `failproofai config --status` com os segredos removidos.