Docker 로그가 호스트 부팅 드라이브를 가득 채우지 않게 하려면 어떻게 해야 하나요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

즉시 로그를 생성하는 프로세스를 중지하고 활성 로그 저장 위치를 확인한 다음, 로그 폭주를 일으키는 오류나 재시작 루프를 수정하고 크기가 제한된 로테이션을 적용하세요.

Docker 기반 NAS 또는 홈 서버에서는 미디어와 데이터베이스가 다른 풀에 있어도 부팅 드라이브가 가득 찰 수 있습니다. 컨테이너의 표준 출력 및 표준 오류, systemd 저널 데이터, 앱 자체 파일이 여전히 시스템 파일 시스템에 남아 있을 수 있기 때문입니다. 안전한 순서는 최근 증거를 충분히 보존하고, 통제되지 않는 증가를 멈춘 뒤, 공간을 차지하는 로그 계층을 파악하고, 기존 및 향후 서비스의 보존 정책을 설정한 다음, 근본 애플리케이션이 같은 양의 로그를 계속 생성하지 않는지 확인하는 것입니다.

실제로 증가하는 로그 저장소 찾기

부팅 파일 시스템의 여유 공간을 확인한 다음 Docker 데이터 루트, 컨테이너별 로그 파일, 시스템 저널, 호스트에서 마운트한 애플리케이션 로그 디렉터리의 크기를 비교하세요. 삭제하거나 잘라내기 전에 가장 큰 경로를 기록하세요.

한 Docker 디스크 공간 사례에서는 기본 로그 파일이 별도로 커졌기 때문에 일반적인 Docker 요약 정보로는 주된 원인을 찾을 수 없었습니다. 결정적인 증거는 로컬 Docker 저장 경로에 있는 계속 증가하는 컨테이너 로그였습니다.

실행 중인 각 컨테이너에 설정된 로그 드라이버와 로그 경로를 확인한 다음, 가장 큰 파일을 컨테이너 이름 및 최근 메시지와 대조하세요. 컨테이너 로그로 사용량이 설명되지 않으면 Docker 관련 디스크 문제의 원인이 모두 json-file이라고 단정하지 말고 journald와 앱 자체 폴더도 확인하세요.

긴급 정리 전에 문제가 되는 컨테이너 중지

부팅 드라이브의 여유 공간이 거의 없으면 가장 빠르게 로그를 늘리는 컨테이너를 일시 중지하거나 중지하세요. 공간을 확보하기 전에 로그의 제한된 마지막 부분, 재시작 횟수, 종료 상태, 이미지 버전, 환경, 마운트 정보, 반복되는 첫 번째 오류를 저장하세요.

관리자들은 크기 제한을 설정하지 않으면 컨테이너 JSON 로그가 남은 디스크 공간을 모두 차지할 수 있다는 사실을 흔히 발견합니다. 장기간 이어진 Stack Overflow 토론에서는 제한 없는 JSON 로그 증가를 이미지 및 볼륨 데이터와 별개의 용량 위험으로 지목합니다.

Docker가 활성 로그 파일을 계속 열어 둔 상태에서 무작정 삭제하지 말고, Docker 메타데이터 트리에서 임의의 디렉터리를 절대 제거하지 마세요. 로그를 기록하는 프로세스를 중지한 뒤 플랫폼에서 지원하는 순환 또는 잘라내기 절차만 사용하고, 영향을 받는 서비스를 다시 시작하기 전에 디스크 공간이 실제로 확보됐는지 확인하세요.

장시간 실행되는 각 서비스에 제한된 순환 정책 적용하기

Compose 서비스 또는 컨테이너 설정에서 로그 드라이버를 명시하고 순환 한도를 설정하세요. 일반적으로 사용하는 JSON 드라이버에서는 최대 파일 크기와 보관할 파일 수 제한이 핵심 설정입니다.

Docker 커뮤니티의 로그 순환 관련 게시물에서는 max-size 및 max-file 같은 옵션으로 컨테이너 하나가 보관하는 로컬 기록의 양을 제한할 수 있다고 설명합니다. 운영상 필요한 것은 무한히 커지는 파일 하나가 아니라 유한한 순환 정책입니다.

