로그 레벨은 로그 메시지의 중요도를 나눈 등급이다.
설정한 레벨 이상의 로그만 출력되기 때문에, 환경에 따라 레벨만 바꿔서 출력되는 로그 양을 조절할 수 있다.
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를 켜두면 로그 양이 많아져 디스크와 성능에 부담이 되고 민감 정보가 남아 위험도가 커진다.