Get Fleet Statistics
GET/nodes/stats
Returns aggregate statistics and metrics across your edge node fleet.
What You Get
- Total node count and breakdown by connection state
- Aggregate resource usage (total/average CPU, memory, disk)
- Node health distribution (healthy, degraded, unhealthy)
- Fleet-wide capacity metrics
When to Use
- Monitor overall fleet health at a glance
- Capacity planning and resource forecasting
- Dashboard metrics and alerting
- Trend analysis over time
Filtering
connection_states: Include only nodes in specific states (connected, disconnected, etc.)
Use Cases
- "How many nodes are currently connected?" - Check
total_countwithconnection_states=connected - "What's my fleet's average resource utilization?" - Review aggregate CPU/memory/disk metrics
- "Do I have capacity for new jobs?" - Compare used vs total resources
Request
Responses
- 200
- 400
- 500
OK
Invalid connection state
Internal Server Error