장애를 진단하는 데 필요한 시간과 호스트에서 부팅 디스크 공간을 얼마나 안전하게 확보할 수 있는지를 고려해 제한을 설정하세요. 실행 중인 컨테이너에 새 로깅 설정을 적용하려면 서비스를 다시 만든 다음, 실제 적용된 설정을 점검하고 통제된 소규모 테스트를 실행해 파일이 예상대로 순환되는지 확인하세요.

기존 컨테이너에도 적용된다고 가정하지 말고 새 컨테이너의 기본값 설정하기

새로 생성되는 컨테이너에 데몬 또는 플랫폼 수준의 기본값을 설정해 서비스 설정이 누락되더라도 로컬 로그가 무제한으로 쌓이지 않게 하세요. 진단 요구 사항이 다른 핵심 서비스에는 더 제한적인 설정을 별도로 적용할 수 있습니다.

Docker 로깅 기본값을 변경해도 기존 컨테이너의 호스트 설정이 모두 소급해서 바뀌지는 않습니다. 커뮤니티에서도 데몬 기본값과 컨테이너별 생성 설정을 구분하므로, 기존 서비스를 점검하고 의도적으로 다시 만들어야 합니다.

먼저 중요도가 낮은 서비스 하나에 변경 사항을 적용하세요. 로그 조회, 모니터링, 알림, 지원 작업 흐름이 계속 작동하는지 확인한 다음, 영구 볼륨은 제거하지 않고 나머지 서비스를 단계별로 나누어 제어된 방식으로 재생성하세요.

로그 폭증을 일으키는 이벤트 해결하기

로테이션은 피해를 제한하지만, 몇 초마다 재시작하거나 연결할 수 없는 데이터베이스에 계속 재시도하거나, 모든 상태 확인을 기록하거나, 공격 또는 요청 폭주를 받거나, 문제 해결 후에도 디버그 모드로 남아 있는 컨테이너 자체를 고쳐 주지는 않습니다.

한 Docker 사용자는 약 80GB에 달하는 JSON 로그 파일의 원인이 과도한 디버그 출력임을 추적해 밝혔습니다. 이는 즉각적인 안전장치로 로테이션을 적용하더라도 디버그 수준 출력이 부팅 드라이브를 가득 채울 수 있음을 보여 줍니다.

반복되는 메시지를 빈도와 최초 발생 시각에 따라 분류한 다음, 가장 먼저 발생한 근본 오류를 해결하세요. 연결, 마운트, 비밀값 또는 준비 상태 문제가 로그 폭증을 일으키는 경우, 다음 진단 단계로 ZimaSpace의 재시작 루프를 일으키는 종속 서비스 찾기 가이드를 확인하세요.

Docker, Journald, 앱 자체 로그를 각각 추적하기

컨테이너는 stdout을 Docker로 보내면서 바인드 마운트에 자체 파일을 기록할 수 있고, Docker 서비스 자체는 데몬 이벤트를 journald로 보낼 수도 있습니다. 각 로그 대상의 보존 정책을 담당하는 주체는 다르며, 각 대상은 같은 부팅 파일 시스템을 별도로 가득 채울 수 있습니다.

홈 서버 운영자들은 Docker 수준의 로그 로테이션으로 로그를 제한할 수 있을 것으로 예상했지만, 애플리케이션 로그 디렉터리가 계속 커졌다고 보고했습니다. TrueNAS 커뮤니티 사례는 제한을 조정하기 전에 로그 보존을 담당하는 계층이 어디인지 파악해야 한다는 점을 보여 줍니다.

부팅 디스크 사용량, 가장 큰 로그 파일, 저널 크기, 컨테이너 재시작 횟수, 일일 증가량의 수정 후 기준값을 기록하세요. 모든 활성 로그 대상에 제한 정책이 적용되고, 평소 작업 부하에서 문제가 있는 서비스가 안정적으로 유지되며, 의도적으로 재시작해도 파일이 무제한으로 다시 생성되지 않아야 복구가 완료된 것입니다.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.