Monitoreo y estados

Desde el portal puedes ver, en tiempo real, el estado de todos los agentes de un ambiente. Saber si un agente está disponible es lo primero que revisas cuando una automatización no se ejecuta: sin un agente online, las ejecuciones se quedan esperando.

Estados de la máquina

Estado	Significado	Qué hacer
Disponible	Conectada y libre para recibir ejecuciones	Nada: está lista
Ocupada	Ejecutando procesos en este momento (Ocupada · N si corre varias sesiones)	Espera a que termine o usa otra máquina
Desconectada	Sin conexión activa con Zoan Cloud	Revisa la solución de problemas
Suspendida	Un administrador la suspendió: no recibe ejecuciones	Reactivar desde su menú ⋮ cuando corresponda
En reposo	Solo para Zoan Cloud: la capacidad en la nube está lista y arranca al llegar trabajo	Nada

El estado cambia solo, sin que tengas que refrescar la página.

El heartbeat

El agente envía a Zoan Cloud un heartbeat (latido) periódico mientras está conectado: es su forma de decir “sigo aquí”. Si Zoan Cloud deja de recibir heartbeats durante más de 2 minutos, da por perdida la conexión y marca el agente como offline automáticamente.

Nota

Por esto un agente puede tardar hasta ~2 minutos en pasar a offline después de que, por ejemplo, se apaga su máquina o se cae su red. No es un error: es el período de gracia antes de declararlo desconectado.

Panel de métricas

Encima de la lista de agentes, el panel resume el estado del ambiente:

Métrica	Qué cuenta
Total	Máquinas registradas en el ambiente
Conectadas	Con conexión activa
Ocupadas	Ejecutando un proceso ahora mismo
Desconectadas	Sin conexión
Disponibles	Conectadas y libres, listas para recibir una ejecución
Suspendidas	Suspendidas por un administrador

Si Disponibles es 0, una nueva ejecución quedará en cola (queued) hasta que una máquina se libere o vuelva a conectarse.

Solución de problemas

El agente aparece offline justo después de conectarse

• Verifica que la Machine Key configurada en el Agent sea la correcta (sin espacios al inicio o final). Ver Configuración.
• Asegúrate de que la máquina tenga acceso de red saliente al servidor de Zoan Cloud en el puerto 443 (HTTPS/WSS).
• Si hay un proxy corporativo, debe permitir conexiones WebSocket (wss://), no solo HTTP normal.

El agente está online pero no recibe ejecuciones

• Confirma que el proceso que intentas ejecutar esté asignado a ese agente / ambiente. Ver Ejecutar manualmente.
• Revisa que el agente no esté busy con una ejecución colgada. Si sospechas que quedó atascada, cancélala desde la pestaña Ejecuciones.
• Verifica que el paquete del proceso esté en una versión compatible con los paquetes instalados en ese agente.

El agente alterna entre online y offline

• Suele indicar una conexión de red inestable o un proxy que corta los WebSockets inactivos. Revisa la estabilidad de la red de esa máquina y la configuración del proxy.

Siguientes pasos

• Instalación en Windows — incluye más diagnóstico de instalación.
• Estados y ciclo de vida de una ejecución.