[feat/#647] 로깅 인프라 구축

[Dimo-2562]

❤️ 기능 설명

운영/디버깅 때 요청 흐름을 더 쉽게 추적할 수 있도록 로깅 인프라를 정리했습니다.

이번 PR에서 추가한 핵심은 아래와 같습니다.

• MDC 기반 요청 추적 정보 추가

  • MDC는 로그 한 줄마다 같이 출력되는 작은 문맥 정보 저장소입니다.
  • HTTP 요청마다 requestId, method, uri, clientIp, 인증된 경우 memberId를 로그에 함께 남깁니다.
  • 같은 요청에서 발생한 여러 로그를 requestId로 묶어 볼 수 있습니다.

• 비동기 작업에서도 MDC가 유지되도록 처리

  • Spring @Async 같은 비동기 작업은 다른 스레드에서 실행되기 때문에 기본적으로 MDC가 끊길 수 있습니다.
  • TaskDecorator를 추가해서 요청 스레드의 MDC를 비동기 스레드로 복사하고, 작업 후 정리하도록 했습니다.

• Logback 파일 로그/롤링 설정 추가

  • 콘솔 로그 외에 파일 로그를 남기도록 logback-spring.xml을 구성했습니다.
  • 일반 애플리케이션 로그, 에러 로그, 웹소켓 로그를 파일로 분리했습니다.
  • 로그 파일은 날짜/크기 기준으로 rolling 되도록 했습니다.
    • application.log: 날짜 기준 1일 단위, 하루 안에서 100MB마다 분할, 최대 30일 보관, 전체 최대 3GB
    • websocket.log: 날짜 기준 1일 단위, 하루 안에서 50MB마다 분할, 최대 14일 보관, 전체 최대 1GB
    • error.log: 날짜 기준 1일 단위, 하루 안에서 50MB마다 분할, 최대 30일 보관, 전체 최대 1GB

• 로그 I/O 비동기화

  • 파일 쓰기 때문에 요청 처리 스레드가 오래 잡히지 않도록 Logback AsyncAppender를 적용했습니다.
  • 일반/웹소켓 파일 로그는 큐가 가득 찼을 때 요청 처리를 막지 않도록 설정했습니다.
  • 에러 로그는 유실 가능성을 낮추기 위해 별도 파일에 중복 저장합니다.

• 웹소켓 로그 분리

  • 웹소켓 관련 로그는 콘솔에 직접 찍지 않고 별도 파일로만 남기도록 분리했습니다.
  • 웹소켓 연결/메시지 처리 중에도 MDC가 잡히도록 보완했습니다.

• Docker 배포 환경 로그 보존

  • 컨테이너 재시작 후에도 로그 파일을 확인할 수 있도록 docker-compose.yml에 로그 volume을 추가했습니다.

연결된 issue

연결된 issue를 자동으로 닫기 위해 아래 {이슈넘버}를 입력해주세요.

close #647

🩷 Approve 하기 전 확인해주세요!

• JWT 필터에서 서버 에러를 인증 에러로 잘못 catch할 수 있는 이슈를 별도 try-catch로 묶어 해결했습니다.
• error.log를 별도로 분리해서 에러 로그가 일반 로그 파일과 에러 로그 파일에 함께 남는 방식이 괜찮은지 확인해주세요.
• 파일 롤링 기간을 기본/웹소켓/에러를 각각 30/14/30으로 설정했는데 의견주시면 감사하겠습니다.
• X-Forwarded-For 기반 clientIp 신뢰 정책은 추후 nginx/Cloudflare 설정과 함께 별도 개선 예정입니다.

✅ 체크리스트

• PR 제목 규칙 잘 지켰는가?
• 추가/수정사항을 설명하였는가?
• 테스트 결과 사진을 넣었는가?
• 이슈넘버를 적었는가?

[kanghana1]

파일 롤링기간 좋은 거 같고, 에러로그 분리도 좋은 거 같습니다. 고생하셨습니다!