一.概要说明
logrotate工具是为了方便进行日志管理而产生的一个工具,主要可以完成的工作包含:基于天、周、月、文件大小进行日志的滚动备份、压缩、删除甚至是发送邮件。
二.调用方式
logrotate默认情况下是通过anacron调用的,它每天只会被调用一次,也就是说一个日志文件默认不会多次被处理(
除非-f强制调用或者文件大小超过指定值)。大致调用流程如下:
1).anacron每天去调用/etc/cron.daily中的任务(包含logrotate);
2).anacron调用logrotate后进行日志的处理工作;
3).如果logrotate被手工调用,或者配置文件中有引用,后面的配置记录会覆盖前面相同选项的内容;
logrotate语法如下:
logrotate [-dv] [-f|--force] [-s|--state file] config_file+
什么都不跟则显示版本信息和简单的帮助信息,如果处理过程中出现异常则返回非0的$?;
--?,--help: 显示帮助信息;
-v, --verbose:显示详细信息;
-d, --debug:开启调试模式并隐含开启-v,不会对日志和logrotate的state文件产生操作;
-f, --force:忽略调用周期强制调用logrotate,方便测试;
-m, --mail :告知logrotate发送邮件的命令;
-s, --state :多个logrotate运行时告知logrotate自己使用的state文件(/var/lib/logrotate.status)
config_file+:表示可以使用多个配置文件(默认为/etc/logrotate.conf)在后面,最好是在一个配置文件中进行引用(测试某条新的规则时可以单独创建一个配置文件并用-f参数进行强行调用);
三.配置文件
配置文件对于logrotate来说至关重要,logrotate通过配置文件去找到需要操作的各个日志文件以及怎么操作这些日志文件。配置文件中可以定义全局options和局部options,且后面的options会覆盖前面的options,先来一个范例配置文件:
# sample logrotate configuration file --
注释
compress --
压缩option,默认所有的日志都压缩;
/var/log/messages { --
操作/var/log/messages日志文件,指定文件全名
rotate 5
--最多保留历史存档5份;
weekly
--rotate周期,周
postrotate
-->rotate结束后直行以下endscript前面的操作
/sbin/killall -HUP syslogd
--执行命令
endscript
}
"/var/log/httpd/access.log" /var/log/httpd/error.log {
--操作两个文件,引号可以用于规避空格等特殊符号
rotate 5
size 100k
--rotate规则为超过100K
sharedscripts
--所有日志处理完才执行后面的脚本而不是处理一个文件执行一次
postrotate
/sbin/killall -HUP httpd
endscript
}
/var/log/news/* { --指定某个文件夹下的所有文件(
包含已经rotate过的),只要有一个处理报错就不会对日志进行压缩
monthly
rotate 2
olddir /var/log/news/old --有利于减少重复rotate
missingok --忽略不存在的日志
postrotate
kill -HUP ‘cat /var/run/inn.pid‘
endscript
nocompress
}
以下是可用option的详细说明(前面打*号的通常应该都不会用到):
常规参数:
include file_directory:引用对应的配置文件或者对应目录下的常规文件(最好指定明确的文件,除非该路径下全部都是logrotate的配置文件),文件读取顺序为alphabetic.注意:
不能在某个日志的处理定义里面指定include.
mail address:发送邮件的收件人,如果不想发送邮件可以用nomail的参数;
nomail:不发送邮件;
maillast/mailfirst:mailfirst表示发送已经rotate的文件,需要与mail参数配合;maillast(默认值)发送下次会rotate的日志;
压缩相关参数:
compress/nocompress: compress表示被归档的日志文件默认会通过gzip进行压缩,nocompress表示不压缩(默认);
nodelaycompress/delaycompress:需要结合compress使用,delaycompress下次rotate才compress本次rotate的日志(方便查历史),no开头覆盖此参数;
*extension ext:指定后缀名
*compresscmd:指定压缩的命令,默认是gzip;
*uncompresscmd:指定解压缩的命令,默认是gunzip;
*compressext:指定压缩过后的日志文件的后缀名;
*compressoptions:指定压缩程序的参数,默认为gzip指定的参数是"-9"(最大压缩);
备份频率相关:
rotate count:归档的最大次数(超过该次数会被覆盖),如果设置为0则表示不归档;
daily:上次归档不是今天时备份一次;
weekly:Log files are rotated if the current weekday is less than the weekday of the last rotation or if more than a week has passed since the last rotation;
yearly:如果当天的年份与上次rotate的年份不一样;
monthly:每个月第一次运行logrotate的时候归档;
minsize size:可以与时间周期的归档结合起来,如果达到天数的归档周期还没有到最小大小也不会归档;
size size:达到指定size的日志会被rotate(单位可以是K/M等);
start count:如果用数字排号则表示直接从count开始排而不是0;
*maxage count:删除已经超过count天的归档,如果需要rotate这个归档则只是检查;
特别处理方式:
ifempty/notifempty:ifempty是默认值表示空文件也会被rotate,可以通过notifempty修改为空文件不归档;
missingok/nomissingok:missingok表示就算日志不存在也不会报错,
olddir/noolddir:olddir表示将归档的日志放到对应的目录(必须在同一个物理设备)下,绝对路径为明确的路径,如果指定相对路径则是日志文件的相对路径,noolddir覆盖olddir参数
sharedscripts/nosharedscripts:主要针对处理多个日志或指定目录的情况下,sharedscripts表示处理子集中所有的日志都处理完成后才执行,如果没有日志被处理则不会执行。nosharedscripts则表示每个日志处理后都执行scripts部分;
备份方式相关:
dateext/nodateext:在备份的日志后面加上备份当天的日期(YYYYMMDD)而不是简单的加一个数字(nodateext覆盖此归档方式);
copy/nocopy:copy指定备份日志的方式为复制(源文件可用作其他目的),因原文件不会被删除,所以指定create会直接被忽略;nocopy表示不复制
copytruncate/nocopytruncate:复制一个副本后直接truncate原日志,这对于不能用move掉旧的再创建一个新文件的日志(copy与truncate中间可能会丢失一部分日志,实测每秒一笔日志不会丢失),no开头表示copy后不truncate;
nocreate/create mode owner group:日志滚动(默认是move)后立即创建一个新的日志文件(mode指定权限,owner和group分别指定属主属组),然后才会执行portrotate,如果被忽略的一些属性将会和原日志文件一致,nocreate会覆盖此参数;
postrotate/endscript:rotate完成后通过/bin/sh去执行这两个标记中间(必须换行)的命令,处理的日志文件会作为第一个参数传递给每个命令,如果指定sharedscripts则所有的日志都会传递给脚本;
prerotate/endscript:rotate日志前(确实有日志需要rotate)执行,其他同postrotate;
firstaction/endscript:处理多个日志前执行
lastaction/endscript:处理多个日志全部后执行