🚀 [기능개선][chore] Spring Boot 로깅 레벨 전략 수립 및 Logback 파일 설정

[Chuseok22]

📝 현재 문제점

현재 Spring Boot 애플리케이션에서 log.debug() 중심의 로깅이 이뤄지고 있습니다. 특히 채팅 기능에서 매 이벤트마다 inbound, outbound, destination, message에 대해 debug 로그를 모두 출력하면서,

• 로그량 폭증 → 운영/분석 효율 저하, 스토리지 비용 증가
• 중요도 혼재 → 장애 원인 파악 시 유의미한 error/warn/info와 잡음(debug)이 섞여 탐색 시간이 늘어남
• 운영 가시성 부족 → 에러 로그의 분리 보관/신속 조회 체계 부재
• 표준 미흡 → 서비스 전반에서 로깅 수준/메시지/필드가 통일되지 않아 대규모 운영에 부적합

실서비스 환경임에도 구조화/집계/알림/보존/보안(PII 마스킹) 등 운영 단계의 로깅 고도화가 미흡하여 개선이 필요합니다.

🛠️ 해결 방안 / 제안 기능

1) 로깅 레벨 전략 재정의 (info/warn/error 중심, debug 최소화)

• 기본 원칙

  • info: 정상 플로우의 상태 전이(세션 연결/해제, 중요한 비즈니스 이벤트 완료)
  • warn: 복구 가능 이상 징후(재시도/폴백 발생, 성능 한계 임박)
  • error: 사용자 영향/데이터 손상 가능/치명 실패
  • debug: 개발·문제 재현 시에만 필요한 상세 진단(운영 기본값에선 비활성화)

2) 구조화(JSON) 로깅 + 상관관계(MDC) 도입

• JSON Layout으로 전환하여 로그 수집/검색/집계(ELK/OpenSearch/Loki 등) 최적화

3) Logback 프로파일별 설정 및 에러 전용 파일 분리/보존

• logback-spring.xml에서 dev/stage/prod 프로파일 별 레벨/appenders 분리

• 운영(prod):

  • 콘솔: INFO 이상
  • 애플리케이션 파일: INFO 이상(롤링, 보존기간 설정)
  • 에러 전용 파일: ERROR만 분리 저장(신속한 장애 서치 경로 확보)
  • AsyncAppender 사용으로 I/O 백프레셔 완화

예시 (logback-spring.xml, 요지)

4) 로그 수집/집계/알림 운영 가이드

• 수집: Filebeat/Fluent Bit → Elasticsearch/OpenSearch/Loki(운영 표준 중 택1)
• 인덱스 전략: 서비스/환경/도메인 분리(app-prod-chat-*)
• 보존: info 14~30일, error 90일(+압축), 감사로그 별도 장기보존
• 알림: ERROR 스파이크, 특정 예외 패턴, 채팅 실패율/지연 임계치 초과 시 Slack/이메일/PagerDuty

⚙️ 작업 내용

🙋‍♂️ 담당자

• 백엔드: @Chuseok22
• 프론트엔드: 이름
• 디자인: 이름

[github-actions]

Chuseok22 Issue Helper

브랜치명

20251204_#467_Spring_Boot_로깅_레벨_전략_수립_및_Logback_파일_설정

커밋 메시지

Spring_Boot_로깅_레벨_전략_수립_및_Logback_파일_설정 : feat : {변경 사항에 대한 설명} https://github.com/Team-TicketMate/ticketmate-server/issues/467