Vercel CLI: запрашивайте метрики Speed Insights прямо из терминала

Vercel представил новую команду vercel metrics в своём CLI, которая позволяет разработчикам получать данные Speed Insights без необходимости открывать веб-интерфейс или использовать API. Это упрощает мониторинг производительности и интеграцию с автоматизированными процессами. Теперь можно анализиров

Что даёт команда vercel metrics

Команда vercel metrics предоставляет доступ к метрикам производительности, собранным на основе реального пользовательского трафика. С её помощью можно запрашивать такие показатели, как LCP (Largest Contentful Paint), INP (Interaction to Next Paint), CLS (Cumulative Layout Shift), а также FCP (First Contentful Paint) и TTFB (Time to First Byte). Все эти данные основаны на измерениях на стороне клиента, что отражает реальный опыт пользователей.

Как использовать команду для анализа регрессий

Разработчики могут фильтровать и группировать метрики по различным параметрам. Например, можно узнать, у каких страниц INP ухудшился за последнюю неделю, сравнить CLS на мобильных и десктопных устройствах или оценить воспринимаемую скорость главной страницы для пользователей из определённого региона, такого как Азия. Команда поддерживает множество опций, включая временные диапазоны, сегментацию по устройствам и географическим локациям. Полный список поддерживаемых метрик, измерений, фильтров и опций запросов доступен в официальной документации Vercel.

Почему это важно для разработчиков

Ранее для получения данных Speed Insights приходилось заходить в веб-интерфейс Vercel или обращаться к API. Интеграция в CLI упрощает автоматизацию: теперь можно встраивать проверки производительности в CI/CD пайплайны, запускать скрипты для регулярного мониторинга или давать AI-агентам прямой доступ к метрикам. Это ускоряет выявление регрессий и помогает быстрее оптимизировать сайты. Например, команда может быть частью pre-deploy хука, чтобы автоматически отклонять деплой, если метрики ухудшились.

Какие сценарии выигрывают от нововведения

Нововведение особенно полезно для разработчиков, которые активно занимаются производительностью веб-приложений. Оно также облегчает работу AI-агентам: теперь они могут напрямую запрашивать метрики для автоматического анализа и принятия решений. Кроме того, команда vercel metrics упрощает интеграцию с инструментами мониторинга и дашбордами, так как данные можно получать в структурированном виде без лишних шагов.

Кого затронет это обновление

В первую очередь новинка полезна разработчикам, использующим Vercel для хостинга своих проектов. Особенно тем, кто стремится поддерживать высокую производительность и следит за Core Web Vitals. Также это упрощает жизнь DevOps-инженерам, которые автоматизируют процессы развёртывания и мониторинга. AI-агенты, работающие с производительностью, теперь могут получать данные без необходимости парсить веб-интерфейс.

Что пока остаётся неизвестным

Пока не уточняется, будут ли добавлены аналогичные возможности в другие инструменты Vercel, например, в REST API или GraphQL API. Возможно, это временное решение, и в будущем функциональность расширят. Однако текущая реализация уже покрывает большинство сценариев, где нужен быстрый доступ к метрикам из командной строки.

Как начать использовать vercel metrics

Чтобы воспользоваться новой командой, необходимо установить последнюю версию Vercel CLI и авторизоваться. После этого можно выполнить vercel metrics --help, чтобы увидеть список доступных опций. Для получения конкретных метрик потребуется указать проект и, при необходимости, фильтры. Например, vercel metrics --project my-app --metric LCP --from 7d покажет LCP за последнюю неделю. Документация содержит подробные примеры и описание всех параметров.

Заключение

Команда vercel metrics — это шаг к более гибкому и автоматизированному мониторингу производительности. Она позволяет разработчикам быстрее реагировать на изменения и поддерживать высокое качество пользовательского опыта. Если вы используете Vercel, попробуйте эту команду в своём рабочем процессе — это сэкономит время и упростит анализ метрик.