Skip to content

`GET /api/v1/agents/{node_id}/metrics/latest` — latest metrics snapshot.

GET
/api/v1/agents/{node_id}/metrics/latest
curl --request GET \
--url https://example.com/api/v1/agents/example/metrics/latest
node_id
required
string

Agent node ID

Latest metrics sample

Media type application/json

A single metrics sample in an API response.

Mirrors the wire format MetricsReport and the stored MetricsSnapshot. All metric fields are nullable: a null value means the agent could not collect that metric (the OS does not expose it, the agent has metrics disabled, or the metric is not yet implemented for this platform).

object
collected_at
required

UNIX timestamp (seconds) when the agent took this sample.

integer format: int64
cpu_usage

System-wide CPU usage at sample time, as a percentage (0–100).

number | null format: float
disk_total

Total disk space across all mounted non-virtual filesystems, in bytes.

integer | null format: int64
disk_used

Used disk space across all mounted non-virtual filesystems, in bytes.

integer | null format: int64
memory_total

Total physical memory in bytes.

integer | null format: int64
memory_used

Used physical memory in bytes.

integer | null format: int64
uptime

Time since last boot in seconds.

integer | null format: int64
Example generated
{
"collected_at": 1,
"cpu_usage": 1,
"disk_total": 1,
"disk_used": 1,
"memory_total": 1,
"memory_used": 1,
"uptime": 1
}

No samples for this agent