DOCS/journey/troubleshooting/250828_docker_log_persistence_RESOLVED.md
Claude-51124 22557e7132 docs: 오래된 트러블슈팅 아카이브 및 구조 정리
- 7-8월 초기 구축 문서 12개를 _archive/troubleshooting/2025_07-08_initial_setup/로 이동
- book/300_architecture/390_human_in_the_loop_intent_learning.md를 journey/research/intent_classification/로 이동 (개발 여정 문서)
- 빈 폴더 제거 (journey/assets/*)
2025-11-17 14:06:05 +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 드라이버 고려