从 Vercel CLI 中搜索追踪 span

现在，你和你的编程智能体可以在终端里通过 vercel traces search 搜索项目的 trace span。

每个 span 代表请求中的一个步骤，不用打开仪表盘，就能排查错误、延迟和安全相关行为。

默认情况下，vercel traces search 会按新到旧的顺序返回最近一小时内的最多 100 个 span，无需先找到请求 ID 或 trace ID 即可搜索。你可以按环境、服务、span 名称、状态、deployment ID、request ID、trace ID 或 span ID 过滤结果，也可以用 --since 和 --until 缩小时间范围：

# error spans from the last hourvercel traces search --status error --since 1h
# every span in one tracevercel traces search --trace-id 4bf92f3577b34da6a3ce929d0e0e4736

查找最近的错误，或检查某个 trace 中的所有 span。

对于没有专用选项的过滤条件，可以使用 --queryKibana Query Language（KQL）子集，可用于 duration 等字段以及 span 和资源属性：

# spans slower than two secondsvercel traces search --query 'span.duration > 2000'

查找耗时超过两秒的 span。

加上 --json 可以让每个 span 输出一个 JSON 对象，为脚本和智能体提供结构化数据进行分析。

运行 vercel upgrade 更新到最新的 Vercel CLI，然后执行 vercel traces search --help 查看所有可用选项。详情请参阅 vercel traces 文档。