開發任何專案，都離不開日誌，配好自己的專案日誌輸出，往往是開發專案的前提。在golang中，seelog應該是比較有名的日誌處理包了，功能非常強大，seelog官方文件

一、seelog主要功能

下面我們看看seelog有啥強大

• 設定不同級別的日誌；
• 輸出到終端或檔案；
• 過濾指定級別日誌；
• 定義多種不同的日誌輸出格式；
• 根據觸發日誌的檔名或者函式名來區別輸出日誌；
• 通過 SMTP 或 TCP 轉發日誌(網路轉發日誌)；
• 滾動日誌檔案(過期日誌自動清除)。

二、安裝seelog

$ go get github.com/cihub/seelog

三、使用seelog

我們先看看一個官方的demo

package main

import (
    log "github.com/cihub/seelog"
)

func main() {
    defer log.Flush()
    log.Info("Hello from Seelog!")
}

很簡單是吧，匯入包，就直接可以用了，下面我們看看如何通過配置檔案高度定製我們的日誌。

import (
    log "github.com/cihub/seelog"
)

func SetupLogger() {
    logger, err := log.LoggerFromConfigAsFile("seelog.xml"
 
)
    if err != nil {
        return
    }

    log.ReplaceLogger(logger)
}

seelog的配置檔案一般用xml，下面我們看seelog.xml配置檔案的大體框架

<seelog>
    <exceptions>
        <exception ... />
        <exception ... />
        ...
    </exceptions>
    <outputs>
        <splitter>
            <console/>
            <file ...
 
 />
            <rollingfile ... />
            <smtp>
                ...
            </smtp>
            <buffered>
                ...
            </buffered>
            <conn ... />
        </splitter>
        <filter>
            ...
        </filter>
    </outputs>
    <formats>
        <format ... />
        <format ... />
        ...
    </formats>
</seelog>

<!-- type 設定記錄器型別 https://github.com/cihub/seelog/wiki/Logger-types-reference
minlevel 設定日誌最低級別; maxlevel 設定日誌的最高級別
也可以通過 <seelog levels="trace,info,critical"> 設定日記級別 -->
<seelog type="asynctimer" asyncinterval="5000000" minlevel="debug" maxlevel="error">
    <exceptions>
        <!-- <exception> 是為特定的程式檔案(filepattern)或函式(funcpattern)設定特殊的日誌規則 -->
        <exception funcpattern="*main.test*Something*" minlevel="info"/>
        <exception filepattern="*main.go" minlevel="error"/>
    </exceptions>

    <!-- <outputs> formatid 指定日誌輸出的格式(格式在<formats>標籤中定義) -->
    <outputs formatid="main">
        <!-- <console> 標籤表示輸出到終端 -->
        <console/>

        <!-- <splitter> 用於細分<outputs>日誌格式，內部支援:file(檔案), rollingfile(滾動檔案，自動清除過期),
        buffered(日誌寫到記憶體再寫到檔案), smtp(傳送日誌到郵件), con(網路轉發) -->
        <splitter formatid="format1">
            <!-- log.log, log2.log將按<formats>標籤中的id="format1"格式寫入 -->
            <file path="log.log"/>
            <file path="log2.log"/>
        </splitter>
        <splitter formatid="format2">
            <file path="log3.log"/>
            <file path="log4.log"/>
        </splitter>

        <!-- <rollingfile>滾動檔案(定期清除過期日誌)
        formatid: 指定日誌格式; type="size" 按大小; maxsize: 單日誌檔案最大大小; maxrools: 最大檔案數 -->
        <rollingfile formatid="someformat" type="size" filename="./log/roll.log" maxsize="100" maxrolls="5" />

        <!-- <buffered> 將日誌先存在記憶體中，定期寫入檔案，適合日誌併發量較大或 IO 比較緊張的場合
        size: 快取大小; flushperiod: 快取間隔(毫秒) -->
        <buffered formatid="testlevels" size="10000" flushperiod="1000">
            <file path="./log/bufFileFlush.log"/>
        </buffered>

        <!-- <filter>用於單獨處理某級別日誌
        過濾日誌，把級別是error的通過郵件smtp方式傳送出去(一般會發給相應的運維人員) -->
        <filter levels="error">
            <file path="./log/error.log"/>
            <smtp senderaddress="[email protected]" 
                  sendername="Automatic notification service" 
                  hostname="mail.none.org" 
                  hostport="587" 
                  username="nns" 
                  password="123">
                <recipient address="[email protected]"/>
                <recipient address="[email protected]"/>
            </smtp>
            <!-- 按tcp4網路協議傳送日誌 -->
            <conn net="tcp4" addr="server.address:5514" tls="true" insecureskipverify="true" />
        </filter>

    </outputs>

    <!-- <formats> 定製日誌的輸出格式
    https://github.com/cihub/seelog/wiki/Format-reference -->
    <formats>
        <format id="main" format="%Date(2006 Jan 02/3:04:05.000000000 PM MST) [%Level] %Msg%n"/>
        <format id="someformat" format="%Ns [%Level] %Msg%n"/>
        <format id="testlevels" format="%Level %Lev %LEVEL %LEV %l %Msg%n"/>
        <format id="usetags" format="&lt;msg&gt;%Msg&lt;/time&gt;"/>
        <format id="format1" format="%Date/%Time [%LEV] %Msg%n"/>
        <format id="format2" format="%File %FullPath %RelFile %Msg%n"/>
    </formats>
</seelog>

初次接觸難免會覺得配置檔案的內容有點多，難以理解，其實只要我們理解它配置檔案的大體框架，然後自己試著更改配置檔案，看看輸出什麼，就很快明白了。

<!-- 我只需要把日誌按指定格式輸出到終端 -->
<seelog type="asynctimer" asyncinterval="1000000" minlevel="debug" maxlevel="error">
    <outputs formatid="main">
        <!-- 僅輸出到終端 -->
        <console/>
    </outputs>
    <formats>
        <!-- 設定格式 -->
        <format id="main" format="%UTCDate %UTCTime - [%LEV] - %RelFile - l%Line - %Msg%n"/>
    </formats>
</seelog>

<!-- ****** 我是分割線 ***** -->

<!-- 現在我想把日誌輸出到終端同時也把日誌輸出到檔案 -->
<seelog type="asynctimer" asyncinterval="1000000" minlevel="debug" maxlevel="error">
    <outputs formatid="main">
        <console/>
        <!-- 輸出到檔案，且不同於終端的日誌格式 -->
        <splitter formatid="format1">
            <file path="log.log"/>
        </splitter>
    </outputs>
    <formats>
        <!-- 設定格式 -->
        <format id="main" format="%UTCDate %UTCTime - [%LEV] - %RelFile - l%Line - %Msg%n"/>
        <format id="format1" format="%Date(2006 Jan 02/3:04:05.000000000 PM MST) [%Level] %Msg%n"/>
    </formats>
</seelog>