设计自用的golang日志模块

设计自用的golang日志模块

golang的原生日志模块不能满足需求，而开源的第三方包，也不完全够用。用户较多的logrus，却没有rotate功能，这已经是众所周知的。对于运维来说，当然是希望日志的处理中比较简单、实用、够用。不需要额外的通过系统来实现logrotate。

1、需求

从需求方面来说，主要有几个方面：

一方面肯定是需要有轮转功能，而且要限制保留的日志份数。至于是按文件大小，还是按天、按小时切割，则可以讨论。

另一方面，对于日志的级别，如果能够动态调整，则方便日志关闭常规日志，在线调试时，动态降低日志的等级，打印更多debug日志。

2、调研

目前主要的有几个：

• github.com/sirupsen/logrus。用户广泛，但明确表示不支持日志切割功能，建议通过hook走日志系统。
• github.com/natefinch/lumberjack。支持以文件大小的方式切割日志。用户偏少。
• gopkg.in/inconshreveable/log15.v2。比较老牌。
• github.com/lestrrat-go/file-rotatelogs。基于小时数进行切割的小众包。
• github.com/xiaomi-tc/log15。小米基于log15写的二次封装增加了切割功能。但只有2星。
• 有前同事基于log15写的二次封装，但log15.v2/ext的包不太容易理解。
• github.com/ngaut/log。完全不依赖第三方包。可基于日期及小时进行切割。

综上，ngaut比较适合学习和了解封装过程。而基于logrus则是比较靠谱的选择，底层需要其他包实现的切割功能。

3、功能设计

主要点：

• 由logrus来完成日志功能。
• 需要完成日志切割，历史日志需要压缩
• 支持参考Go代码遇到的问题提供的level热更新

3.1 基于file-rotatelogs实现

即基于日期的日志轮转。

代码：github.com/jungle85gopy/rotlogs/daterot

示例代码：参考github.com/jungle85gopy/rotlogs/example/date/date.go

两个不足之处：

• 该库没有压缩功能。
• 日志目录对相对路径不友好。
  • 比如使用log/access.log时。log/access.log是个软链，链接到带日志的文件。

# ls -l log
lrwxr-xr-x  1 song  staff    28 Mar  8 13:23 access.log -> log/access.log.20180308-1323
-rw-r--r--  1 song  staff  2511 Mar  8 13:23 access.log.20180308-1323

# tail log/access.log
tail: log/access.log: No such file or directory

解决办法之一就是不使用软链，将是不主动设置BaseLinkName变量。

3.2 基于lumberjack实现

即基于文件大小的日志轮转。

代码：github.com/jungle85gopy/rotlogs

示例代码：参考github.com/jungle85gopy/rotlogs/example/size/size.go

这个版本的不足之处，在于日志切割后日志，其文件名过于复杂。可能不便后后继处理

# ls -l log
abcd-2018-03-08T14-09-31.066.log.gz
abcd-2018-03-08T14-26-18.794.log.gz