structured log

로그 기준은 검색 가능한 필드로 남긴다

메시지만 남기면 읽기는 쉽지만 연결이 어렵습니다. 요청, 사용자, 시간, 오류 정보를 필드로 분리해야 모니터링과 알림이 작동합니다.

level

중요도

debug, info, warn, error를 구분해 개발 로그와 운영 알림을 다르게 처리합니다.

필터 기준
requestId

요청 추적

한 사용자의 API 호출, DB 쿼리, 외부 요청을 같은 식별자로 묶습니다.

흐름 연결
route

실행 위치

Route Handler, Server Component, Middleware 중 어디서 발생했는지 남깁니다.

책임 경계
duration

처리 시간

응답 지연이 DB, 외부 API, 서버 함수 중 어디에서 커지는지 비교합니다.

성능 알림
error

오류 요약

메시지, 코드, 스택을 분리해 같은 오류의 빈도와 영향을 집계합니다.

원인 분석
민감정보 기록 한계

토큰, 비밀번호, 원본 결제 정보처럼 민감한 값은 기록하지 말고 마스킹된 식별자만 남기는 편이 안전합니다.