[Spring] 로깅 레벨(Logging Level)

로깅 레벨 종류 (낮음 -> 높음)

레벨	의미	사용 목적
TRACE	가장 상세	내부 흐름, 변수 값 추적
DEBUG	디버깅용	개발 중 문제 분석
INFO	일반 정보	정상 흐름 기록
WARN	경고	비정상 상황이지만 동작은 가능
ERROR	오류	예외 발생, 기능 실패

 

 

레벨별 정확한 사용 기준

 

TRACE

• 메서드 진입 / 종료
• 파라미터 값
• 반복문 내부 상태
• 운영에서는 거의 사용 안 함, 성능 저하 위험 있음

log.trace("회원 조회 시작 - memberId={}", memberId);

 

DEBUG

• 쿼리 실행 전 / 후
• 조건 분기 결과
• 내부 계산 결과
• 개발 서버까지만 활성화하는 게 일반적

log.debug("토큰 생성 완료 - userId={}", userId);

 

INFO

• 중요한 비즈니스 이벤트
• 로그인 성공
• 결제 완료
• 운영 환경 기본 레벨

log.info("회원 가입 성공 - email={}", email);

 

WARN

• 예상 가능한 예외
• 재시도 가능 오류
• 외부 API 지연

log.warn("이메일 인증 코드 불일치 - email={}", email);

 

ERROR

• 시스템 오류
• 예외 발생
• 트랜잭션 롤백
• 반드시 스택트레이스 포함

log.error("결제 처리 실패", e);

 

 

레벨 동작 원리

• 설정한 레벨 이상만 출력됨

logging:
  level:
    root: INFO

 

-> INFO, WARN, ERROR만 출력

-> DEBUG, TRACE는 무시

 

 

Spring Boot 설정 예시

• 전체 레벨 설정

logging:
  level:
    root: INFO

• 특정 패키지만 DEBUG

logging:
  level:
    com.draftory.domain.member: DEBUG

 

 

권장 설정

• 개발 환경

root: DEBUG

• 운영 환경

root: INFO