跳转到主要内容
沙箱 “监控指标” 功能可以允许您获取有关沙箱 vCPU 和内存使用情况 的信息。

​
获取监控指标信息

指标信息以一个包含时间戳的数组形式提供（参考下方示例），包含 vCPU 和内存使用信息。指标在沙箱启动时开始采集，之后每 2 秒采集一次，在沙箱被删除前会采集最后一次。
在沙箱创建后，可能需要等待几秒后才能获取到指标信息，在这之前，将会得到一个空数组。

​
使用 SDK 获取指标信息

import { Sandbox } from 'ppio-sandbox/code-interpreter'

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

let metrics = await sandbox.getMetrics()

// 您也可以通过指定沙箱 ID 来获取指标信息
// const metrics = await Sandbox.getMetrics(sandboxId)

while (metrics && metrics.length <= 1) {
    console.log('Waiting for metrics...')
    await new Promise(resolve => setTimeout(resolve, 1000))
    metrics = await sandbox.getMetrics()
}

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

await sandbox.kill()

// 输出示例：
// Sandbox metrics: [
//     {
//       cpuCount: 2,
//       cpuUsedPct: 15.92,
//       memTotalMiB: 987,
//       memUsedMiB: 245,
//       timestamp: '2025-06-22T06:54:28.234Z'
//     },
//     {
//       cpuCount: 2,
//       cpuUsedPct: 0.8,
//       memTotalMiB: 987,
//       memUsedMiB: 246,
//       timestamp: '2025-06-22T06:54:33.232Z'
//     }
//   ]

​
使用 CLI 获取指标信息

ppio-sandbox-cli sandbox metrics <sandbox_id>
⌘I