server logs

서버 로그 설계 기준

운영 환경에서는 단순 메시지보다 요청 ID, 사용자 영향, 외부 의존성 상태가 더 중요합니다.

trace

요청 ID

middleware나 route handler에서 같은 요청을 묶는 추적 키를 남깁니다.

context

실패 맥락

입력 크기, 외부 API 이름, DB 쿼리 범위처럼 재현 단서를 기록합니다.

privacy

민감 정보

토큰, 비밀번호, 개인 식별 정보는 저장 전에 마스킹합니다.

alert

로그 알림 임계값

단일 오류보다 비율, 지속 시간, 사용자 영향 기준으로 알림을 보냅니다.