El agente aparece offline pero está corriendo
Tu proceso local, contenedor o plugin de IDE sigue corriendo, pero Dailybot marca el agente como offline o lo cambia entre estados. Los heartbeats son mensajes sensibles al tiempo que demuestran que el agente está vivo. Los intervalos perdidos, las caídas de red, los crasheos silenciosos o el desfase de reloj hacen que el dashboard no coincida con lo que ves en tu máquina.
Comprobación rápida
- Intervalo de heartbeat – Confirma que la configuración del agente coincida con la frecuencia de ping esperada; los portátiles en suspensión pierden ticks cuando están cerrados.
- HTTPS saliente – Asegúrate de que los firewalls permitan que el agente alcance los endpoints de la API de Dailybot sin romper por un MITM.
- Logs – Revisa el stdout del agente en busca de errores de heartbeat o fallos de autenticación justo antes de que cambie el estado.
- Reloj – Sincroniza la hora del sistema con NTP; un desfase grande hace que tokens y marcas de tiempo fallen la validación.
- Versión – Actualiza a la última build del agente; los clientes antiguos tenían bugs de timeout más estrictos.
Causas comunes y soluciones
Intervalo de heartbeat perdido
Los agentes normalmente envían un ping ligero según una agenda. Cerrar la tapa, suspender Docker o pausar la VM detiene los pings aunque el binario siga “corriendo” desde tu perspectiva. Mantén el host despierto durante el horario laboral, o ejecuta el agente en un pequeño servidor siempre encendido. Aumenta el intervalo solo si los ajustes del producto lo permiten y tu SLA acepta una detección de fallos más lenta.
Problema de red
Los proxies corporativos, los portales cautivos o el Wi-Fi inestable cortan el TLS a mitad de la petición. El agente puede reintentar, pero una ráfaga de fallos te marca como offline. Prueba con curl o similar desde el mismo host hacia la URL base de la API (sigue tu proceso interno de seguridad). Pon en la allowlist los dominios requeridos y los cifrados TLS modernos. Los túneles VPN divididos a veces enrutan solo el tráfico del navegador; enruta el tráfico del agente por el túnel o evítalo correctamente.
El agente crasheó en silencio
Los scripts envoltorio pueden volver a lanzar procesos hijos que mueren de inmediato. Vigila las listas de procesos y los códigos de salida. Activa el logging de depuración si está soportado. En Windows, revisa las opciones de recuperación del servicio; en systemd, inspecciona journalctl en busca de bucles de reinicio rápidos.
Desfase de reloj
Si el reloj del sistema salta hacia atrás o queda minutos adelantado, la validación de JWT y el ordenamiento de heartbeats fallan. Activa la sincronización de hora a nivel de sistema operativo. Después de corregir la hora, reinicia el agente para que obtenga credenciales nuevas.
Rotación de credenciales
Las API keys expiradas o los tokens de organización rotados causan procesos locales que parecen exitosos pero no pueden autenticar los heartbeats. Regenera el token del agente en Dailybot, actualiza la configuración local o el gestor de secretos, y reinicia. Confirma que el org ID de la configuración coincida con la organización del dashboard.
Si nada de esto funcionó
Antes de contactar a soporte, reúne:
- Tipo de agente (CLI, IDE, servidor) y cadena de versión
- Sistema operativo y si el host entra en suspensión
- Extracto de log ocultado alrededor de la primera transición a “offline”
- Salida de una prueba de conectividad a la API si tu política lo permite
- Nombre de la organización y nombre visible del agente en el dashboard
- Los pasos que ya probaste de este artículo
Luego contacta a soporte de Dailybot desde las opciones de Ayuda o Contacto en el producto o en el sitio web.