Vercel CLI ya busca trazas desde tu terminal

Qué trae el nuevo `vercel traces search`

Vercel acaba de sumar un nuevo subcomando a su CLI que cambia la forma de investigar problemas en producción. Con vercel traces search puedes buscar los spans de trazas de un proyecto directamente desde la terminal, sin abrir el dashboard.

Cada span representa un paso dentro de una petición HTTP, una llamada a una función serverless o una consulta a una API. Antes, revisarlos implicaba entrar al panel web, filtrar por trace ID o por deployment, y hacer clic hasta dar con el span problemático. Ahora es una sola línea de bash.

Por defecto, el comando devuelve hasta 100 spans de la última hora, ordenados del más reciente al más antiguo. Esto te permite buscar sin necesidad de conocer un trace ID de antemano: ideal para responder rápido a la pregunta de "¿algo se rompió recién?".

👥 ¿Quieres ir más allá de la noticia?

En nuestra comunidad discutimos las tendencias, compartimos oportunidades y nos ayudamos entre emprendedores. Sin humo, solo acción.

👥 Unirme a la comunidad

Los filtros disponibles cubren las variables que más se usan en una investigación real:

Estado (--status error, ok, etc.)
Entorno (production, preview, development)
Servicio, nombre del span, deployment ID
Request ID, trace ID o span ID específicos
Rango temporal con --since y --until (por ejemplo --since 1h)

Para filtros más finos, Vercel expone un subconjunto de Kibana Query Language (KQL) mediante --query. Un caso típico: encontrar spans lentos sin armar un dashboard nuevo.

vercel traces search --query 'span.duration > 2000'

Y para integrar con scripts o con agentes de IA, el flag --json emite un objeto JSON por span: datos estructurados listos para que un LLM los analice sin tener que parsear tablas humanas.

Por qué importa: el dashboard pierde terreno frente a la terminal

Esta movida no es aislada. El CEO de Coralogix, Ariel Assaraf, lo dijo en términos simples a TechCrunch en junio de 2026: "La capa de interfaz se está erosionando lentamente. Los ingenieros cada vez interactúan con el software a través de asistentes de IA y herramientas de línea de comandos en lugar de los dashboards tradicionales." Su empresa cerró una Serie F de US$200M con valoración de US$1.600M apostando exactamente a esa transición: monitorizar software a través de interfaces CLI y agentes.

Vercel sigue la misma tesis. El propio anuncio destaca que el comando está pensado para "tus coding agents y para ti": la salida JSON y los filtros KQL están diseñados para que un agente — Claude Code, Codex, Cursor o cualquier LLM con acceso al shell — pueda leer los spans, identificar el span con error y proponer un arreglo sin que un humano abra una pestaña en el navegador.

CRN documentó en 2026 el ecosistema que se está montando alrededor: Arize AX, Braintrust, LangSmith, Datadog Agent Observability, New Relic AI Coding Observability, Galileo (comprada por Cisco), Covasant CAMS y JetStream. La categoría entera — AI observability — está diseñada para responder dos preguntas nuevas que las herramientas tradicionales de APM no resuelven bien: ¿la IA alucinó? y ¿se está gastando el presupuesto de tokens demasiado rápido?

El nuevo subcomando de Vercel entra en esa conversación por la puerta del desarrollador: en lugar de montar una plataforma de observabilidad nueva, baja al shell la consulta que ya hacías en el dashboard.

Qué cambia cuando los agentes depuran trazas por ti

Tres efectos prácticos para un founder o un equipo de ingeniería pequeño:

1. Tu coding agent deja de ser "ciego" en producción. Hoy, cuando Claude Code o Codex generan código, lo prueban en local y se acabó. Si en producción hay latencia alta en una función edge, el agente no tiene cómo verlo. Con vercel traces search --json, el agente puede correr el comando, parsear los spans, identificar el cuello de botella y proponer un parche, todo dentro del mismo flujo de trabajo.

2. Investigar un incidente cuesta menos. El flujo tradicional "abrir dashboard → filtrar → copiar trace ID → buscar span" se reduce a una sola línea con un filtro que ya conoces. Para un equipo de 3-4 ingenieros sin un SRE dedicado, esa diferencia se nota entre atender un bug a las 23:00 y dejarlo para el lunes.

3. El comando se integra en CI/CD. Como la salida es JSON, puedes agregar un paso en tu pipeline que ejecute vercel traces search --status error --since 10m --json después de cada deploy y falle el build si encuentra errores nuevos.

Qué significa esto para tu startup

Si tu producto corre en Vercel, hay tres cosas concretas para hacer esta semana:

Actualiza el CLI con vercel upgrade y prueba vercel traces search --help para ver todos los filtros disponibles. Es reversible: si no convence, no rompe nada.
Explora --query con KQL: la consulta 'span.duration > 2000' es el atajo más útil para detectar regresiones de performance antes de que un cliente te escriba por redes sociales.
Prueba la salida --json con un agente: pídele a Claude Code o Codex que corra vercel traces search --status error --since 1h --json y te resuma los 3 errores más frecuentes. Es el caso de uso para el que Vercel diseñó el comando.

El movimiento de fondo es claro: la observabilidad se está mudando del navegador al terminal, y del terminal al agente. Los founders que entiendan esa transición van a depurar más rápido y gastar menos en plataformas pesadas que, para equipos chicos, suelen ser sobredimensionadas.