Linux cronolog

   本文将以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基本安装配置完毕。希望本文能对初学者有所帮助。