api: логирование через pino

Логгер на pino + nestjs-pino вместо стандартного ConsoleLogger: уровни
trace…fatal, details объектом, человекочитаемый вывод в dev и JSON в
проде,
автоматические HTTP-логи (reqId, url, statusCode, responseTime). Для
тестов —
LocalLoggerModule.forTesting() со своим TestingLogger и матчерами.

Документация по логированию — в docs/55-logging.
This commit is contained in:
arswarog committed 2026-10-27 10:44:15 +03:00
1 parent 157d79932a
commit bd6f349dc4
21 files changed
+1992 -11

No files matched your search

+36
View File
@@ -0,0 +1,36 @@
import pino, { Logger as PinoLogger } from 'pino';
import type { PrettyOptions } from 'pino-pretty';
/**
* В продакшене пишем машиночитаемый JSON, в остальных окружениях — человекочитаемый вывод.
* LOG_PRETTY явно перекрывает определение по NODE_ENV (нужно, когда образ собран под прод,
* а контейнер поднят локально).
*/
const isProduction = process.env.NODE_ENV === 'production' || process.env.LOG_PRETTY === 'false';
const baseLogger = pino({
level: process.env.LOG_LEVEL ?? (isProduction ? 'info' : 'debug'),
transport: isProduction
? undefined
: {
target: 'pino-pretty',
options: {
colorize: true,
translateTime: 'HH:MM:ss.l',
ignore: 'pid,hostname,context,reqId,res,url,statusCode,responseTime',
messageFormat: [
'\x1b[36m{reqId}\x1b[0m',
'\x1b[33m{context}\x1b[0m',
'\x1b[34m{msg}\x1b[0m',
].join(' '),
} as PrettyOptions,
},
});
/**
* Единственный экземпляр pino на процесс: и корневой логгер приложения, и pino-http
* пишут через него, поэтому транспорт (воркер pino-pretty) создаётся один раз.
*/
export function getBaseLogger(): PinoLogger {
return baseLogger;
}