Por que isso importa?

Você otimizou o site, mas como saber se ficou mais rápido para os usuários de verdade? As DevTools do navegador simulam apenas um dispositivo. O RUM (Real User Monitoring) do Vercel Speed Insights mostra a verdade — mas ficar alternando entre abas do dashboard quebra o fluxo.

Agora não precisa mais. O Vercel CLI expõe os dados do Speed Insights direto no terminal com o comando vercel metrics. Isso significa que seu agente de código ou pipeline de CI pode fazer perguntas como:

  • Quais páginas tiveram regressão no INP desde a semana passada?
  • Como está a velocidade percebida da minha home page na Ásia?
  • Compare o CLS do dashboard entre mobile e desktop.

Chega de mudar de contexto. Vamos botar a mão no código.

Developer using Vercel CLI to query Speed Insights for Core Web Vitals on a terminal Software Concept Art

Começando com vercel metrics

Primeiro, instale a versão mais recente do Vercel CLI:

npm i -g vercel@latest

Faça login se ainda não fez:

vercel login

Agora é só consultar. A sintaxe básica:

vercel metrics --metric LCP --dimension page --filter country=BR

Exemplo: Páginas com INP regredido

# Compara esta semana com a anterior para Interaction to Next Paint
vercel metrics \
  --metric INP \
  --dimension page \
  --filter period=7d \
  --compare period=7d_offset=7

Isso retorna uma tabela com as páginas onde o INP aumentou (regrediu). Dá pra jogar num jq ou script de CI para alertar o time.

Exemplo: Velocidade percebida no Brasil

vercel metrics \
  --metric LCP \
  --dimension country \
  --filter country=BR

Exemplo: CLS mobile vs desktop

vercel metrics \
  --metric CLS \
  --dimension device \
  --filter device=mobile,desktop

Para ver a lista completa de métricas (LCP, INP, CLS, FCP, TTFB) e dimensões (page, country, device, etc.), confira a documentação oficial do Vercel.

Dica de ouro: Use isso numa GitHub Action para reprovar um PR se qualquer métrica chave regredir além do limite.

Vercel CLI output showing LCP, INP, CLS metrics from real user traffic IT Technology Image

Limitações e cuidados

  • Disponibilidade: As métricas só aparecem se o Speed Insights estiver ativo e o projeto tiver tráfego suficiente. Páginas com pouca visita podem ficar sem dados.
  • Amostragem: Dados de usuários reais são amostrados; amostras pequenas podem ser ruidosas.
  • Versão do CLI: Requer Vercel CLI 34.0+. Rode vercel --version para conferir.
  • Filtros: Alguns filtros personalizados ainda não estão disponíveis no CLI — use as dimensões padrão por enquanto.

Próximos passos

  • Automatize verificações de regressão de performance no seu pipeline de CI/CD.
  • Combine com testes sintéticos (ex.: Lighthouse CI) para uma visão completa.
  • Explore a API REST do Vercel Insights para acesso programático além do CLI.

Dashboard comparing mobile and desktop CLS scores queried via Vercel CLI Developer Related Image

Conclusão

O comando vercel metrics transforma seu terminal numa ferramenta de observabilidade de performance. Nada de ficar pulando entre dashboards. Debugando regressão, comparando regiões ou montando gates de CI, esse comando mantém você no fluxo.

Se você também se preocupa em proteger seus agentes de IA, dê uma olhada no guia sobre defesa contra modelos de IA de fronteira com a arquitetura da Cloudflare. E para construir IAs confiáveis além de chatbots, leia sobre o Antigravity Framework do Google.

Vai lá — roda vercel metrics e descobre o que seus usuários reais estão sentindo.

Este conteúdo foi elaborado com o auxílio de ferramentas de IA, com base em fontes confiáveis, e revisado pela nossa equipe editorial antes da publicação. Não substitui o aconselhamento de um profissional especializado.