Metrics and telemetry ›

Get sandbox metrics

GET/v1/sandboxes/{id}/metrics

What one sandbox read between two moments: CPU, memory, disk and network.

RequestTypeScript

import { Agental } from "agental-sdk";
const agental = new Agental();
const sandbox = await agental.sandboxes.get("sbx_2a9a47e50daec64a");
const metrics = await sandbox.metrics();

Answer200 OK · SandboxMetrics

{
"sandboxId": string,
"since": string,
"until": string,
"stepSeconds": integer,
"keptDays": integer,
"points": [{
"at": string,
"cpuUtilization": number | null,
"memoryUsedBytes": number | null,
"memoryTotalBytes": number | null,
"diskUsedBytes": number | null,
"diskTotalBytes": number | null,
… 4 more
}],
"complete": boolean,
}

What one sandbox read between two moments: CPU, memory, disk and network, oldest first.

Path

idrequired

string

e.g. "sbx_0123456789abcdef"

Query

`since` string	Read from this moment. An hour before until when omitted. Readings are kept 15 days. e.g. `"2026-10-14T15:00:00Z"`
`until` string	Read up to this moment. Now when omitted, and never later than now.
`stepSeconds` integer	Seconds between two points, 60 at the least, which is how often a sandbox is read. When omitted, a step that gives about 360 points. e.g. `60`

Headers

Authorizationrequired

Bearer key

An API key that may make this call.

Returns

200 What one sandbox read between two moments: CPU, memory, disk and network, oldest first. There is no point for a moment it was stopped at, and none from before it was made. Nothing is asked of the sandbox itself, and nothing has to be installed in it.

SandboxMetrics7 fields

sandboxId

string

since

string

until

string

stepSeconds

integer

keptDays

integer

How long a reading is kept, in days.

points

MetricsReading[]10 fields

at

string

The moment of the reading.

cpuUtilization

numbernull

The share of the sandbox's CPUs' time that was not idle, 0 to 1.