로그 로테이션의 개념과 필요성
소프트웨어 시스템이 중단 없이 운영되는 과정에서 로그는 시스템 상태 모니터링, 오류 추적, 사용자 행위 분석을 위한 필수적인 데이터 자산입니다. 하지만 시간이 지남에 따라 로그 파일의 크기가 무한정 커지면 디스크 공간 부족, 로그 검색 성능 저하, 파일 시스템의 I/O 부하 증가와 같은 심각한 문제를 야기합니다.
로그 로테이션(Log Rotation)은 이러한 문제를 방지하기 위해 설정된 규칙에 따라 로그 파일을 주기적으로 분할, 압축, 삭제하는 자동화된 관리 메커니즘입니다. 이를 통해 시스템은 최신 로그 데이터를 유지하면서도 저장 자원을 효율적으로 관리할 수 있습니다.
주요 로그 로테이션 도구 분석
1. logrotate: 리눅스 표준 로그 관리 도구
logrotate는 대부분의 리눅스 배포판에 기본 포함된 강력한 도구입니다. 유연한 설정 파일을 통해 복잡한 로테이션 정책을 쉽게 구현할 수 있습니다.
# /etc/logrotate.d/service-api 설정 예시
/var/log/service-api/*.log {
weekly # 매주 단위로 로테이션 실행
missingok # 로그 파일이 없어도 에러를 발생시키지 않음
rotate 4 # 최대 4개까지 보관 (한 달 분량)
compress # 이전 로그 파일 압축 (gzip)
delaycompress # 다음 로테이션 주기까지 압축을 미룸 (현재 파일 가독성 확보)
notifempty # 로그 파일이 비어 있으면 로테이션 생략
copytruncate # 파일을 새로 생성하는 대신 기존 파일 내용을 비움 (실행 중인 프로세스 유지)
create 0640 app admin # 로테이션 후 새 파일 권한 및 소유자 설정
postrotate
/usr/bin/systemctl reload service-api > /dev/null 2>&1
endscript
}
2. cronolog: 시간 기반 실시간 분할 도구
cronolog는 파이프를 통해 들어오는 로그 스트림을 실시간으로 분석하여 시간별 또는 날짜별로 파일명을 변경하며 저장하는 방식에 특화되어 있습니다.
# Nginx 또는 커스텀 애플리케이션의 출력을 날짜별로 저장
/usr/local/bin/my-app | /usr/sbin/cronolog /var/log/app/access-%Y-%m-%d.log
위 설정은 로그를 access-2024-05-20.log와 같은 형식으로 매일 자동 생성합니다.
로그 통합 관리 구현 전략
중앙 집중식 설정 관리
관리를 단순화하기 위해 여러 애플리케이션의 로테이션 설정을 하나의 디렉토리(/etc/logrotate.d/)에서 관리하는 것이 좋습니다. 서비스별로 설정 파일을 분리하면 가독성과 유지보수성이 향상됩니다.
# 공통 로그 정책 예시 (common_policy)
/var/log/web/*.log
/var/log/db/*.log {
daily
rotate 7
sharedscripts
postrotate
/usr/bin/kill -HUP `cat /var/run/syslogd.pid 2> /dev/null` 2> /dev/null || true
endscript
}
자동 실행 및 스케줄링
logrotate는 일반적으로 시스템의 cron.daily에 의해 하루에 한 번 실행됩니다. 실행 시점이나 빈도를 변경하려면 /etc/crontab 또는 시스템 타이머 설정을 조정해야 합니다.
운영 중 발생하는 이슈 및 해결 방안
로그가 정상적으로 로테이션되지 않는 경우
- 권한 문제: 로그 파일이 위치한 디렉토리나 설정 파일의 권한이
root소유가 아니거나 쓰기 권한이 없는지 확인합니다. - 상태 파일 오류:
/var/lib/logrotate/status파일을 확인하여 마지막 실행 시간을 점검합니다. - 디버깅 모드 활용:
logrotate -d /etc/logrotate.d/config_file명령어를 통해 실제 실행 없이 시뮬레이션을 수행하여 설정 오류를 찾아냅니다.
압축 파일 손상 및 디스크 공간 부족
- 임시 공간 확보: 압축 과정에서 일시적으로 디스크 공간이 더 필요할 수 있습니다.
df -h명령어로 파티션 잔여량을 확인합니다. - 강제 실행: 수동으로 로그를 정리해야 할 때는
logrotate -f옵션을 사용하여 즉시 로테이션을 수행합니다.
요약 구조도
- 로그 관리 기초
- 정의: 주기적 로그 정리 및 보관
- 장점: 디스크 절약, 시스템 안정성, 관리 효율성
- 주요 도구
- logrotate: 설정 기반의 정교한 관리
- cronolog: 시간 패턴 기반 실시간 분할
- 운영 전략
- 중앙 집중 설정: 유지보수 편의성
- 자동화: cron을 활용한 정기적 실행
- 문제 해결
- 드라이 런(Dry run)을 통한 검증
- 권한 및 파일 시스템 상태 점검