O agente aparece offline mas está rodando
Seu processo local, container ou plugin de IDE continua rodando, mas o Dailybot marca o agente como offline ou fica alternando entre estados. Os heartbeats são mensagens sensíveis ao tempo que comprovam que o agente está vivo. Intervalos perdidos, quedas de rede, crashes silenciosos ou desvio de relógio fazem com que o dashboard discorde do que você vê na sua máquina.
Verificação rápida
- Intervalo de heartbeat – Confirme que a configuração do agente corresponde à frequência de ping esperada; laptops em suspensão perdem ticks quando estão fechados.
- HTTPS de saída – Garanta que os firewalls permitam que o agente alcance os endpoints da API do Dailybot sem quebra por MITM.
- Logs – Examine o stdout do agente em busca de erros de heartbeat ou falhas de autenticação logo antes de o status mudar.
- Relógio – Sincronize o horário do sistema com NTP; um desvio grande faz com que tokens e timestamps falhem na validação.
- Versão – Atualize para o build mais recente do agente; clientes antigos tinham bugs de timeout mais agressivos.
Causas comuns e soluções
Intervalo de heartbeat perdido
Os agentes normalmente enviam um ping leve em um cronograma. Fechar a tampa, suspender o Docker ou pausar a VM interrompe os pings, mesmo que o binário ainda esteja “rodando” na sua perspectiva. Mantenha o host ativo durante o horário de trabalho ou rode o agente em um pequeno servidor sempre ligado. Aumente o intervalo apenas se as configurações do produto permitirem e se o seu SLA aceitar uma detecção de falha mais lenta.
Problema de rede
Proxies corporativos, portais cativos ou Wi-Fi instável derrubam o TLS no meio da requisição. O agente pode tentar de novo, mas uma rajada de falhas marca você como offline. Teste com curl ou similar a partir do mesmo host para a URL base da API (siga o processo de segurança interno da sua empresa). Libere os domínios necessários e cifras TLS modernas. VPNs com split tunnel às vezes roteiam apenas o tráfego do navegador; roteie o tráfego do agente pelo túnel ou faça o bypass corretamente.
O agente crashou silenciosamente
Scripts wrapper podem reiniciar processos filhos que morrem imediatamente. Observe listas de processos e códigos de saída. Habilite o log de debug se houver suporte. No Windows, verifique as opções de recuperação do Serviço; no systemd, inspecione o journalctl em busca de loops de reinício rápido.
Desvio de relógio
Se o relógio do sistema salta para trás ou fica minutos adiantado, a validação de JWT e a ordenação dos heartbeats falham. Habilite a sincronização de horário no nível do SO. Depois de corrigir o horário, reinicie o agente para que ele busque credenciais novas.
Rotação de credenciais
API keys expiradas ou tokens de org rotacionados causam processos locais que parecem bem-sucedidos mas não conseguem autenticar os heartbeats. Regenere o token do agente no Dailybot, atualize a config local ou o gerenciador de secrets e reinicie. Confirme que o org ID na config corresponde à org do dashboard.
Se nada disso funcionou
Antes de falar com o suporte, reúna:
- Tipo de agente (CLI, IDE, servidor) e string de versão
- SO e se o host entra em suspensão
- Trecho de log (oculto) em torno da primeira transição para “offline”
- Saída de um teste de conectividade com a API, se sua política permitir
- Nome da organização e nome de exibição do agente no dashboard
- Os passos que você já tentou neste artigo
Depois fale com o suporte do Dailybot pelas opções de Ajuda ou Contato no produto ou no site.