Add metrics methods to SDKs

[0div]

Description

Consolidate the branches from #523, #524 & #525

This relates to E2B-1311

Test

[js-sdk] pnpm test metrics
[python-sdk] poetry run pytest -n 4 --verbose -x -k "test_metrics"`

Usage

js-sdk

import { Sandbox } from '@e2b/code-interpreter'

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

const metrics = await sbx.getMetrics() 
console.log('Sandbox metrics:', metrics)

/*
[
  {
    cpuCount: 2,
    cpuPct: 50.05,
    memTotalMiB: 484,
    memUsedMiB: 37,
    timestamp: '2025-01-23T23:44:12.222Z'
  },
  {
    cpuCount: 2,
    cpuPct: 4.5,
    memTotalMiB: 484,
    memUsedMiB: 37,
    timestamp: '2025-01-23T23:44:13.220Z'
  }
]
*/

python-sdk

from e2b_code_interpreter import Sandbox

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

metrics = sbx.get_metrics() 
print('Sandbox metrics', metrics) 


# [
#     SandboxMetrics(timestamp=datetime.datetime(2025, 1, 23, 23, 58, 42, 84050, tzinfo=tzutc()), cpu_pct=50.07, cpu_count=2, mem_used_mib=37, mem_total_mib=484), 
#     SandboxMetrics(timestamp=datetime.datetime(2025, 1, 23, 23, 58, 44, 84845, tzinfo=tzutc()), cpu_pct=4.75, cpu_count=2, mem_used_mib=38, mem_total_mib=484),
# ]

cli

jonas@mac cli % pnpm build
jonas@mac cli % E2B_DOMAIN=goulash.dev ./dist/index.js sbx sp
jonas@mac cli % E2B_DOMAIN=goulash.dev ./dist/index.js sbx metrics {sandbox_id}

Metrics for sandbox {sandbox_id}

[2025-01-23 00:58:58.829Z]  { cpuCount: 2, cpuPct: 50.21, logger: '', memTotalMiB: 484, memUsedMiB: 38, timestamp: '2025-01-23T00:58:58.829638869Z' }
[2025-01-23 00:59:03.814Z]  { cpuCount: 2, cpuPct: 5.16, logger: '', memTotalMiB: 484, memUsedMiB: 37, timestamp: '2025-01-23T00:59:03.814028031Z' }
[2025-01-23 00:59:08.815Z]  { cpuCount: 2, cpuPct: 1.6, logger: '', memTotalMiB: 484, memUsedMiB: 37, timestamp: '2025-01-23T00:59:08.815933749Z' }

[linear]

E2B-1311 Add metrics method to sandbox to SDKs that returns captured metrics

[changeset-bot]

⚠️ No Changeset found

Latest commit: d920f54

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[jakubno]

Last few small NITs 🙏🏻

[jakubno]

LGTM

[0div]

gonna try the stress test with 400 sanboxes on my 96 core to see how it behaves

[mlejva]

Can you pls share a code snippet showing the usage from SDK (or update the PR's description)? I'm interested in the methods that the users will be interacting with

EDIT: Ignore me, I'm checking the preview of docs
EDIT 2: It's missing docs