Skip to main content

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_count with connection_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

OK