GET /v1/agents/runtime/{runtime_id}/metrics
from gravixlayer import GravixLayer
client = GravixLayer() # defaults to cloud="aws", region="us-east-1"
sandbox = client.runtime.create() # defaults to template="base-small"
metrics = client.runtime.get_metrics(sandbox.runtime_id)
print(f"CPU: {metrics.cpu_usage}%")
print(f"Memory: {metrics.memory_usage} / {metrics.memory_total} MB")
print(f"Disk: read={metrics.disk_read} write={metrics.disk_write}")
print(f"Network: rx={metrics.network_rx} tx={metrics.network_tx}")
print(f"Time: {metrics.timestamp}")
sandbox.kill()
import { GravixLayer } from 'gravixlayer';
const client = new GravixLayer(); // defaults to cloud="aws", region="us-east-1"
const sandbox = await client.runtime.create(); // defaults to template="base-small"
const metrics = await sandbox.getMetrics();
console.log(`CPU: ${metrics.cpuUsage}%`);
console.log(`Memory: ${metrics.memoryUsage} / ${metrics.memoryTotal} bytes`);
console.log(`Disk: read=${metrics.diskRead} write=${metrics.diskWrite}`);
console.log(`Network: rx=${metrics.networkRx} tx=${metrics.networkTx}`);
console.log(`Time: ${metrics.timestamp}`);
await sandbox.kill();
# Requires: GRAVIXLAYER_API_KEY, jq
# Optional watch mode: gravixlayer runtime metrics "$RT" -w 5
RT=$(gravixlayer runtime create --wait --output json | jq -r '.runtime_id')
gravixlayer runtime metrics "$RT" --output json
gravixlayer runtime kill "$RT" -y
# Requires: GRAVIXLAYER_API_KEY, jq
API="https://api.gravixlayer.ai/v1"
AUTH=(-H "Authorization: Bearer $GRAVIXLAYER_API_KEY" -H "Content-Type: application/json")
RT=$(curl -sS -X POST "$API/agents/runtime" "${AUTH[@]}" \
-d '{"template":"base-small","cloud":"aws","region":"us-east-1"}' | jq -r '.runtime_id')
for i in $(seq 1 60); do
STATUS=$(curl -sS "$API/agents/runtime/$RT" -H "Authorization: Bearer $GRAVIXLAYER_API_KEY" | jq -r '.status')
[ "$STATUS" = "running" ] && break
sleep 2
done
curl -sS "$API/agents/runtime/$RT/metrics" \
-H "Authorization: Bearer $GRAVIXLAYER_API_KEY"
echo
curl -sS -X DELETE "$API/agents/runtime/$RT" \
-H "Authorization: Bearer $GRAVIXLAYER_API_KEY"
echo
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
runtime_id | string | Yes | Runtime identifier |
Response
| Field | Type | Description |
|---|---|---|
timestamp | string | Measurement timestamp |
cpu_usage | float | CPU usage percentage |
memory_usage | float | Memory used (MB) |
memory_total | float | Total memory (MB) |
disk_read | integer | Disk bytes read |
disk_write | integer | Disk bytes written |
network_rx | integer | Network bytes received |
network_tx | integer | Network bytes sent |
Platform Metrics
You can also view live metrics from the Gravix Layer Platform. Click the metrics icon on any running runtime to see real-time CPU, memory, disk I/O, network, processes, and uptime.