Vercel 为 Sandbox 的可观测性补上内存维度

Vercel 为 Sandbox 可观测性补上内存维度:Dashboard 的 Memory Usage 卡片给出平均、P75 与 P95,沙箱详情页纵轴按内存上限缩放并在 85% 处画参考线,查询构建器提供 memoryUsedBytes 度量,CLI 用 vercel metrics 读取 vercel.sandbox.memory_used_bytes,--all 可看团队级聚合。

用 Apifox,节省研发团队的每一分钟

Vercel 为 Sandbox 的可观测性补上内存维度

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

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

Vercel Dashboard 的 Memory Usage 卡片截图:横轴为近 12 小时,纵轴到 5GB,标出 Average 743.09 MB、P75 804.88 MB、P95 2.16 GB,并带有 P95 峰值处的时间窗提示
Vercel Dashboard 的 Memory Usage 卡片:平均值、P75 与 P95 三档,以及可悬停查看的时间窗。来源:Vercel 官方 Changelog 截图

沙箱类产品的资源账单有个老问题: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 里留一份资源快照的团队来说,这些字段已经够用。

编辑绘制的信息图:Vercel Sandbox 内存数据的四个可查位置、85% 参考线、memoryUsedBytes 与 vercel.sandbox.memory_used_bytes 两个标识符,以及项目级与团队级的口径差异
编辑绘制 · 事实取自 Vercel 官方 Changelog

为什么这会改变工作流

第一个改变是资源调优从「经验」变成「数据」。沙箱这类产品通常按配置的内存上限计价或限流,团队过去为了保证不出问题倾向于给足内存,代价是成本上浮。有了 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 编程的实际用法、开发工作流,还有各种新工具和新玩法。