서버 점검 기준

로깅 관측 신호 점검 기준

Nest Logger와 Winston 통합을 문제 재현, 성능 분석, 감사 추적이라는 세 신호로 나눠 봅니다.

Event

로그 보존 항목

요청 시작, 예외, 외부 API 호출, 권한 실패처럼 운영자가 재현할 단서를 우선 기록합니다.

Sink

어디로 보낼지

콘솔, 파일, 중앙 수집기로 나눠 환경별 transport를 고르고 민감 정보 마스킹을 적용합니다.

Search

탐색 방식

request id, user id, context 값을 함께 남겨 한 요청의 흐름을 여러 로그에서 이어 찾습니다.

level

debug, log, warn, error의 기준이 팀 안에서 같아야 알림 피로와 누락을 줄일 수 있습니다.

context

controller, service, job 이름을 context로 남기면 실패 위치를 코드 구조와 바로 연결할 수 있습니다.

trace

동일 요청의 로그가 하나의 식별자로 묶이는지 확인해야 분산된 장애를 추적할 수 있습니다.