System VM shows Agent State = Disconnected in UI while host/agent is actually Up

[rosi-shapeblue]

problem

When deploying new Console Proxy VMs (CPVMs), the CloudStack UI occasionally displays Agent State = Disconnected (grey dot) even though the management server, API, and database confirm the agent is connected and in Up state.

The discrepancy is resolved after stop/start of the CPVM, suggesting a UI polling or state refresh issue rather than an agent connectivity failure.

versions

ACS 4.21, KVM

The steps to reproduce the bug

1. Configure console proxy limits to force new CPVMs (from Global settings):

consoleproxy.launch.max: 3
onsoleproxy.session.max: 10
consoleproxy.capacity.standby:25

2. Restart management server to promote the changes to the config

3. Observe the System VMs list in the UI after the new CPVMs come up.

Evidence / Actual Result:

UI shows v-9-VM with Agent State = Disconnected (grey dot).

API/DB show the CPVM host is Up:

SELECT id,name,status,mgmt_server_id,last_ping FROM host WHERE id=8;
+----+--------------------+--------+----------------+
| id | name | status | last_ping |
+----+--------------------+--------+----------------+
| 8 | v-9-VM/10.0.59.204 | Up | advancing |
+----+--------------------+--------+----------------+

Management server logs show continuous pings and load reports:

Ping from AgentAttache {"_id":8,"_name":"v-9-VM/10.0.59.204", ...}
ConsoleProxyLoadReportCommand {"_proxyVmId":"8", ...}

After stop/start of the CPVM, the UI correctly updates to Agent State = Up.

What to do about it?

Once the CPVM connects and reports to the management server, the UI should update Agent State = Up in sync with the backend, without requiring manual restart or page refresh.