Solução de problemas

Sintomas comuns e por onde começar. Quase tudo se resolve olhando o log do agente: sudo journalctl -u argus-agent -f.

Instalação

• Checksum não confere: o download veio incompleto ou de cache. Rode de novo com ?v=$(date +%s) na URL.
• Erro de certificado (curl erro 51/60): use sempre https://argus-homolog.eulabs.net.br para baixar, nunca o IP do servidor.
• Token inválido ou revogado: a instalação para. Gere um comando novo em Admin → Projetos/Sites → Add Node.
• As respostas foram para config.yml.new: já existia um config.yml e a substituição não foi confirmada. Compare e aplique à mão, ou reinstale com --force-config.

Host não aparece ou fica offline

• Veja se o serviço está rodando: sudo systemctl status argus-agent.
• Confira a URL e o token em /etc/argus-agent/argus-agent.env e se o host alcança a API por HTTPS.
• O agente guarda os envios no spool enquanto o servidor não responde e reenvia depois; um host que voltou da rede aparece sozinho.
• argus-agent status no shell responde missing_agent_token? Rode com o ambiente do serviço: sudo env $(sudo cat /etc/argus-agent/argus-agent.env | xargs) argus-agent status.

Alerta falso de Proxmox, libvirt ou Kubernetes

Atualize o agente: a partir da versão de 19/10/2026, esses coletores ficam em silêncio em hosts que não rodam a plataforma, mesmo quando o perfil do site os liga.

Kubernetes

• Cluster com “dados desatualizados”: o nó eleito para reportar não tem agente com o coletor ligado. Veja elected_reporter na evidência do check de API de qualquer nó; instale o token nesse nó ou use a label argus.io/k8s-reporter=true nos nós que têm agente.
• forbidden: o RBAC está desatualizado; peça ao time do Argus para reaplicar.
• unauthorized: o token foi revogado ou recriado; reinstale o token nos nós. O agente relê o arquivo a cada ciclo, sem reiniciar.
• Seção “Eventos do cluster” vazia: o nó reporter precisa da versão do agente de 19/10/2026 ou mais nova.

Bancos de dados

• password_file_permissions: o arquivo de senha está legível por outros; use chmod 600.
• Capacidade “sem permissão”: falta um grant. A lista Capacidades e permissões da instância diz qual.
• Sem ranking de consultas: MariaDB com performance_schema=OFF ou PostgreSQL sem pg_stat_statements.
• Use Testar conexão na aba Configuração para validar grants e TLS sem expor a senha.

Análise por IA

• “O agent do host não enviou as evidências” (Docker/Swarm): o host está offline, roda uma versão antiga do agente ou tem ai_investigation.enabled: false. No log do agente, procure ai_collection_sent ou ai_collections_fetch_failed.
• Coleta parcial num worker Swarm: esperado; leituras de serviço e nó só funcionam em manager.
• “Nenhuma consulta ao cluster funcionou” (Kubernetes): problema de acesso da IA ao cluster; avise o time do Argus.
• Botão “Analisar com IA” não aparece: a funcionalidade está desligada no servidor ou o tipo de alerta não é suportado.

Notificações

• Veja Admin → Notificações → Logs de entrega: o erro do provedor aparece por destino.
• Slack not_in_channel: convide o bot com /invite @nome-do-bot. missing_scope: adicione chat:write e reinstale o app.
• “RESOLVIDO” atrasado: é proposital; ele espera 5 minutos para não notificar alertas que oscilam.

Limpeza de Docker não executou

• A ação precisa estar em remediation.allowed_actions no host e liberada no servidor.
• O agente revalida o disco depois do aviso prévio; se o uso já caiu abaixo do limite, não limpa.
• O cooldown_seconds (24 h por padrão) impede uma nova limpeza logo em seguida.
• docker_prune_unused_images exige aprovação: confira se há um plano esperando no painel do alerta.