商业公链之区块链技术使用的常见库（二）------GO语言日志库"github.com/cihub/seelog"

GO语言日志库"github.com/cihub/seelog"

Seelog可以设置不同级别的日志库，过滤输出设定级别的日志，输出不同格式日志文件到终端或文件，根据触发日志名或者函数名区分不同日志，实现网络转发或者定期删除日志等功能。

日志级别分为：Trace（相比debug范围更广，适合release），debug（只适合debug开发版本，调试时更详细的了解系统运行状态），info（重要输出信息：用来反馈系统的当前状态给最终用户的，用于产品），warn（可修复，系统可继续运行下去），Error（可修复性，但无法确定系统会正常的工作下去），Critical（错误已经无法修复，必须停止运行，防止程序破坏）。

1.安装seelog日志库：

go get github.com/cihub/seelog

2.导入日志库：

import  log "github.com/cihub/seelog"

3.使用日志配置文件，生成记录器：

 logger, err := log.LoggerFromConfigAsFile("seelog.xml")

4.使用新的记录器进行替换记录：

log.ReplaceLogger(logger)

5.打印info级别日志：

log.Info("Hello from Seelog!")

6.启用协程刷新产生日志：

 defer log.Flush()

下面我们来介绍以下日志库配置文件seelog.xml，包括三个部分<exception> 是为特定的程序文件(filepattern)或函数(funcpattern)设定特殊的日志规则，<outputs>指定日志输出配置，<formats> 定制日志的输出格式：

<!-- type 设置记录器类型 https://github.com/cihub/seelog/wiki/Logger-types-reference

minlevel 设置日志最低级别; maxlevel 设置日志的最高级别，也可以通过 <seelog levels="trace,info,critical"> 设置日记级别，asynctimer异步记录 asyncinterval时间间隔大于日志消息-->

<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="noreply-notification-service@none.org"

                  sendername="Automatic notification service"

                  hostname="mail.none.org"

                  hostport="587"

                  username="nns"

                  password="123">

                <recipient address="john-smith@none.com"/>

                <recipient address="hans-meier@none.com"/>

            </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="<msg>%Msg</time>"/>

        <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>

示例程序：阅读原文，用法文档：https://godoc.org/github.com/cihub/seelog#Info

希望大家关注我的微信公众号，日更一篇区块链技术博客不易，有疑问可以后台留言。