Vercel Tracing is now generally available
TL;DR · AI 摘要
Vercel Tracing 现已全面上线,支持通过仪表板和 CLI 搜索追踪,新 Next.js 项目默认启用追踪。
核心要点
- Next.js 16.5+ 项目默认启用追踪,无需手动配置采样规则
- KQL 查询支持过滤慢数据库操作(span.duration > 500)
- Pro 计划用户追踪数据保留期从 1 天延长至 14 天
结构提纲
按章节快速跳转。
- §正式发布
Vercel Tracing 现已对所有计划开放,新增搜索和分析功能。
Traces 页面支持 KQL 查询和实时追踪流,可过滤慢数据库操作。
CLI 命令支持与仪表板相同的 KQL 查询语法,可跨项目搜索追踪。
Next.js 16.5+ 项目默认启用追踪,无需配置采样规则。
Hobby/Pro/Enterprise 计划的追踪数据保留期均得到延长。
思维导图
用一张图看清主题之间的关系。
查看大纲文本(无障碍 / 无 JS 友好)
- Vercel Tracing GA
- 核心功能
- KQL 查询
- 实时追踪流
- CLI 集成
- 跨项目搜索
- 采样规则管理
- Next.js 优化
- 自动启用追踪
- 框架级埋点
金句 / Highlights
值得收藏与分享的关键句。
A query like span.name:db* AND span.duration > 500 narrows to slow database spans by name and duration.
Vercel adds one sampling rule tracing 100% of requests in all environments...
Hobby now keeps traces for 3 days instead of 1 hour...
Vercel 追踪功能现已全面上线 - Vercel
Vercel 追踪功能现已在所有计划中全面上线。您现在可以通过仪表板或 Vercel CLI 搜索和检查追踪记录,新创建的 Next.js 项目默认启用追踪功能。价格与测试版保持一致。
复制链接到标题 在仪表板中浏览和搜索追踪记录
在测试版中,您只能从日志页面按请求打开单个追踪记录。新的追踪页面将项目或整个团队的所有追踪记录和跨度集中展示于一处。您可以在跨度列表和追踪列表之间切换,对两者进行过滤,并使用 Kibana 查询语言(KQL)进行搜索。实时模式会实时流式传输新到达的追踪记录。类似 span.name:db* AND span.duration > 500 的查询可根据名称和持续时间筛选出缓慢的数据库跨度。
$?
虚构项目的示例跨度和追踪记录。使用 KQL 进行搜索、过滤并打开追踪记录。
/$
复制链接到标题 从 CLI 搜索追踪记录
追踪页面使用与 vercel traces search --query 相同的 KQL,因此在仪表板中构建的查询可以直接在 CLI 中运行。搜索功能覆盖团队中的所有项目,或使用 --project 标志搜索单个项目。使用 vercel traces inspect <request-id> 检查单个追踪记录,并使用 vercel traces config 管理项目的采样规则。
terminal
1
vercel traces search
--query
'span.duration > 2000'
2
vercel traces search
--status
error
--since
1h查找持续时间超过两秒的跨度,然后搜索过去一小时内的所有错误。
复制链接到标题 新建 Next.js 项目的自动追踪功能
在测试版中,您需要添加采样规则后才会开始收集数据。从 Next.js 16.5 开始,在 Vercel 上创建的新项目(包含至少一个 Node.js 函数)在首次成功构建后会自动启用追踪功能。Vercel 会添加一条采样规则,追踪所有环境中的 100% 请求,并在构建时注入监控代码,因此追踪记录包含 Next.js 框架跨度,无需任何设置。如需退出,可在 设置 → 追踪 中删除所有采样规则。
复制链接到标题 更长的保留时间
在测试版中,追踪记录的保留时间与运行时日志一致。现 Hobby 计划将追踪记录保留 3 天(原为 1 小时),Pro 计划保留 14 天(原为 1 天),Enterprise 计划保留 14 天(原为 3 天)。
阅读追踪文档以了解更多信息。 /think