로그 파일 관리의 중요성
웹서버인 Nginx 는 접근 정보를 기록하기 위해 기본적으로 access.log 파일을 생성합니다. 트래픽이 많은 사이트의 경우 이 파일은 단시간 내에 수십 GB 규모로 성장할 수 있으며, 이는 디스크 공간 부족 및 성능 저하를 유발합니다. 이를 해결하기 위해 Linux 시스템에 내장된 logrotate 유틸리티나 자체 스크립트를 활용하여 주기적인 로그 파기 및 압축을 수행해야 합니다.
시스템 로그 회전 도구(logrotate) 적용
logrotate 를 사용하여 로그 파일을 자동으로 분할하고 보관하는 설정은 /etc/logrotate.d/ 디렉토리에 저장됩니다. 아래 예시는 특정 경로에 위치한 로그파일을 대상으로 주간 단위 회전을 수행하는 구성입니다.
/var/www/nginx/logs/*.log {
weekly
rotate 14
minsize 50M
missingok
notifempty
compress
nodelaycompress
dateext
dateformat -%Y%m%d
create 640 nginx adm
sharedscripts
postrotate
# Nginx PID 파일 존재 시 재부팅 신호 전송
[ -f /run/nginx.pid ] && kill -USR1 `cat /run/nginx.pid`
endscript
}
주요 옵션 설명:
weekly: 일주일마다 로그를 새 파일로 분리합니다.minsize 50M: 일정 주기가 되었더라도 파일 크기가 이 임계값 미만이면 동작하지 않습니다.rotate 14: 이전 백업 로그를 총 14 개까지 유지합니다.compress: 분리된 구형 로그를 gzip 형식으로 압축하여 저장 공간을 절약합니다.postrotate: 로그가 전환된 직후 실행되는 명령어로, 여기서 Nginx 프로세스에 USR1 신호를 보내 기존 핸들러를 닫고 새로운 로그 파일을 열도록 유도합니다.
스케줄러(Crontab) 연동
리눅스 배포판의 기본 logrotate 실행 주기가 기대와 다를 수 있으므로, 사용자는 직접 스케줄을 제어해야 할 필요가 있습니다. 기존의 일별 실행 규칙을 비활성화하고 Crontab 에 명시적으로 추가하는 것이 안전합니다.
# 기존 자동 스크립트 제거
rm -rf /etc/cron.daily/logrotate
# 사용자 정의 규칙 등록 (매일 자정에 실행)
crontab -e
# 내용 추가: 0 0 * * * /usr/sbin/logrotate /etc/logrotate.d/nginx
Bash 스크립트를 이용한 독립적 관리
때로는 복잡한 설정 없이 순수한 셸 스크립트로 로그 관리 로직을 구현하기도 합니다. 아래 코드는 지정된 디렉토리 내의 모든 로그 파일을 날짜별로 리네임 후 압축하고, 일정 기간 이상 지난 파일은 삭제하는 작업을 수행합니다.
#!/bin/bash
# Description: Nginx 로그 순환 처리 스크립트
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
TARGET_DIR="/opt/services/webserver/logs"
KEEP_DAYS=20
DATE_TAG="$(date +%Y%m%d%H%M%S)"
# 디렉터리 검증
if [[ ! -d "$TARGET_DIR" ]]; then
echo "Error: Target directory does not exist." >&2
exit 1
fi
cd "$TARGET_DIR" || exit 1
# 1. 로그 이동 및 압축
for file in *.log; do
# 로그 파일이 아닌 경우 건너뜀
[[ -e "$file" ]] || continue
NEW_NAME="${file}_${DATE_TAG}"
# 현재 로그 내용을 새 이름으로 이동
mv "$file" "$NEW_NAME"
# 빈 새 로그 파일 재생성
touch "$file"
# 이동된 파일 압축
gzip "$NEW_NAME"
done
# 2. 만료된 백업 로그 삭제
echo "Cleaning up logs older than $KEEP_DAYS days..."
find . -maxdepth 1 -name "*.gz" -type f -mtime +$KEEP_DAYS -delete
이 방식은 외부 도구 의존성을 줄이고 구체적인 타이밍이나 조건에 맞춰 유연하게 수정이 가능하다는 장점이 있습니다.