Nginx日志轮转配置指南
· 阅读需 3 分钟
Nginx日志轮转配置指南
注：本文档基于nginx日志目录为 /etc/nginx/logs/ 的环境配置。 如果您的nginx日志在其他目录（如默认的/var/log/nginx/），请相应调整路径。
1. 检查系统环境
首先确认系统已安装logrotate：
# 检查是否安装logrotate
which logrotate
# 如果未安装，使用以下命令安装
# CentOS/RHEL系统
sudo yum install logrotate
# Ubuntu/Debian系统
sudo apt-get install logrotate
2. 创建Nginx日志轮转配置
创建nginx专用的logrotate配置文件：
sudo vim /etc/logrotate.d/nginx
配置文件内容：
/etc/nginx/logs/*.log {
daily
missingok
rotate 52
compress
delaycompress
notifempty
create 0640 nginx nginx
sharedscripts
postrotate
if [ -f /var/run/nginx.pid ]; then
kill -USR1 `cat /var/run/nginx.pid`
fi
endscript
}
3. 配置参数说明
- daily: 每天轮转一次
- missingok: 如果日志文件丢失，不报错
- rotate 52: 保留52个轮转文件（约1年）
- compress: 压缩旧的日志文件
- delaycompress: 延迟压缩，保留最近的一个文件不压缩
- notifempty: 如果日志文件为空，不进行轮转
- create 0640 nginx nginx: 创建新日志文件的权限和所有者
- sharedscripts: 所有日志文件轮转后只执行一次脚本
- postrotate: 轮转后执行的脚本，发送USR1信号给nginx重新打开日志文件
4. 测试配置
# 测试配置文件语法
sudo logrotate -d /etc/logrotate.d/nginx
# 强制执行轮转（用于测试）
sudo logrotate -f /etc/logrotate.d/nginx
5. 验证轮转效果
# 查看日志文件
ls -la /etc/nginx/logs/
# 查看轮转后的文件
ls -la /etc/nginx/logs/*.gz
6. 高级配置示例
按大小轮转
/etc/nginx/logs/*.log {
size 100M
missingok
rotate 10
compress
delaycompress
notifempty
create 0640 nginx nginx
sharedscripts
postrotate
if [ -f /var/run/nginx.pid ]; then
kill -USR1 `cat /var/run/nginx.pid`
fi
endscript
}
按小时轮转
/etc/nginx/logs/*.log {
hourly
missingok
rotate 168
compress
delaycompress
notifempty
create 0640 nginx nginx
sharedscripts
postrotate
if [ -f /var/run/nginx.pid ]; then
kill -USR1 `cat /var/run/nginx.pid`
fi
endscript
}
7. 排查问题
检查logrotate服务状态
# 检查logrotate服务状态
sudo systemctl status logrotate
# 查看logrotate日志
sudo journalctl -u logrotate
检查权限问题
# 确保nginx用户有正确的权限
sudo chown -R nginx:nginx /etc/nginx/logs/
sudo chmod 755 /etc/nginx/logs/
手动测试
# 手动执行logrotate
sudo /usr/sbin/logrotate -v /etc/logrotate.d/nginx
8. 监控脚本
创建一个监控脚本来检查日志轮转状态：
#!/bin/bash
# /usr/local/bin/check_log_rotation.sh
LOG_DIR="/etc/nginx/logs"
MAX_SIZE=100M
ALERT_EMAIL="admin@example.com"
# 检查日志文件大小
for log_file in $LOG_DIR/*.log; do
if [ -f "$log_file" ]; then
size=$(du -h "$log_file" | cut -f1)
if [[ $size > $MAX_SIZE ]]; then
echo "Warning: $log_file size is $size" | mail -s "Log Size Alert" $ALERT_EMAIL
fi
fi
done
# 检查是否有过期的日志文件
find $LOG_DIR -name "*.gz" -mtime +30 -exec rm {} \;
9. 性能优化建议
- 合理设置轮转频率：根据日志量调整轮转频率
- 使用压缩：节省磁盘空间
- 定期清理：删除过期的日志文件
- 监控磁盘空间：避免日志文件占满磁盘
10. 注意事项
- 确保nginx用户有足够权限访问日志目录
- 在生产环境测试前，先在测试环境验证配置
- 定期检查轮转是否正常工作
- 考虑使用日志管理工具如ELK Stack进行集中管理