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

​
Basic Usage

from gravixlayer import GravixLayer

client = GravixLayer(api_key="YOUR_API_KEY")

metrics = client.sandbox.sandboxes.get_metrics("your-sandbox-id")
print(f"CPU: {metrics.cpu_usage}%")
print(f"Memory: {metrics.memory_usage}/{metrics.memory_total}MB")
print(f"Disk read: {metrics.disk_read} bytes")
print(f"Disk write: {metrics.disk_write} bytes")

​
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