# Sandbox metrics (/docs/sandbox/metrics)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1135 · updated: 2026-07-30 -->
Related: [Auto-resume on request](/docs/sandbox/auto-resume.md), [Connect to running sandbox](/docs/sandbox/connect.md), [Environment variables](/docs/sandbox/environment-variables.md), [Filesystem-only snapshots](/docs/sandbox/filesystem-only-snapshots.md), [Sandbox forking](/docs/sandbox/fork.md), [Git integration](/docs/sandbox/git-integration.md)

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

## Getting sandbox metrics [#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 [#getting-sandbox-metrics-using-the-sdks]

<CodeGroup>
  <CodeBlockTabs defaultValue="JavaScript & TypeScript" groupId="javascript-typescript+python">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="JavaScript & TypeScript">
        JavaScript & TypeScript
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Python">
        Python
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="JavaScript & TypeScript">
      ```js highlight={9}  
      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
      //   }
      // ]
      ```
    </CodeBlockTab>

    <CodeBlockTab value="Python">
      ```python highlight={10}  
      from time import sleep
      from e2b import Sandbox

      sbx = Sandbox.create()
      print('Sandbox created', sbx.sandbox_id)

      # Wait for a few seconds to collect some metrics
      sleep(10)

      metrics = sbx.get_metrics()

      # You can also get the metrics by sandbox ID:
      # metrics = Sandbox.get_metrics(sbx.sandbox_id)

      print('Sandbox metrics', metrics) 

      # Sandbox metrics
      # [
      #     SandboxMetric(
      #         cpu_count=2,
      #         cpu_used_pct=13.97,
      #         disk_total=2573185024,  # in bytes
      #         disk_used=1514856448,  # in bytes
      #         mem_total=507592704,  # in bytes
      #         mem_used=30588928,  # in bytes
      #         timestamp=datetime.datetime(2025, 7, 28, 8, 8, 15, tzinfo=tzutc()),
      #     ),
      #     SandboxMetric(
      #         cpu_count=2,
      #         cpu_used_pct=0.1,
      #         disk_total=2573185024,  # in bytes
      #         disk_used=1514856448,  # in bytes
      #         mem_total=507592704,  # in bytes
      #         mem_used=31084544,  # in bytes
      #         timestamp=datetime.datetime(2025, 7, 28, 8, 8, 20, tzinfo=tzutc()),
      #     ),
      # ]
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

### Getting sandbox metrics using the CLI [#getting-sandbox-metrics-using-the-cli]

<CodeGroup>
  <CodeBlockTabs defaultValue="Terminal" groupId="terminal">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Terminal">
        Terminal
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="Terminal">
      ```bash highlight={1}  terminal 
      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
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

<Note>
  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.
</Note>