Единственный logger — nestjs-pino. Application events используют StructuredLogger, стабильное имя события и разрешённые scalar fields. console.log и второй logger в production не используются.
info — значимый lifecycle/outcome; debug — подробности успешного RPC; warn — восстановимая проблема/retry; error — окончательный сбой. Не добавляй log на каждый вход/выход функции или дубликат HTTP completion.
RequestContextService и request middleware владеют correlation: серверный request ID возвращается как X-Request-ID, входящий client ID хранится отдельно. Передавай существующий context, не создавай собственный UUID в каждом service.
Wrapper ограничивает поля, Pino redacts request secrets. Не логируй passwords, tokens, cookie, Authorization, credentials, connection generation, raw body или upstream error. Secret в message/stack не становится безопасным из-за allowlist; правила Security обязательны для sensitive data.
Для ошибки используй public code и безопасный context операции/попыток; error mapping не отдаёт внутренние детали клиенту.

Причины — ADR 008, системное поведение — HTTP observability. Проверяй новые поля/redaction/correlation existing logging tests; не добавляй тест на каждую строку log. Existing ESLint не запрещает все вызовы console отдельным правилом: до настройки встроенного no-console это semantic review.

2.2 KiB Raw Blame History

Observability

2.2 KiB

Raw Blame History