（转）Linux环境下使用logrotate工具实现nginx日志切割

原文：https://www.cnblogs.com/even160941/p/13903291.html

一. 前提背景及需求

Nginx运行日志默认保存在Nginx安装目录下的 /usr/local/nginx/logs目录（或/var/log/nginx目录下）, 包含access.log和error.log两个文件。

(1) access.log 记录了哪些用户、哪些页面以及用户浏览器、ip和其他的访问信息；

(2) error.log 则是记录服务器错误日志。

 

在所有时间内nginx产生的日志均保存在同一个文件下，随着访问量的增加，尤其是access.log增长极快，服务器会很快消耗磁盘空间，影响服务器效率。

另外，当需要对日志文件里面记录的数据进行分析时，每次都要耗时很久才能下载这个庞大的日志文件，浪费不必要的时间。

因此急需一个处理方案能够自动化的实现按天或者按文件大小来切割nginx日志记录。

 

二. 解决方案: 使用logrotate工具实现日志切割

1. logrotate工具的介绍

logrotate是一个linux系统日志的管理工具。可以对单个日志文件或者某个目录下的文件按时间/大小进行切割，压缩操作；指定日志保存数量；还可以在切割之后运行自定义命令。

logrotate是基于crontab运行的，所以这个时间点是由crontab控制的，具体可以查询crontab的配置文件/etc/anacrontab。系统会按照计划的频率运行logrotate，通常是每天。在大多数的Linux发行版本上，计划每天运行的脚本位于 /etc/cron.daily/logrotate。

主流Linux发行版上都默认安装有logrotate包，如果你的linux系统中找不到logrotate, 可以使用apt-get或yum命令来安装。

接下来,我们查看logrotate的配置文件

rpm -ql logrotate

由下图可知，logrotate的配置文件是 /etc/logrotate.conf， 这个文件用来定义全局默认参数。

其中， /etc/logrotate.d/ 是用于存储各种自定义应用的配置文件的目录。该目录里的所有文件都会被主动的读入到 /etc/logrotate.conf中执行。该目录下的应用配置文件继承所有/etc/logrotate.conf 的默认参数。

因此我们可以新建一个针对nginx日志文件的轮循配置的文件，然后将这个文件放在 /etc/logrotate.d/ 目录下, 它就会主动的读入到/etc/logrotate.conf中执行， 以达到按指定频率定时执行的需求。

 

2. 创建nginx日志分割文件 (路径: /etc/logrotate.d/nginx )

新建nginx文件, 存放在/etc/logrotate.d/目录下, 内容如下：

