Урок 042 минуты чтения
Как использовать perf_hooks, eventLoopUtilization и performance marks?
На этой странице
Кратко
node:perf_hooks помогает измерять производительность Node.js: duration операций, event loop utilization, resource timing и custom performance marks. Это полезно для диагностики latency, CPU pressure и деградаций.
Вопрос
Как использовать perf_hooks, eventLoopUtilization и performance marks?
Зачем нужны performance marks?
Date.now() подходит для грубых измерений, но performance API лучше для точных runtime measurements.
import { performance } from 'node:perf_hooks';
performance.mark('db-start');
await loadUsers();
performance.mark('db-end');
performance.measure('db-query', 'db-start', 'db-end');
const [measure] = performance.getEntriesByName('db-query');
console.log(measure.duration);Как измерять функцию?
import { performance } from 'node:perf_hooks';
async function measure(name, fn) {
const start = performance.now();
try {
return await fn();
} finally {
const durationMs = performance.now() - start;
console.log({ name, durationMs });
}
}Что такое event loop utilization?
Event loop utilization показывает, насколько event loop был занят между измерениями.
import { performance } from 'node:perf_hooks';
let previous = performance.eventLoopUtilization();
setInterval(() => {
const current = performance.eventLoopUtilization(previous);
previous = performance.eventLoopUtilization();
console.log({
utilization: current.utilization,
});
}, 1000);Если utilization стабильно высок и latency растет, вероятно, процесс перегружен CPU-bound работой или тяжелыми sync операциями.
Что еще смотреть?
- request latency;
- event loop delay;
- CPU usage;
- heap usage;
- active handles;
- DB pool wait time;
- queue lag;
- GC pauses.
Когда использовать?
- profiling endpoint;
- custom metrics;
- debug slow route;
- production observability;
- load testing.
Что важно помнить
performance.mark()иperformance.measure()измеряют длительность участков кода.performance.eventLoopUtilization()показывает долю времени, когда event loop был занят.monitorEventLoopDelay()дает гистограмму задержек event loop.- Высокая загрузка event loop — сигнал к профилированию и выносу CPU-работы.
Мини-шпаргалка
performance.now()- точное время.performance.mark()- точка измерения.performance.measure()- duration между marks.performance.eventLoopUtilization()- занятость event loop.- Метрики нужно отправлять в monitoring, а не только логировать.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.