~怪^_*獸~

跨平臺日志清理工具 Log-Cutter v1.0.3 正式發(fā)布

    Log-Cutter 是JessMA開源組織開發(fā)的一個簡單實用的日志切割清理工具。對于服務器的日常維護來說，日志清理是非常重要的事情，如果殘留日志過多則嚴重浪費磁盤空間同時影響服務的性能。如果用手工方式進行清理，會花費太多時間，并且很多時候難以滿足實際要求。例如：如何在每個星期六凌晨3點把超過 2G 大的日志文件進行切割，保留最新的 100M 日志記錄？ 網上沒有發(fā)現(xiàn)能滿足本座要求的日志切割工具，因此花了一些閑暇時間自己寫了一個。由于要在多個平臺上使用，為了方便采用 Java 實現(xiàn)。本工具命名為 Log-Cutter，主要有以下特點：

1. 支持 Linux、Mac 和 Windows 等所有常見操作系統(tǒng)平臺
2. 支持命令行交互式運行
3. 支持后臺非交互式運行（Linux/MAC 下使用 daemon 進程實現(xiàn)，Windows 用系統(tǒng) Service 實現(xiàn)）
4. 支持兩種日志清理方式（刪除日志文件或切割日志文件）
5. 支持對 GB18030、UTF-8、UTF-16LE、UTF-16BE 等常用日志文件類型進行切割
6. 高度可配置（程序執(zhí)行周期、要刪除的日志文件過期時間、要切割的日志文件閥值和保留大小等均可配置

• 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          (查看服務狀態(tài))
                                    }

    *** 注 *** 
        @ LogCutter.exe 以 Windows 系統(tǒng)服務的方式運行，安裝好后也可以通過 Windows 服務管理器進行管理
        @ LogCutter.exe 是 32 位程序，LogCutter_x64.exe 是 64 位程序，根據(jù)需要使用其中之一
        @ LogCutter.exe 依賴 JRE 1.6, 因此必須在注冊表或環(huán)境變量中設置 %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 (默認)
--------------------------------------------------

三、環(huán)境要求
--------------------------------------------------
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:\LogCutter\logs">LogCutter.log*</file>
        <file path="D:\hMailServer\Logs">*.log</file>
        <file path="D:\Tomcat 6.0\logs">*.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.2\logs">*.log</file>
        <file path="D:\MySQL\MySQL Server 5.1\Datafiles\data">*.err</file>
    </cut-files>
</CONFIG>

Log-Cutter 1.0.3 更新：

  1) 程序包路徑改為 org.jessma.logcutter.*
  2) 增加 Win64 服務程序 LogCutter_x64.exe
  3) 完善使用幫助文檔
  4) 程序代碼中加入 License 注釋

posted on 2013-09-11 11:27 ~怪^_*獸~ 閱讀(1324) 評論(3)  編輯  收藏 所屬分類: 編程技術 、互聯(lián)網絡 、軟件設計