Перейти к содержанию
ERITKOM
ВебНовость

Vercel подключила фоновые Daemons к общей трассировке проекта

Фоновые процессы могут отправлять OpenTelemetry-трассы через локальный Unix-сокет. Для Node.js предусмотрен автоматический экспорт, но ограничения беты и настройки внешнего получателя остаются существенными.

Архивная фотография серверных стоек NERSC 2011 года: тематическая иллюстрация фоновых вычислений, не инфраструктура Vercel
Derrick Coetzee, серверные стойки NERSC, 14 октября 2011 года, CC0 1.0. Архивная тематическая фотография, не дата-центр Vercel и не интерфейс Tracing. Изменены размер и формат JPEG→WebP.

Фоновый процесс становится виден рядом с приложением

Vercel 13 ноября добавила отправку трасс из Daemons в Vercel Tracing. Операции фонового обработчика теперь можно рассматривать рядом с остальными трассами проекта: например, искать медленную обработку задания или ошибку внутри рабочего процесса. Речь об интеграции телеметрии, а не об автоматическом исправлении кода или изменении порядка выполнения задач.

Для Node.js нужен пакет @vercel/otel версии 2.3.0 или новее. При стандартной конфигурации он обнаруживает предоставленный платформой Unix-сокет и отправляет записанные процессом spans — отдельные участки трассы. OpenTelemetry необходимо инициализировать до начала работы обработчика. В анонсе показан вызов registerOTel с именем сервиса. Это имя позволяет отличать фонового исполнителя при поиске; наличие общего хранилища не означает, что любое действие программы автоматически получило собственный диагностический участок.

Локальный приёмник имеет собственные ограничения

Документация уточняет транспорт: путь к сокету передаётся через VERCEL_OTEL_SOCKET_PATH. Приёмник принимает OTLP/HTTP с телом protobuf или JSON, но не OTLP/gRPC. Экспорт других языков возможен через совместимый SDK, умеющий обращаться к Unix-сокету; автоматический механизм @vercel/otel относится именно к Node.js.

Во время беты сериализованный span вместе с его долей атрибутов resource и scope ограничен 192 KiB, а сериализованных атрибутов resource и scope — 32 KiB. Слишком большие данные отбрасываются. Одновременно разрешены четыре экспорта на экземпляр; превышение возвращает HTTP 429 с Retry-After. Даже успешный HTTP 200 может сопровождаться частичным успехом и числом отклонённых spans.

Явно заданный OTLP endpoint или собственный traceExporter отключает выбор локального сокета. Поэтому существующая настройка внешнего получателя не начинает отправлять копию в Vercel только после обновления пакета. Поступившие в Vercel трассы учитываются в потреблении сервиса трассировки.

Поиск требует правильно выбранных проекта и команды

Просматривать результат можно через vercel traces search. Текущая документация CLI позволяет ограничить выборку проектом, именем сервиса, окружением и статусом. По умолчанию поиск охватывает последний час и возвращает до ста spans, начиная с новых; лимит можно увеличить до тысячи. Если не указать проект, команда ищет по проектам выбранной команды даже из каталога, связанного с одним приложением.

Режим --json выводит JSON Lines: записи spans и завершающую сводку. В ней находятся сведения о количестве результатов и продолжении выдачи. Для следующей страницы используется курсор --next, сохраняющий команду, проект, фильтры и временное окно исходного поиска. Это важно для автоматической обработки: первая сотня записей не обязательно представляет весь результат. Идентификатор проекта и имя сервиса также не следует считать взаимозаменяемыми полями. Формат JSON Lines и курсор --next требуют Vercel CLI версии 64.0.0 или новее.

Трассировка не меняет жизненный цикл Daemons

Сами Daemons остаются публичной бетой. Это непрерывно работающие процессы из контейнерных образов: потребители очередей, исполнители workflow или другие обработчики, которые самостоятельно получают очередную работу. Vercel поддерживает заданное число экземпляров и перезапускает завершившиеся процессы. Новая телеметрия помогает наблюдать этот механизм, но не превращает каждый обработчик в обычную HTTP-функцию.

Согласно действующему руководству, во время беты Daemons работают только в production; preview-развёртывания не поддерживаются. При замене развёртывания старые экземпляры корректно останавливаются, а приложению перед завершением посылается SIGTERM. Вывод stdout и stderr отдельно поступает в журналы проекта.

Доступ предусмотрен на всех планах в пределах их квот. Ожидающий задания процесс расходует меньше активного процессорного времени, однако выделенная память учитывается за всё время работы. Таким образом, малое число задач не означает нулевого потребления ресурсов постоянно запущенного экземпляра.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача