Skip to main content

Monitor Infrastructure

Track CPU, memory, disk, and network metrics for your virtual machines via the monitoring API.

Base URL: https://cloud.octosinfra.com/backend/api


Get global monitoring overview

curl -X GET "https://cloud.octosinfra.com/backend/api/monitoring/global" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"

Get CPU usage

curl -X GET "https://cloud.octosinfra.com/backend/api/monitoring/{VIRTUAL_MACHINE_SLUG}/cpu-usage?monitoring_chart=cpu-usage&filter_by=24&hours=24" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"

Get memory usage

curl -X GET "https://cloud.octosinfra.com/backend/api/monitoring/{VIRTUAL_MACHINE_SLUG}/memory-usage?monitoring_chart=memory-usage&filter_by=24&hours=24" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"

Get disk read/write

curl -X GET "https://cloud.octosinfra.com/backend/api/monitoring/{VIRTUAL_MACHINE_SLUG}/disk-read-write?monitoring_chart=disk-read-write&filter_by=24&hours=24" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"

Get network traffic

curl -X GET "https://cloud.octosinfra.com/backend/api/monitoring/{VIRTUAL_MACHINE_SLUG}/network-traffic?monitoring_chart=network-traffic&filter_by=24&hours=24" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"

Endpoint reference

MetricMethodEndpoint
Global overviewGET/monitoring/global
CPU usageGET/monitoring/{SLUG}/cpu-usage
Memory usageGET/monitoring/{SLUG}/memory-usage
Disk read/writeGET/monitoring/{SLUG}/disk-read-write
Disk I/OGET/monitoring/{SLUG}/disk-io-read-write
Network trafficGET/monitoring/{SLUG}/network-traffic
Available chartsGET/monitoring/charts
tip

The filter_by and hours query parameters control the time range for monitoring data. Common values are 24 (last 24 hours), 168 (last 7 days), and 720 (last 30 days).