摘要:2026 年 9 月 25 日,Vercel 为 Sandbox 的可观测性补上内存维度。Dashboard 的 Memory Usage 卡片给出平均值、P75 与 P95,Sandbox 详情页的图表会把纵轴自动缩放到该沙箱的内存上限,并在上限 85% 处画一条虚线参考线;命令行侧用 vercel metrics 读取,度量名为 vercel.sandbox.memory_used_bytes。查询构建器里对应 sandbox usage 事件上的 memoryUsedBytes 度量。Vercel 未在公告中给出定价、配额或额外端点信息。

沙箱类产品的资源账单有个老问题:CPU 和数据传输早就被画成曲线,内存却只能靠猜。沙箱被 OOM 杀掉时,你看到的是进程突然消失,而不是一条冲到上限的曲线。事后复盘只能不断缩小复现范围,直到某一次改动能稳定复现。
9 月 25 日,Vercel 把内存使用数据接进了 Sandbox 的可观测性:不只是加一条线,还给出了上限口径和团队级聚合。对跑 Agent、构建任务或一次性代码执行的团队来说,这解决的是「能不能在故障发生前看见它」的问题。下面把可查的位置、指标名和它仍然缺什么说清楚。
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。
发生了什么:内存进入 Dashboard、查询构建器与 CLI
这次更新由 Vercel 的 Tom Lienard 与 Eric Dodds 发布,公告的表述是「Sandbox 可观测性现在包含内存使用数据」。数据出现在三个层面的界面上,另有一个命令行入口。
Dashboard 侧有两处。沙箱总览页新增 Memory Usage 卡片,报告的是一批沙箱的平均值、P75 与 P95,与既有的 CPU、数据传输指标并列;同样的卡片也出现在项目级与团队级的页面上。沙箱详情页的图表则换了口径——它不关心一批沙箱的分布,而是关心单个沙箱离自己的上限还有多远,做法是把纵轴自动缩放到该沙箱的内存上限,并在上限的 85% 处画一条虚线参考线。
这两处设计上的分工值得留意:概览页回答「整体是不是吃紧了」,详情页回答「这个沙箱会不会炸」。85% 这条线并没有什么魔法,它只是把「快到头了」这件事变得可以一眼看见,而不是要求值班的人先记住每个沙箱的上限是多少。
一个具体场景:Agent 任务被杀之前的十分钟
设想一个跑代码执行 Agent 的团队。任务在 Sandbox 里运行,偶尔会因为内存不足被终止,用户端看到的是「任务失败」,日志里只有进程退出的痕迹。
接入内存指标后,值班的人可以在沙箱详情页上看到那条曲线在终止前持续贴着 85% 参考线运行,从而把「随机失败」重新定义成一个可复现的资源问题:是上下文文件被整个读进内存,还是某个工具调用返回了远超预期的大对象。更进一步,可以在查询构建器里对 memoryUsedBytes 写下自定义查询并挂上告警,把「事后看曲线」变成「临限时被叫醒」。
命令行则适合放进流水线或本地复现。在已关联的项目目录里执行 vercel metrics,得到的是项目范围的数据;加上 --all 之后是团队级聚合。它的输出包含度量名、统计周期、测量间隔、所属项目,以及一张带 min、max、avg 的使用曲线——对一个想在 CI 里留一份资源快照的团队来说,这些字段已经够用。

为什么这会改变工作流
第一个改变是资源调优从「经验」变成「数据」。沙箱这类产品通常按配置的内存上限计价或限流,团队过去为了保证不出问题倾向于给足内存,代价是成本上浮。有了 P95 这个口径之后,团队至少可以回答一个具体问题:把上限往下调一档,是否仍然覆盖 95% 的运行——P95 的用途正是暴露那些被平均值掩盖的尖峰。
第二个改变在告警链路上。公告说明可以从图表直接设置告警,这意味着内存不再只是 Dashboard 上一个供人巡视的数字,而可以成为触发条件。对无人值守的 Agent 流水线来说,这是把「有人看到」换成「系统叫醒人」的关键一步。
第三个改变是把 CLI 变成可审计入口。vercel metrics 输出里包含统计周期与测量间隔,意味着这份数据可以被写进构建记录或发布检查单,而不只是截一张图贴在群里。对一个需要向他人解释「为什么这次要把内存调大」的团队来说,这比口头描述更有说服力。
限制、边界与人应该在哪儿接手
官方公告的边界需要说清楚:它没有给出任何定价、计费、配额、区域或套餐档位的信息。也就是说,内存数据现在是「可观测」的,但这篇公告本身没有说明观测到的用量如何计费。真正要控成本,还得回到 Sandbox 的计费文档,不能把这次的指标当作账单依据。
第二,公告没有点名任何 REST 或 HTTP 端点,也没有给请求格式与认证细节。数据目前通过 Dashboard、查询构建器和 CLI 三种表面暴露。如果团队想要把指标接进自己的监控系统,需要先确认查询构建器所能对接的范围,而不要假设存在一个可以直接 curl 的指标接口。
第三,详情页的 85% 参考线是一个视觉提示,不是阈值策略。它不会替你终止任务,也不会自动扩容。把它当告警阈值时,需要结合具体工作负载——批量构建和常驻 Agent 的合理水位并不一样。人在这里的位置很清楚:决定 85% 是「该看一眼」还是「该立刻处理」,并把这个判断写进告警配置,而不是留在某个人的经验里。
如何试用
先在一个已有的 Sandbox 项目上打开 Dashboard,确认沙箱总览页出现 Memory Usage 卡片,并观察 P75 与 P95 之间的差距;随后进入某个沙箱详情页,确认纵轴按内存上限缩放、85% 参考线存在。命令行侧在已关联项目目录执行 vercel metrics,核对输出中的度量名与统计周期,再追加 --all 对比团队级聚合。如果要做告警,回到查询构建器针对 memoryUsedBytes 建立查询并从图表挂上告警规则。
信息来源
- Vercel Changelog:Vercel Sandbox now supports memory observability(2026-09-25,作者 Tom Lienard、Eric Dodds)— https://vercel.com/changelog/vercel-sandbox-now-supports-memory-observability
- Vercel Docs:Sandbox(沙箱资源与可观测性文档)
- Vercel Docs:Observability 查询构建器与 vercel metrics 命令行
HiFox :将 Agent 变成真正的队友
另外,我们也在思考,AI 如何从个人提效走进团队协作。
HiFox 是一个让人和 AI Agent 在同一个工作现场协作的平台:你可以像给同事分派任务一样指派 Agent,在任务看板中跟踪进度、查看结果,让 Agent 成为团队里的队友。
👉 立即体验 Hifox:https://hifox.com
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。