로그 레벨(Log Level) 이란?

로그 레벨은 로그 메시지의 중요도를 나눈 등급이다.

설정한 레벨 이상의 로그만 출력되기 때문에, 환경에 따라 레벨만 바꿔서 출력되는 로그 양을 조절할 수 있다.

레벨 순서(낮음 → 높음)

TRACE < DEBUG < INFO < WARN < ERROR(+ 라이브러리에 따라 FATAL)

예를 들어 레벨을 INFO로 설정하면 INFO, WARN, ERROR만 찍히고 TRACE와 DEBUG는 무시된다.

레벨 용도 예시
TRACE 가장 상세한 흐름 추적. 거의 안 씀 메서드 진입/종료, 루프 내부 값
DEBUG 개발 중 디버깅용 정보 파라미터 값, 쿼리 조건, 중간 계산 결과
INFO 정상 동작 중 의미 있는 이벤트 서버 기동, 배치 시작/종료, 주문 완료
WARN 당장 문제는 아니지만 주의가 필요한 상황 재시도 발생, deprecated API 호출, 설정값 누락으로 기본값 사용
ERROR 처리에 실패한 오류. 대응이 필요함 예외 발생, 외부 API 호출 실패, DB 연결 실패

<aside> 💡

TIP. 로그 레벨 판단이 애매할 때

판단이 애매할 때는 “운영 중에 이 로그를 보고 누군가 행동해야 하나?”라고 물어보면 된다. 행동이 필요하면 ERROR, 지켜봐야 하면 WARN, 기록만 남기면 INFO, 개발할 때만 필요하면 DEBUG다.

</aside>

환경별 권장 설정

: 내 패키지는 DEBUG, 나머지는 INFO

: INFO 또는 WARN, DEBUG를 켜두면 로그 양이 많아져 디스크와 성능에 부담이 되고 민감 정보가 남아 위험도가 커진다.