跨平台日志清理工具 Log-Cutter v1.0.3 正式发布

     Log-Cutter 是JessMA开源组织开发的一个简单实用的日志切割清理工具。对于服务器的日常维护来说，日志清理是非常重要的事情，如果残留日志过多则严重浪费磁盘空间同时影响服务的性能。如果用手工方式进行清理，会花费太多时间，并且很多时候难以满足实际要求。例如：如何在每个星期六凌晨3点把超过 2G 大的日志文件进行切割，保留最新的 100M 日志记录？ 网上没有发现能满足本座要求的日志切割工具，因此花了一些闲暇时间自己写了一个。由于要在多个平台上使用，为了方便采用 Java 实现。本工具命名为 Log-Cutter，主要有以下特点：

1. 支持 Linux、Mac 和 Windows 等所有常见操作系统平台
2. 支持命令行交互式运行
3. 支持后台非交互式运行（Linux/MAC 下使用 daemon 进程实现，Windows 用系统 Service 实现）
4. 支持两种日志清理方式（删除日志文件或切割日志文件）
5. 支持对 GB18030、UTF-8、UTF-16LE、UTF-16BE 等常用日志文件类型进行切割
6. 高度可配置（程序执行周期、要删除的日志文件过期时间、要切割的日志文件阀值和保留大小等均可配置

• JessMA 官方网站：http://www.jessma.org
• Log-Cutter 下载地址：http://code.google.com/p/ldcsaa/

• 使用方法：

**************************************************************
**** LogCutter - JessMA Open Source, all rights reserved. ****
**************************************************************

一、启动方式
--------------------------------------------------
1) Windows
    A) 前台运行: > ./run.bat [ -f config-file ]
    B) 后台运行: > LogCutter.exe    {    
                                                     -install-demand  (安装手动启动服务)
                                                      -install-auto    (安装自动启动服务)
                                                     -uninstall       (删除服务)
                                                     -start           (启动服务)
                                                     -stop            (停止服务)
                                                     -status          (查看服务状态)
                                                  }

    *** 注 *** 
        @ LogCutter.exe 以 Windows 系统服务的方式运行，安装好后也可以通过 Windows 服务管理器进行管理
        @ LogCutter.exe 是 32 位程序，LogCutter_x64.exe 是 64 位程序，根据需要使用其中之一
        @ LogCutter.exe 依赖 JRE 1.6, 因此必须在注册表或环境变量中设置 %JAVA_HOME%

2) Linux / Unix
    A) 前台运行: $ ./run.sh [ -f config-file ]
    B) 后台运行: $ ./run.sh [ -f config-file ] -d

    *** 注 ***
    @ 可以设置为开机时自动后台运行，方法如下:

        $ vi /etc/rc.d/rc.local  ( 加入: ${YOUR_LOGCUTTER_PATH}/run.sh -d )
            
--------------------------------------------------

二、配置文件
--------------------------------------------------
1) 程序配置文件: ./conf/config.xml (默认)
2) 日志配置文件: ./conf/log4j.properties (默认)
--------------------------------------------------

三、环境要求
--------------------------------------------------
1) Java 版 本: JRE 1.6 以上
2) 依赖程序包: dom4j、log4j、juniversalchardet
--------------------------------------------------

四、操作指南
--------------------------------------------------
参考：《操作指南》

• 配置文件

<?xml version="1.0" encoding="UTF-8"?>
<CONFIG>
    <global>
        <!-- 开始日志检查延时 (小时), 默认: 0 (立刻开始) -->
        <start-check-delay>1</start-check-delay>
        <!-- 日志检查间隔 (小时), 默认: 72 -->
        <check-interval></check-interval>
        <!-- Log4J 配置文件, 默认: ${CLASS_ROOT}/../conf/log4j.properties -->
        <log4j-config-file></log4j-config-file>
        <!-- 程序锁, 默认: ${CLASS_ROOT}/../${APP_NAME}.lock -->
        <lock-file></lock-file>
    </global>
    <!-- 要删除的日志文件列表 -->
    <!-- delete-files.expire: 日志文件过期时间(天), 默认: 90 -->
    <delete-files expire="30">
        <!-- files: 文件名称(不包含目录), 必须填写, 可包含通配符 -->
        <!-- files.path: 文件所在目录, 必须填写, 不能包含通配符 -->
        <file path="D:LogCutterlogs">LogCutter.log*</file>
        <file path="D:hMailServerLogs">*.log</file>
        <file path="D:Tomcat 6.0logs">*.log</file>
    </delete-files>
    <!-- 要截断的日志文件列表 -->
    <!-- cut-files.threshold: 日志文件截断阀值(KB), 默认: 10240 -->
    <!-- cut-files.reserve: 日志文件保留内容(KB), 默认: 1024 -->
    <!--
         <!注!> 'cut-files.reserve' 是保留内容的近似值得, 实际内容按行取整保留
            如下列日志文件内容:
                ...... ...... ......
                 line1: xxxxxxxxxxxxxxxxxxxxx
                 line2: xxxxxxxxxxPyyyyyyyyyy
                 line3: zzzzzzzzzzzzzzzzzzzzz
                 line4: zzzzzzzzzzzzzzzzzzzzz
                 ...... ...... ...... (EOF)
             'P'为定位得到的保留起点, 程序实际会在'P'点开始查找下一个换行符,
             从该换行符的后一个字符开始保留, 也就是从第三行开始保留到文件末尾
    -->
    <cut-files threshold="10240" reserve="512">
        <file path="D:Apache2.2logs">*.log</file>
        <file path="D:MySQLMySQL Server 5.1Datafilesdata">*.err</file>
    </cut-files>
</CONFIG>

---

Log-Cutter 1.0.3 更新：

  1) 程序包路径改为 org.jessma.logcutter.*
  2) 增加 Win64 服务程序 LogCutter_x64.exe
  3) 完善使用帮助文档
  4) 程序代码中加入 License 注释

---

CodeProject