Monitoreo y estados

Desde el portal puedes ver, en tiempo real, el estado de todos los agentes de un entorno. 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 del agente

Estado	Color	Significado	Qué hacer
online	🟢 Verde	Conectado y disponible para recibir ejecuciones	Nada — está listo
busy	🟠 Naranja	Ejecutando un proceso en este momento	Espera a que termine, o usa otro agente
offline	⚪ Gris	Sin conexión activa con Nexus	Revisa la solución de problemas

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

El heartbeat

El agente envía a Nexus un heartbeat (latido) periódico mientras está conectado: es su forma de decir “sigo aquí”. Si Nexus 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 entorno:

Métrica	Qué cuenta
Total	Agentes registrados en el entorno
Online	Conectados y disponibles
Ocupados	Ejecutando un proceso ahora mismo
Offline	Sin conexión
Disponibles	Online y libres, listos para recibir una ejecución

Si Disponibles es 0, una nueva ejecución quedará en cola (queued) hasta que un agente 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 Nexus 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 / entorno. 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.