1. 设置日志格式的方法

logrus中，使用如下方法设置日志格式

func SetFormatter(formatter Formatter) 

其中Formatter是一个接口

type Formatter interface {
    Format(*Entry) ([]byte, error)
}

所以，实现自定义日志格式，本质上就是实现Formatter接口，然后通过SetFormatter方式将其告知logrus。

2. 已有Formatter

logrus包中自带两种Formatter，分别是TextFormatter和JSONFormatter。 默认情况下，使用TextFormatter输出。

func main(){
    logrus.WithField("name", "ball").Info("this is from logrus")
}

//输出
INFO[0000] this is from logrus      name=ball

说明：

• 以上是go version go1.14.4 linux/amd64环境的输出。
  go version go1.14.4 windows/amd64中的输出较为友好：

time="2021-05-10T15:54:33+08:00" level=info msg="this is from logrus" name=ball

• 下文输出均以go version go1.14.4 linux/amd64为准。

2.1 TextFormatter

TextFormatter有若干可定制参数，常用参数如下，更多参数及功能，可在源码的text_formatter.go中看到。

type TextFormatter struct{
    //颜色显示相关
    ForceColors bool
    EnvironmentOverrideColors bool
    DisableColors bool
    
    //日志中的键值对加引号相关
    ForceQuote bool
    DisableQuote bool
    QuoteEmptyFields bool
    
    //时间戳相关
    DisableTimestamp bool
    FullTimestamp bool
    TimestampFormat string
}

例1

func main(){
    logrus.SetFormatter(&logrus.TextFormatter{
        ForceQuote:true,    //键值对加引号
        TimestampFormat:"2006-01-02 15:04:05",  //时间格式
        FullTimestamp:true,     
    })
    
    logrus.WithField("name", "ball").WithField("say", "hi").Info("info log")
}

// 输出
INFO[2021-05-10 16:28:50] info log      name="ball" say="hi"

说明：
默认是Colors模式，该模式下，必须设置FullTimestamp:true， 否则时间显示不生效。

例2

func main(){
    logrus.SetFormatter(&logrus.TextFormatter{
        DisableColors:true,
        ForceQuote:false,
        TimestampFormat:"2006-01-02 15:04:05",
    })
    logrus.WithField("name", "ball").WithField("say", "hi").Info("info log")
}

//输出
time="2021-05-10 16:32:42" level=info msg="info log" name=ball say=hi

说明：
DisableColors为true时，日志的样子有所改变。

2.2 JSONFormatter

常用参数如下，更多参数及功能，可在源码的json_formatter.go中看到。

type JSONFormatter struct {
    //时间戳相关
    TimestampFormat string
    DisableTimestamp bool

    DisableHTMLEscape bool

    // PrettyPrint will indent all json logs
    PrettyPrint bool
}

例

func main(){
    logrus.SetFormatter(&logrus.JSONFormatter{
        TimestampFormat:"2006-01-02 15:04:05",
        PrettyPrint: true,
    })
    logrus.WithField("name", "ball").WithField("say", "hi").Info("info log")
}

//输出
{
  "level": "info",
  "msg": "info log",
  "name": "ball",
  "say": "hi",
  "time": "2021-05-10 16:36:05"
}

说明：
若不设置PrettyPrint: true， 则json为单行输出。

3. 自定义Formatter

自定义Formatter，其实就是实现Formatter接口。

type Formatter interface {
    Format(*Entry) ([]byte, error)
}

接口的返回值[]byte，即为输出串。关键在于搞懂输入参数Entry。

3.1 Entry参数

type Entry struct {
    // Contains all the fields set by the user.
    Data Fields

    // Time at which the log entry was created
    Time time.Time

    // Level the log entry was logged at: Trace, Debug, Info, Warn, Error, Fatal or Panic
    Level Level

    //Calling method, with package name
    Caller *runtime.Frame

    //Message passed to Trace, Debug, Info, Warn, Error, Fatal or Panic
    Message string

    //When formatter is called in entry.log(), a Buffer may be set to entry
    Buffer *bytes.Buffer
}

说明：

• Data中是key/value形式的数据，是使用WithField设置的日志。
• Caller是日志调用者相关的信息，可以利用其输出文件名，行号等信息，感兴趣可以参看《logrus中输出文件名、行号及函数名》

例

type MyFormatter struct {

}

func (m *MyFormatter) Format(entry *logrus.Entry) ([]byte, error){
    var b *bytes.Buffer
    if entry.Buffer != nil {
        b = entry.Buffer
    } else {
        b = &bytes.Buffer{}
    }

    timestamp := entry.Time.Format("2006-01-02 15:04:05")
    var newLog string
    newLog = fmt.Sprintf("[%s] [%s] %s\n", timestamp, entry.Level, entry.Message)

    b.WriteString(newLog)
    return b.Bytes(), nil
}

func main(){
    logrus.SetFormatter(&MyFormatter{})
    logrus.WithField("name", "ball").WithField("say", "hi").Info("info log")
}

//输出
[2021-05-10 17:26:06] [info] info log

说明：例子中没有处理entry.Data的数据，因此使用WithField设置的name，say数据均没有输出。