Skip to main content

Documentation Index

Fetch the complete documentation index at: https://e2b.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The sandbox metrics allows you to get information about the sandbox’s CPU, memory and disk usage.

Getting sandbox metrics

Getting the metrics of a sandbox returns an array of timestamped metrics containing CPU, memory and disk usage information. The metrics are collected every 5 seconds.

Getting sandbox metrics using the SDKs

import { Sandbox } from 'e2b'

const sbx = await Sandbox.create()
console.log('Sandbox created', sbx.sandboxId)

// Wait for a few seconds to collect some metrics
await new Promise((resolve) => setTimeout(resolve, 10_000))

const metrics = await sbx.getMetrics()

// You can also get the metrics by sandbox ID:
// const metrics = await Sandbox.getMetrics(sbx.sandboxId)

console.log('Sandbox metrics:', metrics)

// Sandbox metrics:
// [
//   {
//     timestamp: 2025-07-28T08:04:05.000Z,
//     cpuUsedPct: 20.33,
//     cpuCount: 2,
//     memUsed: 32681984,  // in bytes
//     memTotal: 507592704,  // in bytes
//     diskUsed: 1514856448,  // in bytes
//     diskTotal: 2573185024  // in bytes
//   },
//   {
//     timestamp: 2025-07-28T08:04:10.000Z,
//     cpuUsedPct: 0.2,
//     cpuCount: 2,
//     memUsed: 33316864,  // in bytes
//     memTotal: 507592704, // in bytes
//     diskUsed: 1514856448,  // in bytes
//     diskTotal: 2573185024  // in bytes
//   }
// ]

Getting sandbox metrics using the CLI

e2b sandbox metrics <sandbox_id> 

# Metrics for sandbox <sandbox_id>
# 
# [2025-07-25 14:05:55Z]  CPU:  8.27% /  2 Cores | Memory:    31 / 484   MiB | Disk:  1445 / 2453  MiB
# [2025-07-25 14:06:00Z]  CPU:   0.5% /  2 Cores | Memory:    32 / 484   MiB | Disk:  1445 / 2453  MiB
# [2025-07-25 14:06:05Z]  CPU:   0.1% /  2 Cores | Memory:    32 / 484   MiB | Disk:  1445 / 2453  MiB
# [2025-07-25 14:06:10Z]  CPU:   0.3% /  2 Cores | Memory:    32 / 484   MiB | Disk:  1445 / 2453  MiB
It may take a second or more to get the first metrics after the sandbox is created. Until the first metrics are collected from the sandbox, you will get an empty array.