{"slug": "search-trace-spans-from-the-vercel-cli", "title": "Search trace spans from the Vercel CLI", "summary": "Vercel released a `vercel traces search` command in its CLI that lets developers and coding agents search a project's trace spans from the terminal, returning up to 100 spans from the last hour, newest first, by default. The command filters results by environment, service, span name, status, deployment ID, request ID, trace ID, or span ID, supports `--since` and `--until` time ranges, accepts Kibana Query Language (KQL) via `--query` for fields such as duration, and outputs one JSON object per span with `--json` for scripts and agents. Users update via `vercel upgrade` and can view options with `vercel traces search --help`.", "body_md": "You and your coding agents can now search a project’s trace spans from the terminal with `vercel traces search`. \n\nEach span represents one step in a request, helping you investigate errors, latency, and security-related behavior without opening the dashboard.\n\nBy default, `vercel traces search` returns up to 100 spans from the last hour, newest first, so you can search without first finding a request or trace ID. Filter results by environment, service, span name, status, deployment ID, request ID, trace ID, or span ID, or narrow the time range with `--since` and `--until`:\n\nFor filters without a dedicated option, use `--query` with Vercel's supported subset of [Kibana Query Langugage (KQL)](https://www.elastic.co/docs/reference/query-languages/kql). It supports fields such as duration, along with span and resource attributes:\n\nAdd `--json` to output one JSON object per span, giving scripts and agents structured data to analyze.\n\nUpdate to the latest Vercel CLI with `vercel upgrade`, then run `vercel traces search --help` to see all available options. Learn more in the `vercel traces` [documentation](https://vercel.com/docs/cli/traces).", "url": "https://wpnews.pro/news/search-trace-spans-from-the-vercel-cli", "canonical_source": "https://vercel.com/changelog/search-trace-spans-from-the-vercel-cli", "published_at": "2026-09-29 13:00:00+00:00", "updated_at": "2026-09-29 17:50:09.529019+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents"], "entities": ["Vercel", "Vercel CLI", "vercel traces search", "Kibana Query Language"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/search-trace-spans-from-the-vercel-cli", "markdown": "https://wpnews.pro/news/search-trace-spans-from-the-vercel-cli.md", "text": "https://wpnews.pro/news/search-trace-spans-from-the-vercel-cli.txt", "jsonld": "https://wpnews.pro/news/search-trace-spans-from-the-vercel-cli.jsonld"}}