By default, vercel traces search returns up to 100 spans from the last hour, newest first, so you can start investigating without first locating a request or trace ID.
Dedicated flags filter by environment, service, span name, status, deployment, request, trace or span ID, and --since/--until narrow the window; for example, --status error --since 1h lists the last hour's error spans.
Fields without their own flag, such as duration or span and resource attributes, go through --query using Vercel's supported subset of KQL, e.g. 'span.duration > 2000' for spans slower than two seconds. The command needs the latest CLI via vercel upgrade.
Terms in this piece · Glossary
AI agent — An AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.
Why it matters
Your coding AI agentAn AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.Full definition → can now query production trace spans from the terminal with structured JSON output, so it can investigate errors and latency without the dashboard.
