Vercel分析工具支持自定义环境，预览数据归属更精准

Vercel 的 Speed Insights 和 Web Analytics 近期完成了一项重要更新：自定义环境（custom environments）的数据不再被笼统归入 Preview 环境，而是被单独统计和展示。对于依赖 staging、QA 或 canary 环境进行发布验证的团队来说，这意味着性能与流量数据终于可以按环境精确切分。

数据归属逻辑的修正：从“混入预览”到“独立统计”

此前，部署到自定义环境的项目，其采集到的性能指标和访问数据都会被算在 Preview 环境名下。这导致一个典型问题：当团队同时运行多个预览环境时，无法判断某次性能回归究竟来自 staging 验证还是 QA 测试。

更新后，数据会归属于实际来源的自定义环境。生产环境、预览环境和自定义环境在统计层面彻底分开，staging、QA、canary 等环境的性能表现和流量可以独立追踪。官方说明强调，这次改动只影响数据归属方式，不涉及新增数据点，也无需任何配置调整。换句话说，已有的项目无需做任何操作，就能自动获得更细粒度的数据视图。

Preview 环境与自定义环境的区别：在 Vercel 的部署模型中，Production 对应主域名上的正式版本，每次推送都会更新；Preview 则是为每个分支或 PR 自动生成的临时部署，拥有独立 URL。自定义环境是在 Preview 之上进一步细分的命名环境，例如 staging、QA、canary，它们可以绑定独立的域名、环境变量和部署规则。此前 Speed Insights 与 Web Analytics 只按 Production / Preview 两个桶归类，因此所有自定义环境的数据都被折叠进 Preview。区分二者的关键在于：Preview 是默认的、按分支自动产生的环境集合，而自定义环境是团队显式创建、带有语义标签的部署目标。理解这一层级关系，才能明白为何数据归属修正对多环境发布流程意义重大。

四个入口查看自定义环境数据

数据归属调整之后，Vercel 在多个使用路径上都放开了自定义环境的筛选能力：

• Dashboard：Speed Insights 和 Web Analytics 的环境下拉菜单中，自定义环境会与 Production、Preview 并列显示，可直接切换查看。
• CLI：通过 vc metrics 命令查询对应环境的数据。
• Query builder：支持按环境进行过滤和拆分，便于做对比分析。
• Aggregation API：可以编程方式查询环境数据，目前该能力仅限 Web Analytics。

这种多入口覆盖意味着，无论是日常在控制台看板盯指标，还是在 CI 流程中用命令行拉取数据，或者通过 API 构建自定义报表，都能拿到按环境区分后的结果。

Aggregation API 与 Query builder 的定位差异：Aggregation API 是 Vercel 提供的编程接口，允许开发者通过 HTTP 请求拉取聚合后的分析数据，适合接入自有 BI 工具或定时任务；Query builder 则是 Dashboard 内的可视化查询界面，通过点选维度和过滤条件生成查询，无需写代码。两者的共同点是都支持按环境维度过滤和拆分，区别在于前者面向自动化集成，后者面向人工探索。本次更新中 Aggregation API 仅覆盖 Web Analytics，意味着 Speed Insights 的性能指标暂时只能通过 Dashboard 或 CLI 获取，构建全自动性能报表的团队需要绕道 CLI 的 vc metrics 命令。

谁能用，以及值得关注的细节

自定义环境属于 Pro 和 Enterprise 套餐的能力。如果团队已经在使用这些套餐并配置了自定义环境，本次更新可以直接受益；如果尚未启用自定义环境，则需要先参考 environments 文档完成配置。

从实践角度看，这项更新解决的是可观测性中一个常见但容易被忽视的问题：数据归属粒度。当发布流程从单一生产环境扩展到多环境验证时，如果分析工具不能区分数据来源，性能监控就会失去定位问题的能力。Vercel 把自定义环境纳入统计维度，本质上是在让分析数据与部署结构保持一致。对于采用 canary 发布或需要独立 QA 验证的团队，这能让性能对比和流量分析更有依据。

需要注意的是，聚合 API 目前仅支持 Web Analytics，Speed Insights 的编程查询能力尚未覆盖到这一层，有自动化需求的团队需要留意这一限制。