Live Dashboard (Grafana)
Use the RMM API to build a real-time dashboard that displays the health of your managed devices.
The Summary endpoint provides an overview of the entire device fleet, including resource usage, security status, storage health, and alerts. Most dashboards only need this endpoint for their main view.
Fleet health overview
| Endpoint | What it returns |
|---|---|
| GET /api/v1/computers/stat/summary/latest (fleet-wide, paged) | Returns a health summary for every managed device, including CPU, memory, disk usage, antivirus status, operating system update status, SMART status, and alerts. |
Device details
| Endpoint | What it returns |
|---|---|
| GET /api/v1/computers/{hid}/stat/runtime/latest (single device) | Returns the currently running processes, including CPU and memory usage. |
| GET /api/v1/computers/{hid}/stat/eventtotal/latest (single device) | Returns the number of events collected during the latest agent synchronization. This can help identify unusually active systems. |
The system update status returned by the summary/latest endpoint includes operating system updates only.
If your dashboard reports patch compliance, also query the Software Inventory endpoint as described in Patch and Windows Update Status Monitoring to include updates for third-party applications managed through Winget or Homebrew.
Recommended approach
- Retrieve data from the fleet-wide Summary endpoint.
- Store the results in your preferred monitoring database (for example, InfluxDB or TimescaleDB).
- Build dashboard panels to display overall device health, resource utilization, security status, and alerts.
- When a device requires investigation, query the per-device Runtime and Event Total endpoints for additional details.
Recommended polling interval: Poll the Summary endpoint every 60 minutes for general health information.
If your dashboard also displays alerts, poll the Summary endpoint every 10 minutes. Alert data is refreshed every 10 minutes, while the remaining fields are updated hourly.