AI Briefing
KOSign in

Vercel CLI adds terminal search for trace spans

·2026.09.29 09:00

Key point

The new vercel traces search command returns up to 100 spans from the last hour by default, supporting filters via KQL and JSON output for automation.

Details

Developers and coding agents can now investigate errors, latency, and security behavior directly from the terminal using the new vercel traces search command. This feature eliminates the need to open the dashboard for basic trace analysis, allowing users to search a project’s trace spans without first locating a specific request or trace ID.

By default, the command returns up to 100 spans from the last hour, ordered newest first. Users can refine results using dedicated flags for environment, service, span name, status, deployment ID, request ID, trace ID, or span ID. Time ranges can be narrowed with the --since and --until options.

For more complex filtering, the --query flag supports a subset of Kibana Query Language (KQL), enabling searches on fields like duration, span attributes, and resource attributes. To facilitate scripting and agent-based analysis, the --json flag outputs one JSON object per span. Users must update to the latest Vercel CLI via vercel upgrade to access these features.

This summary was generated automatically by AI. Check the original for the author's claims and context. Copyright belongs to the original author.

Our guide explains how the AI works. Report summary errors, attribution issues, or removal requests via Contact.