El watchdog es el mecanismo de recuperación de respaldo de Level para el servicio del agente. Si el servicio del agente se detiene, el administrador de servicios del SO gestiona la recuperación en la mayoría de los casos (el Administrador de Control de Servicios en Windows lo restaura en un plazo de 60 segundos mediante las opciones de recuperación del servicio). El watchdog se ejecuta de forma programada y existe para el raro caso en que el administrador de servicios no haya restaurado el servicio por sí solo.

Se ejecuta silenciosamente en segundo plano y no lo notará en condiciones normales. Si el watchdog reinicia el agente con frecuencia en un dispositivo determinado, tanto el administrador de servicios como el watchdog están trabajando más de lo que deberían, lo que significa que algo en el entorno está interfiriendo con Level.

Dos sistemas trabajan juntos para mantener el servicio de Level en funcionamiento. El administrador de servicios del SO es la primera línea: cuando el servicio se detiene, lo reinicia automáticamente (normalmente en un plazo de 60 segundos en Windows mediante las opciones de recuperación del servicio). El watchdog es la segunda línea, ejecutándose cada 10 minutos como verificación de que el administrador de servicios hizo su trabajo.

En su ciclo de 10 minutos, el watchdog responde a una pregunta: ¿está en ejecución el servicio del agente de Level y, si no es así, se puede reiniciar? Utiliza el administrador de servicios para leer el estado actual y luego realiza una de las siguientes acciones:

El watchdog no informa a Level, no genera alertas y no reinstala el agente. Es un bucle de autocorrección local, nada más.

Los detalles a continuación son específicos de Windows. En macOS y Linux, la recuperación la gestiona directamente el administrador de servicios del SO (consulte la siguiente sección).

En Windows, el watchdog es una Tarea Programada de Windows que se activa cada 10 minutos y ejecuta la rutina --check-service rutina. Cada ejecución pasa por tres pasos.

El watchdog utiliza el Administrador de Control de Servicios (SCM) para abrir el servicio de Level y leer su estado actual (En ejecución, Detenido, En pausa o ausente). Esta es la fuente de verdad sobre si el servicio está activo.

Si el SCM informa que el servicio está En ejecución, el watchdog intenta brevemente conectarse al agente a través del canal local de monitoreo/RPC. Esto detecta los casos en que el proceso del servicio está activo pero ha dejado de responder internamente.

Si esa conexión falla, el watchdog registra un error y continúa. No detiene el servicio basándose únicamente en esta comprobación. La recuperación sigue siendo impulsada por el siguiente paso.

Tras la verificación de estado, el watchdog siempre llama a la rutina EnsureRunning rutina. Aquí es donde ocurre la recuperación real:

La descripción de la tarea integrada lo resume: el watchdog existe para ayudar a mantener en ejecución el servicio de Windows de Level.

Level depende del administrador de servicios del SO para la recuperación en plataformas similares a Unix. El agente no ejecuta una comprobación programada separada como lo hace en Windows.

El resultado final es el mismo en todas las plataformas: un servicio detenido vuelve a funcionar sin intervención manual. El mecanismo difiere.

El watchdog no tiene lógica de suspensión ni de reanudación tras encendido. Ejecuta la misma comprobación de 10 minutos independientemente de si el dispositivo acaba de despertar o lleva una semana en funcionamiento.

El agente normalmente gestiona la suspensión por sí solo sin intervención. El proceso del servicio de Level sigue ejecutándose durante el modo de espera, por lo que la reanudación generalmente no requiere nada específico para recuperarse. La suspensión sí parece correlacionarse con problemas de red extraños (el estado DNS obsoleto es uno habitual), pero la recuperación de estos no es específica de la suspensión.

El agente tiene un monitor de conexión independiente que se ejecuta internamente. Su función principal es detectar conexiones obsoletas: cuando algunas conexiones salientes funcionan y otras no (el DNS en caché es un ejemplo típico), el monitor reinicia el agente para forzar un estado nuevo. Esta no es una función de recuperación tras suspensión, aunque a veces ayuda con los problemas de red provocados por la suspensión como efecto secundario.

Un reinicio ocasional es normal y rara vez merece investigación. Un fallo transitorio, un pico de recursos, un proceso interferente breve: cualquiera de estos puede causar un reinicio puntual, y el agente vuelve sin que nadie lo note.

Un patrón de reinicios frecuentes es diferente. El SCM debería gestionar la mayoría de los fallos del servicio en un plazo de 60 segundos, y el watchdog rara vez debería necesitar intervenir. Si el watchdog está restaurando el servicio repetidamente en el mismo dispositivo, algo en ese dispositivo está impidiendo que el agente funcione con normalidad.

Causas comunes: