Heartbeat y seguimiento de estado de agentes

Los agentes de larga duración no fallan con estrépito: se desvían, se cuelgan o pierden credenciales mientras aún se ven “bien” en una terminal local. El monitoreo por heartbeat existe para que Dailybot responda una pregunta simple de ops: ¿este agente sigue vivo y siendo honesto sobre su estado? Este artículo es la explicación orientada al producto de ese sistema: qué son los heartbeats, cómo se calcula el estado, cómo configurar intervalos, qué pasa cuando dejan de llegar pings y cómo los tableros hacen visible la señal en una flota.

Esto es distinto de la guía genérica de “plantillas” que pudieron ver en onboarding temprano: aquí el foco es el comportamiento de la funcionalidad de Dailybot y cómo encaja con hábitos de producción reales.

Qué son los heartbeats

Un heartbeat es una señal liviana y periódica enviada por la integración del agente o su proceso supervisor. Puede ser una marca de tiempo simple (“sigo corriendo”) o incluir pistas estructuradas: tarea actual, profundidad de cola, último commit exitoso o etiqueta de entorno. La profundidad del payload depende de su configuración; el contrato esencial es prueba regular de vida ligada a una identidad de agente conocida.

Los heartbeats complementan reportes narrativos. Una actualización tipo standup explica qué pasó; un heartbeat prueba que el proceso que reporta sigue conectado y dentro de límites esperados. Juntos reducen la falsa confianza de agentes que se detuvieron a mitad de corrida pero nunca enviaron un mensaje final.

Cómo Dailybot rastrea el estado

Dailybot agrega heartbeats en etiquetas de estado que pueden revisar en el tablero o la vista de flota. Aunque los nombres evolucionen, el modelo mental es:

Activo — los heartbeats llegan a tiempo y la actividad opcional coincide con “trabajando”.

Inactivo — el agente es alcanzable pero quieto, lo cual puede ser normal entre tareas.

Obsoleto — pasó el intervalo sin heartbeat, lo que sugiere worker colgado, partición de red o runner caído.

Fuera de línea — el agente está deshabilitado, deregistrado o ha fallado autenticación repetidamente.

El estado es derivado, no un interruptor manual: refleja el tiempo desde la última buena señal frente a la política que configuraron. Eso mantiene a ops y desarrolladores alineados en la misma verdad sin que alguien edite una hoja de “quién está arriba”.

Configurar intervalos de heartbeat

Los intervalos deben coincidir con qué tan crítico es el agente y qué tan rápido necesitan detectar fallas. Un job nocturno podría hacer heartbeat cada treinta minutos; una automatización frente al cliente podría pinguear cada pocos minutos en horario laboral.

Al elegir un intervalo, balanceen velocidad de detección frente a ruido. Demasiado agresivo, y redes inestables pagean personas; demasiado laxo, y descubren caídas tarde. Dailybot permite a administradores del workspace definir valores por defecto mientras permiten overrides por grupo de agente o entorno — reflejen expectativas de staging frente a producción para que pruebas no entrenen al equipo a ignorar alertas.

Documenten el intervalo elegido junto a los runbooks: futuros compañeros deberían saber si cinco minutos de silencio es “café” o “páginen a alguien”.

Cuando los heartbeats se detienen: alertas y escalación

Los heartbeats faltantes no siempre son catástrofe — las laptops duermen, los contenedores reinician — pero nunca deberían ser invisibles. Dailybot puede:

Generar alertas en canal o vía integraciones para que la sala correcta vea degradación rápido.

Marcar el agente obsoleto o fuera de línea en la UI, lo que ayuda a managers y dev leads durante incidentes o ventanas de release.

Disparar rutas de escalación cuando la política exige verificación humana — por ejemplo, si un agente de release deja de hacer heartbeat durante una ventana de deploy.

Encadenar la pérdida de heartbeat a escalación evita el peor caso: todos asumen que el agente terminó el trabajo cuando en realidad desapareció a mitad de tarea.

Ver el estado en el tablero

El tablero integra el estado derivado de heartbeat en tarjetas, tablas o filtros para que no inspecten cada integración individualmente. Ops suele mirar verde/rojo a nivel de flota durante incidentes; desarrolladores filtran a los agentes de su proyecto antes de un día de demo.

Usen el tablero como superficie de higiene diaria, no solo durante emergencias. Los equipos que miran una vez por standup detectan credenciales a la deriva y problemas de cuota mientras aún son baratos de arreglar.

Heartbeat frente a plantillas y playbooks

Las plantillas enseñan qué preguntar a los agentes en standups o check-ins. El seguimiento de heartbeat y estado enseña a la plataforma si el agente sigue ahí para responder. Ambos pertenecen a un setup maduro: las plantillas impulsan actualizaciones cualitativas; los heartbeats refuerzan vitalidad cuantitativa. Si solo tienen plantillas, aún pueden recibir texto rico de un proceso fantasma; si solo tienen heartbeats, saben uptime pero no progreso. Dailybot los combina para que los compañeros automatizados sigan rendiendo cuentas como esperan de los humanos: visibles, puntuales y honestos cuando se quedan en silencio.