Skip to main content
Retrieve current resource usage metrics for a sandbox.

​
Basic Request

curl -X GET https://api.gravixlayer.com/v1/agents/sandboxes/550e8400-e29b-41d4-a716-446655440000/metrics \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "timestamp": "2025-10-23T12:35:00Z",
  "cpu_usage": 45.5,
  "memory_usage": 1024.0,
  "memory_total": 2048.0,
  "disk_read": 1048576,
  "disk_write": 524288,
  "network_rx": 2097152,
  "network_tx": 1048576
}

​
Response Fields

FieldTypeDescription
timestampstringWhen metrics were collected (ISO 8601)
cpu_usagenumberCPU usage percentage (0-100)
memory_usagenumberMemory used in MB
memory_totalnumberTotal memory available in MB
disk_readintegerTotal disk bytes read
disk_writeintegerTotal disk bytes written
network_rxintegerTotal network bytes received
network_txintegerTotal network bytes transmitted

​
Usage Monitoring

Monitor resource usage to optimize performance:
  • CPU > 80%: Consider optimizing algorithms
  • Memory > 80%: Process data in chunks
  • High disk I/O: Optimize file operations

​
Next Steps

Update Timeout

Extend timeout for long-running tasks

Get Host URL

Access web services running in sandbox

Execute Code

Run code in your sandbox

Terminate Sandbox

Clean up resources when finished