~怪^_*獸~

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

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

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

• JessMA 官方網(wǎng)站：http://www.jessma.org
• Log-Cutter 下載地址：http://code.google.com/p/ldcsaa/

• 使用方法：

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

一、啟動(dòng)方式
--------------------------------------------------
1) Windows
    A) 前臺(tái)運(yùn)行: > ./run.bat [ -f config-file ]
    B) 后臺(tái)運(yùn)行: > LogCutter.exe    {    
                                      -install-demand  (安裝手動(dòng)啟動(dòng)服務(wù))
                                      -install-auto    (安裝自動(dòng)啟動(dòng)服務(wù))
                                      -uninstall       (刪除服務(wù))
                                      -start           (啟動(dòng)服務(wù))
                                      -stop            (停止服務(wù))
                                      -status          (查看服務(wù)狀態(tài))
                                    }

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

2) Linux / Unix
    A) 前臺(tái)運(yùn)行: $ ./run.sh [ -f config-file ]
    B) 后臺(tái)運(yùn)行: $ ./run.sh [ -f config-file ] -d

    *** 注 ***
    @ 可以設(shè)置為開機(jī)時(shí)自動(dòng)后臺(tái)運(yùn)行，方法如下:

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

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

三、環(huán)境要求
--------------------------------------------------
1) Java 版 本: JRE 1.6 以上
2) 依賴程序包: dom4j、log4j、juniversalchardet
--------------------------------------------------

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

• 配置文件

<?xml version="1.0" encoding="UTF-8"?>
<CONFIG>
    <global>
        <!-- 開始日志檢查延時(shí) (小時(shí)), 默認(rèn): 0 (立刻開始) -->
        <start-check-delay>1</start-check-delay>
        <!-- 日志檢查間隔 (小時(shí)), 默認(rèn): 72 -->
        <check-interval></check-interval>
        <!-- Log4J 配置文件, 默認(rèn): ${CLASS_ROOT}/../conf/log4j.properties -->
        <log4j-config-file></log4j-config-file>
        <!-- 程序鎖, 默認(rèn): ${CLASS_ROOT}/../${APP_NAME}.lock -->
        <lock-file></lock-file>
    </global>
    <!-- 要?jiǎng)h除的日志文件列表 -->
    <!-- delete-files.expire: 日志文件過(guò)期時(shí)間(天), 默認(rèn): 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>
    <!-- 要截?cái)嗟娜罩疚募斜?nbsp;-->
    <!-- cut-files.threshold: 日志文件截?cái)嚅y值(KB), 默認(rèn): 10240 -->
    <!-- cut-files.reserve: 日志文件保留內(nèi)容(KB), 默認(rèn): 1024 -->
    <!--
         <!注!> 'cut-files.reserve' 是保留內(nèi)容的近似值得, 實(shí)際內(nèi)容按行取整保留
            如下列日志文件內(nèi)容:
                  
                 line1: xxxxxxxxxxxxxxxxxxxxx
                 line2: xxxxxxxxxxPyyyyyyyyyy
                 line3: zzzzzzzzzzzzzzzzzzzzz
                 line4: zzzzzzzzzzzzzzzzzzzzz
                    (EOF)
             'P'為定位得到的保留起點(diǎn), 程序?qū)嶋H會(huì)在'P'點(diǎn)開始查找下一個(gè)換行符,
             從該換行符的后一個(gè)字符開始保留, 也就是從第三行開始保留到文件末尾
    -->
    <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 服務(wù)程序 LogCutter_x64.exe
  3) 完善使用幫助文檔
  4) 程序代碼中加入 License 注釋

posted on 2013-09-11 11:27 ~怪^_*獸~ 閱讀(1325) 評(píng)論(3)  編輯  收藏 所屬分類: 編程技術(shù) 、互聯(lián)網(wǎng)絡(luò) 、軟件設(shè)計(jì)