[Feat] MDC 로깅 구현

.gitignore

@@ -38,3 +38,6 @@ out/
 
 ### Mac OS ###
 .DS_Store
+
+### log ###
+logs/

docker-compose.yml

@@ -12,4 +12,6 @@ services:
       - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
       - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
       - SERVICE_KEY=${SERVICE_KEY}
-      - TZ=Asia/Seoul
+      - TZ=Asia/Seoul
+    volumes:
+      - ${LOG_DIRECTORY}:/logs

src/main/java/com/kuit/findyou/global/config/SecurityConfig.java

@@ -1,6 +1,7 @@
 package com.kuit.findyou.global.config;
 
 import com.kuit.findyou.global.jwt.filter.JsonLoginFilter;
+import com.kuit.findyou.global.logging.MDCLoggingFilter;
 import com.kuit.findyou.global.security.JwtAuthenticationEntryPoint;
 import com.kuit.findyou.global.jwt.filter.JwtFilter;
 import com.kuit.findyou.global.jwt.util.JwtUtil;
@@ -25,6 +26,8 @@ public class SecurityConfig {
     private final AuthenticationConfiguration authenticationConfiguration;
     private final JwtAuthenticationEntryPoint entryPoint;
     private final JwtUtil jwtUtil;
+    private final MDCLoggingFilter mdcLoggingFilter;
+
     private static final String[] PERMIT_URL = {
             LOGIN_ENDPOINT.getValue(), "api/v1/auth/signup", "/swagger-ui/**", "/api-docs", "/swagger-ui-custom.html",
             "/v3/api-docs/**", "/api-docs/**", "/swagger-ui.html", "/swagger-ui/index.html"
@@ -64,6 +67,10 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception{
 //                        .requestMatchers(PERMIT_URL).permitAll()
 //                        .anyRequest().authenticated());
 
+        // MDC 필터 등록
+        http
+                .addFilterBefore(mdcLoggingFilter, UsernamePasswordAuthenticationFilter.class);
+
         // 토큰 검증 필터 추가
         http
                 .addFilterBefore(new JwtFilter(jwtUtil), UsernamePasswordAuthenticationFilter.class);

src/main/java/com/kuit/findyou/global/jwt/filter/JwtFilter.java

@@ -10,6 +10,7 @@
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.extern.slf4j.Slf4j;
+import org.slf4j.MDC;
 import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
 import org.springframework.security.core.Authentication;
 import org.springframework.security.core.context.SecurityContextHolder;
@@ -49,6 +50,12 @@ protected void doFilterInternal(HttpServletRequest request, HttpServletResponse
 
             // UserDetails 생성
             String username = jwtUtil.getUsername(token);
+
+            // jwt 인증 시 user_id 를 MDC에 삽입
+            Long userId = jwtUtil.getUserId(token);
+            MDC.put("user_id", String.valueOf(userId));
+
+
             User user = User.builder()
                     .email(username)
                     .password("password")
@@ -63,7 +70,10 @@ protected void doFilterInternal(HttpServletRequest request, HttpServletResponse
             log.info("token authentication failure");
             request.setAttribute("exception", e);
         }
-        filterChain.doFilter(request, response);
+        finally {
+            filterChain.doFilter(request, response);
+            MDC.clear();
+        }
     }
 
     private static String extractToken(HttpServletRequest request) {

src/main/java/com/kuit/findyou/global/logging/MDCLoggingFilter.java

@@ -0,0 +1,30 @@
+package com.kuit.findyou.global.logging;
+
+import jakarta.servlet.*;
+import jakarta.servlet.http.HttpServletRequest;
+import org.slf4j.MDC;
+import org.springframework.core.Ordered;
+import org.springframework.core.annotation.Order;
+import org.springframework.stereotype.Component;
+
+import java.io.IOException;
+import java.util.Objects;
+import java.util.UUID;
+
+
+@Component
+@Order(Ordered.HIGHEST_PRECEDENCE)
+public class MDCLoggingFilter implements Filter {
+
+    @Override
+    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
+        try {
+            String requestId = ((HttpServletRequest)servletRequest).getHeader("X-Request-ID");
+            MDC.put("request_id", Objects.toString(requestId, UUID.randomUUID().toString()));
+
+            filterChain.doFilter(servletRequest, servletResponse);
+        } finally {
+            MDC.clear(); // 메모리 누수 방지
+        }
+    }
+}

src/main/resources/application.yml

@@ -36,7 +36,6 @@ spring:
     redis:
       host: localhost
       port: 6379
-
 ---
 # 개발용 DB
 spring:
@@ -125,3 +124,4 @@ api:
 logging:
   level:
     org.springframework.cache: trace # Redis 사용에 대한 로그가 조회되도록 설정
+    root: info

src/main/resources/logback-spring.xml

@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <!-- 색상 변환기 등록(콘솔용) -->
+    <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
+    <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
+    <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
+
+    <property name="LOG_PATH" value="logs"/>
+
+    <!-- 콘솔 로그 패턴(컬러) -->
+    <property name="console.format"
+              value="[%clr(%d{yyyy-MM-dd HH:mm:ss}){green}:%clr(%-3relative){faint}] [%clr(%thread){magenta}] %highlight(%-5level) %clr(%logger{35}){cyan} - %clr(%msg){yellow}%n"/>
+
+    <!-- 파일 로그 패턴 (텍스트, key=value 형태) -->
+    <property name="file.format"
+              value="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%level] [%thread] [%logger] [request_id:%X{request_id}] [user_id:%X{user_id}] %msg%n"/>
+
+    <!-- 콘솔 로그 Appender(컬러) -->
+    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder>
+            <pattern>${console.format}</pattern>
+        </encoder>
+    </appender>
+
+    <!-- INFO 로그 파일 (텍스트) -->
+    <appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_PATH}/info.log</file>
+        <encoder>
+            <pattern>${file.format}</pattern>
+        </encoder>
+        <filter class="ch.qos.logback.classic.filter.LevelFilter">
+            <level>INFO</level>
+            <onMatch>ACCEPT</onMatch>
+            <onMismatch>DENY</onMismatch>
+        </filter>
+        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_PATH}/info.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
+            <maxFileSize>10MB</maxFileSize>
+            <maxHistory>30</maxHistory>
+        </rollingPolicy>
+    </appender>
+
+    <!-- WARN 로그 파일 (텍스트) -->
+    <appender name="WARN_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_PATH}/warn.log</file>
+        <encoder>
+            <pattern>${file.format}</pattern>
+        </encoder>
+        <filter class="ch.qos.logback.classic.filter.LevelFilter">
+            <level>WARN</level>
+            <onMatch>ACCEPT</onMatch>
+            <onMismatch>DENY</onMismatch>
+        </filter>
+        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_PATH}/warn.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
+            <maxFileSize>10MB</maxFileSize>
+            <maxHistory>30</maxHistory>
+        </rollingPolicy>
+    </appender>
+
+    <!-- ERROR 로그 파일 (텍스트) -->
+    <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>${LOG_PATH}/error.log</file>
+        <encoder>
+            <pattern>${file.format}</pattern>
+        </encoder>
+        <filter class="ch.qos.logback.classic.filter.LevelFilter">
+            <level>ERROR</level>
+            <onMatch>ACCEPT</onMatch>
+            <onMismatch>DENY</onMismatch>
+        </filter>
+        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
+            <fileNamePattern>${LOG_PATH}/error.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
+            <maxFileSize>10MB</maxFileSize>
+            <maxHistory>30</maxHistory>
+        </rollingPolicy>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="CONSOLE" />
+        <appender-ref ref="INFO_FILE" />
+        <appender-ref ref="WARN_FILE" />
+        <appender-ref ref="ERROR_FILE" />
+    </root>
+</configuration>