rotatelogs - 滚动apache日志的管道日志程序
rotatelogs
是一个配合Apache管道日志功能使用的简单程序。举例:
CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
此配置会建立文件"/var/logs/logfile.nnnn",其中的nnnn是名义上的日志启动时的系统时间(此时间总是滚动时间的倍数,可以用于cron脚本的同步)。在滚动时间到达时(在此例中是24小时以后),会产生一个新的日志。
CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common
此配置会在日志文件大小增长到5兆字节时滚动该日志。
ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M"
此配置会在错误日志大小增长到5兆字节时滚动该日志,日志文件名后缀会按照如下格式创建:errorlog.YYYY-mm-dd-HH_MM_SS
。
语法
rotatelogs
[ -l ]
logfile
[ rotationtime [ offset ]] |
[ filesizeM ]
选项
-l
- 使用本地时间代替GMT时间作为时间基准。注意:在一个改变GMT偏移量(比如夏令时)的环境中使用
-l
会导致不可预料的结果。 logfile
- 它加上基准名就是日志文件名。如果logfile中包含"%",则它会被视为用于
strftime()
的格式字符串;否则它会被自动加上以秒为单位的".nnnnnnnnnn"后缀。这两种格式都表示新的日志开始使用的时间。 rotationtime
- 日志文件滚动的以秒为单位的间隔时间。
offset
- 相对于UTC的时差的分钟数。如果省略,则假定为"0"并使用UTC时间。比如,要指定UTC时差为"-5小时"的地区的当地时间,则此参数应为"
-300
"。 filesizeM
- 指定以
filesizeM
文件大小滚动,而不是按照时间或时差滚动。
可移植性
下列日志文件格式字符串可以为所有的strftime()
实现所支持,见各种扩展库对应的strftime()
的手册。
%A |
星期名全称(本地的) |
%a |
3个字符的星期名(本地的) |
%B |
月份名的全称(本地的) |
%b |
3个字符的月份名(本地的) |
%c |
日期和时间(本地的) |
%d |
2位数的一个月中的日期数 |
%H |
2位数的小时数(24小时制) |
%I |
2位数的小时数(12小时制) |
%j |
3位数的一年中的日期数 |
%M |
2位数的分钟数 |
%m |
2位数的月份数 |
%p |
am/pm12小时制的上下午(本地的) |
%S |
2位数的秒数 |
%U |
2位数的一年中的星期数(星期天为一周的第一天) |
%W |
2位数的一年中的星期数(星期一为一周的第一天) |
%w |
1位数的星期几(星期天为一周的第一天) |
%X |
时间(本地的) |
%x |
日期(本地的) |
%Y |
4位数的年份 |
%y |
2位数的年份 |
%Z |
时区名 |
%% |
符号"%"本身 |