<-
Apache > HTTP Server > 文档 > 版本2.2 > 支持程序
   致谢 | 本篇译者:金步国(作品集) | 本页最后更新:2006年10月20日

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

top

语法

rotatelogs [ -l ] logfile [ rotationtime [ offset ]] | [ filesizeM ]

top

选项

-l
使用本地时间代替GMT时间作为时间基准。注意:在一个改变GMT偏移量(比如夏令时)的环境中使用-l会导致不可预料的结果。
logfile
它加上基准名就是日志文件名。如果logfile中包含"%",则它会被视为用于strftime()的格式字符串;否则它会被自动加上以秒为单位的".nnnnnnnnnn"后缀。这两种格式都表示新的日志开始使用的时间。
rotationtime
日志文件滚动的以秒为单位的间隔时间。
offset
相对于UTC的时差的分钟数。如果省略,则假定为"0"并使用UTC时间。比如,要指定UTC时差为"-5小时"的地区的当地时间,则此参数应为"-300"。
filesizeM
指定以filesizeM文件大小滚动,而不是按照时间或时差滚动。
top

可移植性

下列日志文件格式字符串可以为所有的strftime()实现所支持,见各种扩展库对应的strftime()的手册。

%A星期名全称(本地的)
%a3个字符的星期名(本地的)
%B月份名的全称(本地的)
%b3个字符的月份名(本地的)
%c日期和时间(本地的)
%d2位数的一个月中的日期数
%H2位数的小时数(24小时制)
%I2位数的小时数(12小时制)
%j3位数的一年中的日期数
%M2位数的分钟数
%m2位数的月份数
%pam/pm12小时制的上下午(本地的)
%S2位数的秒数
%U2位数的一年中的星期数(星期天为一周的第一天)
%W2位数的一年中的星期数(星期一为一周的第一天)
%w1位数的星期几(星期天为一周的第一天)
%X时间(本地的)
%x日期(本地的)
%Y4位数的年份
%y2位数的年份
%Z时区名
%%符号"%"本身