“github.com/sirupsen/logrus”

示例:

  1. package main
  3. import (
  4.     "os"
  5.     log "github.com/sirupsen/logrus"
  6. )
  8. func init() {
  9.     // 设置日志格式为json格式
  10.     log.SetFormatter(&log.JSONFormatter{})
  12.     // 设置将日志输出到标准输出（默认的输出为stderr，标准错误）
  13.     // 日志消息输出可以是任意的io.writer类型
  14.     log.SetOutput(os.Stdout)
  16.     // 设置日志级别为warn以上
  17.     log.SetLevel(log.WarnLevel)
  18. }
  20. func main() {
  21.     log.WithFields(log.Fields{
  22.         "animal": "walrus",
  23.         "size":   10,
  24.     }).Info("A group of walrus emerges from the ocean")
  26.     log.WithFields(log.Fields{
  27.         "omg":    true,
  28.         "number": 122,
  29.     }).Warn("The group's number increased tremendously!")
  31.     log.WithFields(log.Fields{
  32.         "omg":    true,
  33.         "number": 100,
  34.     }).Fatal("The ice breaks!")
  35. }
  1. package main
  3. import (
  4.     "github.com/sirupsen/logrus"
  5.     "os"
  6. )
  8. // logrus提供了New()函数来创建一个logrus的实例。
  9. // 项目中，可以创建任意数量的logrus实例。
  10. var log = logrus.New()
  12. func main() {
  13.     // 为当前logrus实例设置消息的输出，同样地，
  14.     // 可以设置logrus实例的输出到任意io.writer
  15.     log.Out = os.Stdout
  17.     // 为当前logrus实例设置消息输出格式为json格式。
  18.     // 同样地，也可以单独为某个logrus实例设置日志级别和hook，这里不详细叙述。
  19.     log.Formatter = &logrus.JSONFormatter{}
  21.     log.WithFields(logrus.Fields{
  22.         "animal": "walrus",
  23.         "size":   10,
  24.     }).Info("A group of walrus emerges from the ocean")
  25. }

logrus的hook接口定义如下，其原理是每此写入日志时拦截，修改logrus.Entry。

  1. // logrus在记录Levels()返回的日志级别的消息时会触发HOOK，
  2. // 按照Fire方法定义的内容修改logrus.Entry。
  3. type Hook interface {
  4.     Levels() []Level
  5.     Fire(*Entry) error
  6. }
  1. 一个简单自定义hook如下，DefaultFieldHook定义会在所有级别的日志消息中加入默认字段appName="myAppName"。
  3. type DefaultFieldHook struct {
  4. }
  6. func (hook *DefaultFieldHook) Fire(entry *log.Entry) error {
  7.     entry.Data["appName"] = "MyAppName"
  8.     return nil
  9. }
  11. // 设置感兴趣的字段
  12. func (hook *DefaultFieldHook) Levels() []log.Level {
  13.     return log.AllLevels
  14. }

hook的使用也很简单，在初始化前调用log.AddHook(hook)添加相应的hook即可。

logrus官方仅仅内置了syslog的hook。
此外，但Github也有很多第三方的hook可供使用，文末将提供一些第三方HOOK的连接。

Windows控制台彩色输出

“github.com/shiena/ansicolor”

  1.     client.SetFormatter(&logrus.TextFormatter{
  2.             FullTimestamp: true,
  3.             TimestampFormat: "2006-01-02 15:04:05",
  4.             ForceColors: true,
  5.     })
  6.     client.SetOutput(ansicolor.NewAnsiColorWriter(os.Stdout))

日志分割

  1. func NewLoggerClient(config model.Log) Logger {
  2.     client := logrus.New()
  4.     // lofClient as JSON instead of the default ASCII formatter.
  5.     client.SetFormatter(&logrus.TextFormatter{
  6.         FullTimestamp: true,
  7.         TimestampFormat: "2006-01-02 15:04:05",
  8.         ForceColors: true,
  9.     })
  11.     writer, _ := rotatelogs.New(
  12.         config.ReservePath +"%Y%m%d%H%M.txt",
  13.         rotatelogs.WithLinkName(config.ReservePath + "/当前日志"),
  14.         rotatelogs.WithMaxAge(time.Hour),
  15.         rotatelogs.WithRotationTime(time.Duration(24 * config.RetentionTime)*time.Hour),
  16.     )
  17.     log.SetOutput(io.MultiWriter(writer, os.Stdout))
  19.     // Output to stdout instead of the default stderr
  20.     // Can be any io.Writer, see below for File example
  21.     client.SetOutput(ansicolor.NewAnsiColorWriter(os.Stdout))
  23.     // Only log the warning severity or above.
  24.     client.SetLevel(getLogLevel(config.Level))
  26.     Client = &lofClient{client: client}
  28.     return Client
  29. }