Linux cronolog

1. 关于本文

本文将以cronolog
1.6.2、apache 2.2.6为例，以CentOS
5为平台，讲述cronolog的安装和设置。

2. 关于cronolog

cronolog是一个简单的过滤程序，它从标准输入设备读入日志记录，并把这些记录写入到输出文件集，输出文件的名字由一个文件名模板和当前的日期时间组成。cronolog通常与web服务器一起使用，例如apache,用来安全地对日志文件按日期、月或其它特定的区间进行分割。

3. 安装cronolog

3.1 下载最新稳定发行版(GA)的cronolog

访问cronolog网站http://cronolog.org/download/index.html下载最新稳定发行版的cronolog源码包。本文使用的是1.6.2版本，在linux系统下用下面的命令下载：

wgethttp://cronolog.org/download/cronolog-1.6.2.tar.gz

3.2 解压缩下载的源码包

首先建立一个工作目录(
笔者建议的目录为/usr/local/src/cronolog ) ：

mkdir
-p /usr/local/src/cronolog

将下载的源码包移至工作目录：

mv
cronolog-1.6.2.tar.gz
/usr/local/src/cronolog

进入工作目录并用tar命令解压源码包：

cd /usr/local/src/cronolog

tar zxvf
cronolog-1.6.2.tar.gz

命令执行结束后，当前工作目录下将生成一个新的子目录cronolog-1.6.2，此目录下即为cronolog的源码文件。

3.3 配置Makefile文件

进入cronolog源码目录：

cd cronolog-1.6.2

执行下面的命令可查看可配置选项：

　 ./configure --help

本文使用的配置命令如下：

CC=gcc CFLAGS="-O3" ./configure --prefix=/usr/local/cronolog

配置选项说明：

CC：C编译器的名称（用于运行configure），本文示例为gcc

CFLAGS：C编译器的标志（用于运行configure），本文示例为-O3，指定优化级别为3

--prefix：指定安装目录，本文示例为/usr/local/cronolog

3.4 编译源代码

执行下面的命令编译源代码：

　 make

3.5 安装

　 执行下面的命令安装cronolog 到目标路径：

　 make install

3.6 目录结构

安装完毕后，将在先前指定的目标路径中生成下列目录：

　
./info
cronolog信息文件(.info)目录

./man cronolog帮助文件(man)目录

./sbin
cronolog二进制文件目录

4. cronolog的使用

cronolog通常以管道方式作为日志过滤程序在应用的配置文件中调用。

直接用法是：

/path/to/cronolog [OPTIONS] logfile-spec

其中：

OPTIONS：cronolog的选项，可通过下面示例中的-h 或
--help选项查看，此处不再介绍。

本文获取帮助信息示例：

/usr/local/cronolog/sbin/cronolog -h

或：

　/usr/local/cronolog/sbin/cronolog　--help

logfile-spec：
是描述输出的日志文件名的模板，每一个无前导%的字符都是文件名的组成部分，%后面跟一个字符为日期和时间格式串，将被下表列出的它们代表的实际字串所替换。

特殊格式串：

%%
%字符

%n 新行

%t
tab字符

时间格式串：

%H
24小时制小时(00..23)

%I
12小时制小时(01..12)

%p
本地AM/PM指示符

%M
分钟(00..59)

%S
秒(00..61)

%X
本地时间(e.g.: "15:12:47")

%Z 时区 (e.g.
GMT)，如果不能检测出时区，值为空

日期格式串：

%a
本地简短星期名(e.g.: Sun..Sat)

%A
本地完整星期名(e.g.: Sunday .. Saturday)

%b
本地简短月名(e.g.: Jan .. Dec)

%B
本地完整月名(e.g.: January .. December)

%c
本地日期与时间(e.g.: "Sun Dec 15 14:12:47 GMT 1996")

%d
一月中的第几日(01 .. 31)

%j 一年中的第几天
(001 .. 366)

%m 月名的数字表示
(01 .. 12)

%U
一年中以星期日为每周第一天计算的星期数(00..53, 第一周包括新年的第一个星期日)

%W
一年中以星期一为每周第一天计算的星期数(00..53, 第一周包括新年的第一个星期一)

%w 星期名的数字表示
(0 .. 6, 0为星期日)

%x 本地日期
(e.g. 今天在北京是: "15/12/96")

%y 不带世纪的年(00
.. 99)

%Y
带世纪的年(1970 .. 2038)

　

　下面是在apache中的用法：

　CustomLog "|/path/to/cronolog [OPTIONS] logfile-spec"
[format]

　OPTIONS、logfile-spec同上面的直接用法，format为apache配置指令CustomLog的日志格式参数。　

　下面是本文的示例：

修改apache配置文件，本文示例为/usr/local/apache-2.2.6/conf/httpd.conf：

vi
/usr/local/apache-2.2.6/conf/httpd.conf

按下面的提示进行修改：

　将CustomLog指令，本文示例为

CustomLog
logs/access_log common

　更改为：

　CustomLog "|/usr/local/cronolog/sbin/cronolog
/usr/local/apache-2.2.6/logs/access_log.%Y%m%d"
combined

指令解释：

　/usr/local/cronolog/sbin/cronolog 为cronolog二进制文件绝对路径

　/usr/local/apache-2.2.6/logs/access_log.%Y%m%d
为输出日志文件名模板，将按天生成类似下面文件名的日志文件/usr/local/apache-2.2.6/logs/access_log.20080301。

combined
为apache日志的格式名。

按你的实际情况修改完毕后重启apache即可。

5. 结束语

至此，cronolog基本安装配置完毕。希望本文能对初学者有所帮助。