/var/log/nginx/*.log {
    create 0644 nginx root
    daily
    rotate 10
    missingok
    dateext
    notifempty
    compress
    delaycompress
    sharedscripts
    postrotate
    /usr/bin/kill -USR1 `cat /run/nginx.pid 2>/dev/null` 2>/dev/null || true
    endscript
}

参数含义解释：

/var/log/nginx/*.log：需要轮询的日志路径

daily：日志文件分割频度。可选值为 daily，monthly，weekly，yearly

rotate 10：一次将存储7个归档日志。对于第8个归档，时间最久的归档将被删除

missingok：在日志轮循期间，任何错误将被忽略，例如“文件无法找到”之类的错误

dateext：使用日期作为命名格式

compress：在轮循任务完成后，已轮循的归档将使用gzip进行压缩

nocompress：如果你不希望对日志文件进行压缩，设置这个参数即可

delaycompress：总是与compress选项一起用，delaycompress选项指示logrotate不要将最近的归档压缩，压缩将在下一次轮循周期进行。这在你或任何软件仍然需要读取最新归档时很有用

notifempty：如果日志文件为空，轮循不会进行

sharedscripts：表示postrotate脚本在压缩了日志之后只执行一次

create 0644 nginx root：以指定的权限创建全新的日志文件，同时logrotate也会重命名原始日志文件

postrotate或endscript：最通常的作用是让应用重启，以便切换到新的日志文件, 在所有其它指令完成后，postrotate和endscript里面指定的命令将被执行。在这种情况下，rsyslogd 进程将立即再次读取其配置并继续运行

 

主要参数含义解释：

monthly                   # 每月一次切割,取代默认的一周
minsize 1M              # 文件大小超过 1M 后才会切割
create 0664 root utmp            # 指定新建的日志文件权限以及所属用户和组
rotate 1                    # 只保留一个日志.
compress             # 通过gzip 压缩转储以后的日志
nocompress             # 不做gzip压缩处理
copytruncate           # 用于还在打开中的日志文件，把当前日志备份并截断；是先拷贝再清空的方式，拷贝和清空之间有一个时间差，可能会丢失部分日志数据。
nocopytruncate     # 备份日志文件不过不截断
create mode owner group        # 轮转时指定创建新文件的属性，如create 0777 nobody nobody
nocreate              # 不建立新的日志文件
delaycompress                  # 和compress一起使用时，转储的日志文件到下一次转储时才压缩
nodelaycompress         # 覆盖 delaycompress 选项，转储同时压缩。
missingok         # 如果日志丢失，不报错继续滚动下一个日志
errors address        # 转储时的错误信息发送到指定的Email地址
ifempty          # 即使日志文件为空文件也做轮转，这个是logrotate的缺省选项
notifempty       # 当日志文件为空时，不进行轮转
mail address             # 把转储的日志文件发送到指定的E-mail地址
nomail           # 转储时不发送日志文件
olddir directory        # 转储后的日志文件放入指定的目录，必须和当前日志文件在同一个文件系统
noolddir             # 转储后的日志文件和当前日志文件放在同一个目录下
sharedscripts             # 运行postrotate脚本，作用是在所有日志都轮转后统一执行一次脚本。如果没有配置这个，那么每个日志轮转后都会执行一次脚本 
prerotate              # 在logrotate转储之前需要执行的指令，例如修改文件的属性等动作；必须独立成行
postrotate                 # 在logrotate转储之后需要执行的指令，例如重新启动 (kill -HUP) 某个服务！必须独立成行
daily              # 指定转储周期为每天
weekly           # 指定转储周期为每周
monthly           # 指定转储周期为每月
rotate count              # 指定日志文件删除之前转储的次数，0指没有备份，5 指保留5个备份
dateext             # 使用当期日期作为命名格式
dateformat .%s            # 配合dateext使用，紧跟在下一行出现，定义文件切割后的文件名，必须配合dateext使用，只支持 %Y %m %d %s 这四个参数
size(或minsize) log-size       # 当日志文件到达指定的大小时才转储，log-size能指定bytes(缺省)及KB (sizek)或MB(sizem).当日志文件 >= log-size 的时候就转储。 以下为合法格式：（其他格式的单位大小写没有试过）
size = 5 或 size 5 （>= 5 个字节就转储）
size = 100k 或 size 100k
size = 100M 或 size 100M

 

 

3. 运行logrotate

logrotate命令格式：

logrotate --help
Usage: logrotate [OPTION...] <configfile>
-d, --debug Don't do anything, just test (implies -v)：debug模式，测试配置文件是否有错误。
-f, --force Force file rotation ：强制转储文件。
-m, --mail=command Command to send mail (instead of `/bin/mail') ： 压缩日志后，发送日志到指定邮箱。
-s, --state=statefile Path of file status 

-v, --verbose Display messages during rotation ：显示转储过程
-l, --log=STRING Log file
--version Display version informationHelp options:
-?, --help Show this help message
--usage Display brief usage message

 

使用指令: 

logrotate /etc/logrotate.d/nginx

测试日志切割 (如果文件的时间小于一天，不会执行切割日志 )

使用指令: 

logrotate -d /etc/logrotate.d/nginx

强制轮询切割日志 ( 为了便于我们直观的观察测试结果，建议大家手动试一下 )

使用指令: 

logrotate -vf /etc/logrotate.d/nginx

 查看各个log文件的具体执行情况，这里记录的是上一次的执行状态

使用指令：

cat /var/lib/logrotate/logrotate.status