Cable Agent Status | UFM Cable Validation Tool

REST APIs to check agent status

Check the CVT version running on the agent using /version endpoint of the agent.
Example:
```
# curl -k https://<hostname/IP>:8251/version
{"agent_version": "1.8.1-4"}
```

Check the agent status using /status endpoint of the agent. It reports the current validation state and to which collector it is sending reports among other details.
Example:

# curl -k https://<hostname/IP>:8251/status
{"state": "validating", "state_since": 1771547598, "auto_transition_via_idle": true, "collector_ip": "<ip>", "last_publish_time": 1771610839}

Note: The above REST APIs would fail even if the agent is installed and running if the port 8251 is blocked.

Check if Agent Container is running

On InfiniBand

Check if cable agent is running on the switch:

Run:
```
ssh admin@<switch-ip-or-name>
```
Enable
Show docker images
Exit

If cables agent is running on the switch, the following output is prompted.

----------------------------------------------------------------------------
Image                                 Version      Created            Size
----------------------------------------------------------------------------
cables_agent                          latest       13 hours ago       788MB

On Ethernet, NVOS, and Hosts

Check if cable agent is running on the switch:

Run:
```
ssh admin@<switch-ip-or-name>
```
docker ps

If cables agent is running on the switch, the following output is prompted.

----------------------------------------------------------------------------
Image                                 Version      Created            Size
----------------------------------------------------------------------------
cables_agent                          latest       13 hours ago       788MB

Last updated: June 03, 2026