Golang seelog 使用入门简介

1 首先安装Seelog库

go get github.com/cihub/seelog

2 简单的日志输出

参考官方文档，些一个快速开始的 hello world 程序：

package main  

import log "github.com/cihub/seelog"  

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

3 输出到文件

3.1 使用 xml 配置文件

接下来我们些一个配置文件，使得 log 信息写入到本地文件。

<seelog type="asynctimer" asyncinterval="5000000" minlevel="trace" maxlevel="error">  
   <outputs formatid="common">  

   <buffered formatid="common" size="10000" flushperiod="1000">  

   <rollingfile type="date" filename="./log/test.log" datepattern="02.01.2006" fullname="true" maxrolls="30"/>  

   </buffered>  

   </outputs>  

    <formats>  
        <!--  

        <format id="common" format="%Date %Time %EscM(46)[%LEV]%EscM(49)%EscM(0) [%File:%Line] [%Func] %Msg%n" />  
        -->  
        <format id="common" format="%Date %Time [%LEV] [%File:%Line] [%Func] %Msg%n" />  
    </formats>  
</seelog>  

按天拆分

<seelog type="asynctimer" asyncinterval="5000000" minlevel="trace" maxlevel="critical">
    <outputs formatid="main">
        <filter levels="trace,debug,info,warn,error,critical">
        <buffered size="10000" flushperiod="1000">
            <rollingfile type="date" filename="run.log" datepattern="20060102" maxrolls="30"/>
        </buffered>
        </filter>
    </outputs>
    <formats>
        <format id="main" format="%Time|%LEV|%File|%Line|%Msg%n"/>
    </formats>
</seelog>

其中：
outputs——里面是日志的配置，其中formatid中的id指定的是标签中的id，也就是按照format标签中格式来输出日志
buffered——指的是缓冲设置，size表示缓冲区大小，单位为byte。flushperiod表示刷新时间间隔，单位为ms

rollingfile——指定日志设置，type指定回滚方式，data表示按时期回滚，maxrolls表示最大重命名文件数。

按上述文件进行配置，则可以保存30天内的日志数据。个人还是比较喜欢这种配置方式的。当然对于更高级的配置，请参考官方文档。链接如下：
https://github.com/cihub/seelog/wiki/Receiver-reference

接下来我们修改下刚才的go代码。

package main  

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

func main() {  
    defer log.Flush()  

    //加载配置文件  
    logger, err := log.LoggerFromConfigAsFile("config.xml")  

    if err!=nil{  

        fmt.Println("parse config.xml error")  
    }  

    //替换记录器  
    log.ReplaceLogger(logger)  

    for i:=0;i<1024;i++{  

        log.Info("Hello from Seelog!")  
    }  
}

3.2 使用字节配置

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

type LogCfg struct {
    Levels              string `json:"levels"` 
    Fmt_id              string `json:"fmt_id"`
    Roll_type           string `json:"roll_type"`
    File_name           string `json:"file_name"`
    Roll_type_param     string `json:"roll_type_param"`
    Roll_type_max_rolls string `json:"roll_type_max_rolls"`
}

type LocalLogInterface log.LoggerInterface

func RollingFile( cfg LogCfg ) ( LocalLogInterface, error ) {

    logConfig_Temp := `
<seelog type="sync" levels="%s" >
    <outputs formatid="%s">
        <rollingfile type="%s" filename="%s" %s="%s" maxrolls="%s" />
    </outputs>
    <formats>
        <format id="main" format="[%%Date %%Time] [%%LEV] %%Func(): %%Msg%%n"/>
        <format id="sub1" format="[%%Date %%Time] [%%LEV]: %%Msg%%n"/>
        <format id="sub2" format="[%%Date - %%Time] [%%LEV] %%Func(): %%Msg%%n"/>
    </formats>
</seelog>`  

    cfg_roll_type_map := map[string] string { "date":"datepattern", "size":"maxsize" }

    roll_type_param_key, _ := cfg_roll_type_map[cfg.Roll_type]

    logConfig := fmt.Sprintf(  logConfig_Temp, 
                                cfg.Levels,
                                cfg.Fmt_id,
                                cfg.Roll_type, 
                                cfg.File_name, 
                                roll_type_param_key,
                                cfg.Roll_type_param,
                                cfg.Roll_type_max_rolls  )

    logger, err := log.LoggerFromConfigAsBytes( []byte( logConfig ) )

    if err != nil {
        fmt.Println( err )
    }

    loggerErr := log.ReplaceLogger( logger )

    if loggerErr != nil {
        fmt.Println( loggerErr )
    }

    return logger, err
}

本地日志通过对第三方包 “github.com/cihub/seelog” 做的二次封装，主要目的是为了清晰地定义一部分日志格式和统一配置文件为 json 格式，方便使用。

配置说明

"levels":               "info, trace, error, critical",
"fmt_id":               "main",
"roll_type":            "date",
"file_name":            "./log/manyrolls_date.log",     
"roll_type_param":      "20180101",
"roll_type_max_rolls":  "4"

1. levels 定义日志都输出哪些等级的日志，可在以下内容中选择任意数量的等级以逗号区分：trace，debug，info，warn，error，critical。

2. fmt_id 日志格式 ID，目前代码中预定义的有 main，sub1，sub2.

   main: [2018-02-05 14:14:43] [INF] InitSqlPtr(): initSql init complete.

   sub1: [2018-02-05 14:14:43] [INF] InitSql init complete.

   sub2: [2018-02-05 - 14:14:43] [INF] InitSqlPtr(): initSql init complete.

3. roll_type 回滚方式，选项 date 和 size，如果为 date 将会按照时间拆分日志，如果为 size 将会按照 size 拆分日志。

4. file_name 日志输出文件路径。

5. roll_type_param 日志输出拆分参数，当 roll_type 为 date 时，这个参数应该设置为 20180101，为时间限制； 当 roll_type 为 date 时，这个参数应设为 102400，为日志尺寸限制。

6. roll_type_max_rolls 日志最大拆分次数，如果设置为 4 ， 当第五次回滚拆分的时候，将会删除历史日志最早的那只文件。

使用举例

logger, err := log.RollingFile( LocalLogCfg )
if nil != err {
    panic( err )
}

// 格式化输出
logger.Infof( "cfg -->> %#v", LocalLogCfg )

// 输出内容
logger.Trace("Test messagedddd!")
logger.Debug("Debug Printed")
logger.Info("Info Printed")
logger.Warn("Warn Printed")
logger.Error("Error Printed")
logger.Critical("Critical Printed")