Введение в наблюдаемость в Nest

На боевом сервере NodeJS сбой часто виден только по короткой строке в журнале: непонятно, какой адрес шёл дольше остальных, где именно упало исключение и успели ли фоновые шаги до ошибки.

Наблюдаемость связывает запрос, вызовы классов приложения, задачи очереди и срабатывания планировщика в один след. Пакет @nestjs/observe встраивается в жизненный цикл Nest: имена в дашборде совпадают с классами и операциями, которые вы уже описали, а не только с сырыми HTTP маршрутами.

При создании проекта мастер может предложить Observe сразу; в базовом учебнике от него отказываются, чтобы не смешивать первый запуск с облачными ключами. Здесь подключим агент позже: установка, модуль, крючок при старте приложения, затем след входящего запроса, шаг внутри сервиса, ошибка в том же следе, задача BullMQ и минутный фоновый шаг.

Телеметрия уходит на сервис Observe по ключам из окружения; без них отчёты просто не примут. Дальше разберём подключение и типичные картины следа для HTTP, очереди и расписания.