Vercel Tracing 现已全面开放
内容提要
Vercel Tracing 已全面开放，所有套餐均可使用。用户可在仪表板或 CLI 中搜索和检查追踪数据；新 Next.js 项目默认启用追踪，价格与测试版相同。新增的 Traces 页面可集中查看所有追踪与跨度，支持 KQL 搜索、筛选和实时模式，CLI 使用相同查询语法。自 Next.js 16.5 起，含 Node.js 函数的新项目在首次构建成功后自动启用 100% 采样追踪，可在设置中退出。追踪保留期为 Hobby 3 天、Pro 和 Enterprise 14 天。
延伸解读
从按请求查看升级为全局追踪视图
测试版只能从日志页逐个请求打开追踪，排查问题时需要先定位请求再查看链路。正式版新增的 Traces 页面把项目和团队的所有追踪与跨度集中展示，支持在 Spans 列表和 Traces 列表间切换、筛选，并用 KQL 搜索。Live 模式还能实时流入新追踪，适合观察正在发生的请求，而不必反复刷新或逐个打开日志。
仪表板与 CLI 共用同一套查询语法
Traces 页面使用的 KQL 与 vercel traces search --query 完全一致，因此在仪表板里调好的查询可以原样搬到命令行。CLI 默认搜索团队内所有项目，加 --project 可限定单个项目；inspect 用于查看单条追踪，config 用于管理采样规则。对习惯脚本化排查的团队来说，这减少了在图形界面和终端之间重复构造查询的成本。
新项目默认全量采样，需留意退出方式
自 Next.js 16.5 起，在 Vercel 上创建且至少包含一个 Node.js 函数的新项目，首次构建成功后会获得一条对所有环境 100% 采样的规则，并在构建时注入 instrumentation，无需手动配置即可获得框架跨度。测试版则必须先添加采样规则才会收集数据。若不希望默认采集，需要在 Settings → Tracing 中移除所有采样规则。
保留期延长但仍按套餐分层
测试版追踪沿用运行时日志的保留期，正式版则单独延长：Hobby 从 1 小时提升到 3 天，Pro 从 1 天提升到 14 天，Enterprise 从 3 天提升到 14 天。这意味着免费套餐仍只适合短期排查，超过 3 天的历史追踪无法回看；需要更长回溯窗口的团队应结合自身套餐评估，而不是默认所有追踪都会长期留存。
Q&A
Vercel Tracing 现在是否所有套餐都能用？
是的，Vercel Tracing 已全面开放，所有套餐均可使用，且价格与测试版相同。
如何在 Vercel 仪表板中搜索和查看追踪数据？
在仪表板中，新的 Traces 页面集中展示所有追踪与跨度，支持在 Spans 列表和 Traces 列表间切换，使用 KQL 搜索和筛选，并可通过 Live 模式实时查看新追踪。
Vercel CLI 支持哪些追踪相关命令？
CLI 支持 vercel traces search 进行搜索（使用与仪表板相同的 KQL 语法），vercel traces inspect <request-id> 查看单个追踪，以及 vercel traces config 管理项目的采样规则。
新建的 Next.js 项目会自动启用追踪吗？
从 Next.js 16.5 开始，在 Vercel 上创建且包含至少一个 Node.js 函数的新项目，在首次构建成功后会自动启用追踪，并添加一条采样规则追踪所有环境中 100% 的请求。
如何关闭 Vercel 项目的自动追踪？
要退出自动追踪，可以在项目的 Settings → Tracing 中移除所有采样规则。
Vercel Tracing 的追踪数据保留多久？
Hobby 套餐保留 3 天，Pro 和 Enterprise 套餐保留 14 天。
