@@ -137,18 +137,26 @@ logging.config: classpath:logback/logback-${spring.profiles.active}.xml
137137
138138* ` {faint} ` : 회색빛(faint) 으로 출력되며, 로그 가독성을 높이기 위한 장식적 용도이다. 중요도가 낮은 항목 (예: 시간, 구분자 등)에 자주 사용됩니다.
139139
140- * ` %d{HH:mm:ss.SSS} ` : 로그 발생 시간 (시:분:초.밀리초). 운영 환경에서는 날짜를 생략했습니다.
140+ * ` %d{HH:mm:ss.SSS} ` : 로그 발생 시간 (시:분:초.밀리초). 운영 환경에서는 날짜를 생략했습니다. (예: ` 23:55:10.123 ` )
141141
142- * ` ${level:-%5p} ` : 로그 레벨(DEBUG, INFO, WARN, ERROR 등) 을 왼쪽 정렬 기준으로 ** 최소 너비 5칸** 으로 출력합니다. 가장 긴 로그 레벨인 ERROR(5자)에 맞춰 가독성을 높이기 위해 보통 5자 폭으로 설정합니다.
142+ * ` ${level:-%5p} ` : 로그 레벨(DEBUG, INFO, WARN, ERROR 등) 을 왼쪽/오른쪽 정렬 기준으로 ** 최소 너비 5칸** 으로 출력합니다. (` %5p ` 는 기본적으로 오른쪽 정렬입니다.)
143+ 가장 긴 로그 레벨인 ERROR(5자)에 맞춰 가독성을 높이기 위해 보통 5자 폭으로 설정합니다.
144+ 예: ` INFO ` , ` DEBUG ` , ` ERROR `
143145
144146* ` %X{traceId}, %X{spanId} ` : MDC에 저장된 ` traceId ` 와 ` spanId ` 를 각각 32칸, 16칸 너비로 출력한다. 값이 없을 경우 빈 값으로 대체됩니다.
145147 주로 Spring Cloud Sleuth, Zipkin 등과 연동할 때 사용되며, 분산 트레이싱을 위한 정보로 활용된다.
146148
147- * ` %logger{39} ` : 로그를 발생시킨 클래스명을 최대 39자까지 출력합니다. 너무 긴 클래스명은 생략되고, 필요한 경우 패키지명 없이 ` logger{0} ` 과 같이도 설정할 수 있습니다.
149+ * ` %clr(%-40.40logger{39}){cyan} ` : 로거(Logger)의 이름(주로 클래스 경로)을 청록색(cyan)으로 출력합니다.
150+
151+ * ` %-40.40 ` : 정확히 40칸의 너비를 차지하도록 고정합니다. ` - ` 는 왼쪽 정렬을 의미하며, 이름이 짧으면 공백으로 채워 세로 줄을 맞춥니다.
152+
153+ * ` {39} ` : 로거 이름이 39자를 초과하면 패키지명을 축약합니다.
148154
149155* ` %m%n ` : 로그 메시지를 출력하고 줄 바꿈을 수행합니다.
150156
151- * ` %wEx ` : 예외가 있을 경우, 간략한 요약 정보만 1~ 2줄로 출력한다. 전체 stack trace는 출력하지 않아 운영 환경에서 로그를 깔끔하게 유지하는 데 유리합니다.
157+ * ` ${LOG_EXCEPTION_CONVERSION_WORD:-%wEx} ` : 예외(Exception)가 발생했을 때 전체 스택 트레이스를 출력하는 부분입니다. Spring Boot 기본 프로퍼티를 사용하며, 값이 없을 경우(` :- ` ) ` %wEx ` 를 사용합니다
158+
159+ * ` %wEx ` : 예외가 있을 경우, 예외의 원인(cause)을 포함한 전체 스택 트레이스를 상세하게 출력합니다.
152160
153161## 실행 및 로그 확인
154162
0 commit comments