DOCS/troubleshooting/250828_docker_log_persistence_RESOLVED.md
happybell80 ab4f296c43 docs: Docker 로그 영구 보존 문제 해결 완료
- 파일명 변경: docker_log_persistence_issue.md → docker_log_persistence_RESOLVED.md
- 제목에 [RESOLVED] 추가
- 해결 완료 상태 및 시간 기록 (2025-08-28 03:12)
- 적용된 서비스 목록 업데이트 (gateway, auth-server, redis)
- max-file: 10 설정으로 실제 적용 내용 반영

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-28 03:02:29 +09:00

1.5 KiB

[RESOLVED] Docker 컨테이너 로그 영구 보존 문제 해결

작성일: 2025-08-28

작성자: 서버 관리자

상태: 해결 완료 (2025-08-28 03:12)


문제 상황

  • 증상: 컨테이너 재시작 시 모든 로그 소실
  • 영향: Gateway, auth-server 등 주요 서비스 로그 추적 불가
  • 발견: 9시 브리핑 실패 원인 추적 중 로그 부재로 분석 불가

원인 분석

  1. 현재 설정: Docker 기본 json-file 드라이버 (옵션 없음)
  2. 로그 위치: /var/lib/docker/containers/{id}/ (컨테이너 삭제 시 소실)
  3. 볼륨 마운트: ./logs 사용하지만 실제 로그는 stdout으로만 출력

해결 방안

적용 완료: Docker 로그 드라이버 설정 (2025-08-28 03:12)

# docker-compose.yml에 추가 완료
services:
  gateway:
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "10"  # 10개 파일 로테이션으로 적용 (100MB)

### 장점
- 권한 문제 없음 (Docker 데몬이 root로 처리)
- 자동 로테이션
- 컨테이너 재시작/재생성 시에도 로그 보존

## 적용 완료
- ✅ robeing-gateway (2025-08-28 03:12 배포 완료)
- ✅ auth-server (2025-08-28 03:12 배포 완료)
- ✅ auth-redis (2025-08-28 03:12 배포 완료)

## 참고
- Docker 데몬은 root 권한으로 실행되어 로그 파일 관리
- `docker logs` 명령으로 과거 로그 조회 가능
- HDD 저장 원할 시 syslog 드라이버 고려