Monitoring and states

From the portal you can see, in real time, the status of all the agents in an environment. Knowing if an agent is available is the first thing you check when an automation is not running: without a online agent, executions are left waiting.

Machine states

State	Meaning	What to do
Disponible (Available)	Connected and free to receive executions	Nothing: it’s ready
Ocupada (Busy)	Running processes right now (Ocupada · N if it runs several sessions)	Wait for it to finish or use another machine
Desconectada (Disconnected)	No active connection to Zoan Cloud	Check the troubleshooting section
Suspendida (Suspended)	An administrator suspended it: it receives no executions	Reactivate it from its ⋮ menu when appropriate
En reposo (Idle)	Only for Zoan Cloud: cloud capacity is ready and starts when work arrives	Nothing

The status changes on its own, without you having to refresh the page.

The heartbeat

The agent sends Zoan Cloud a periodic heartbeat while connected - its way of saying “I’m still here.” If Zoan Cloud stops receiving heartbeats for more than 2 minutes, it considers the connection lost and marks the agent as offline automatically.

Note

This is why it can take up to ~2 minutes for an agent to switch to offline after, for example, your machine shuts down or your network goes down. It’s not a bug: it’s the grace period before declaring it offline.

Metrics Dashboard

Above the list of agents, the panel summarizes the status of the environment:

Metric	What it counts
Total	Machines registered in the environment
Conectadas (Connected)	With an active connection
Ocupadas (Busy)	Running a process right now
Desconectadas (Disconnected)	Without a connection
Disponibles (Available)	Connected and free, ready to receive an execution
Suspendidas (Suspended)	Suspended by an administrator

If Disponibles is 0, a new execution stays queued (queued) until a machine frees up or reconnects.

Troubleshooting

Agent appears offline right after connecting

• Verify that the Machine Key configured in the Agent is correct (without spaces at the beginning or end). See Settings.
• Make sure the machine has outgoing network access to the Zoan Cloud server on port 443 (HTTPS/WSS).
• If there is a corporate proxy, it should allow WebSocket (wss://) connections, not just regular HTTP.

The agent is online but does not receive executions

• Confirm that the process you are trying to run is assigned to that agent/environment. See Execute manually.
• Check that the agent is not busy with a hanging execution. If you suspect it is stuck, cancel it from the Runs tab.
• Verifies that the process package is in a version compatible with the packages installed on that agent.

The agent alternates between online and offline

• This usually indicates an unstable network connection or a proxy that is cutting off inactive WebSockets. Check that machine’s network stability and proxy settings.

Next steps

• Windows Installation — includes more installation diagnostics.
• States and life cycle of an execution.