re:re:actable
Урок 051 минута чтения

Что такое observability в Node.js?

На этой странице
Кратко

Observability - способность понять состояние приложения по внешним сигналам: логам, метрикам, traces, health checks и профилям. Для Node.js это особенно важно из-за долгоживущих процессов и асинхронных цепочек.

Вопрос

Что такое observability в Node.js и из чего она состоит?

Три базовых сигнала

СигналЧто показывает
Logsчто произошло
Metricsсколько и как быстро
Tracesпуть запроса между сервисами

Полезные метрики Node.js

  • latency запросов;
  • error rate;
  • throughput;
  • event loop delay;
  • memory usage;
  • CPU usage;
  • количество активных handles;
  • размер очередей;
  • pool saturation.

Health check

app.get('/health', (req, res) => {
  res.json({ ok: true });
});

Для readiness check иногда проверяют доступность БД, очереди или критичных зависимостей.

Request id

const requestId = req.headers['x-request-id'] || crypto.randomUUID();
 
console.log(JSON.stringify({
  level: 'info',
  requestId,
  message: 'request started',
}));

Request id помогает собрать все логи одного запроса.

Что важно помнить

  • Три опоры: логи, метрики и трейсы.
  • OpenTelemetry — стандарт сбора трейсов и метрик с автоинструментацией популярных библиотек.
  • Связывайте логи и трейсы общим traceId или requestId.
  • Ключевые метрики сервиса: задержка, ошибки, RPS, задержка event loop, память.

Мини-шпаргалка

  • Logs отвечают на вопрос "что случилось".
  • Metrics показывают тренды и деградацию.
  • Traces помогают видеть путь запроса.
  • Health check нужен для orchestrator и load balancer.
  • Следи за event loop delay, memory и latency.

Документация

OpenTelemetry: JavaScript, Node.js: Diagnostics.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам