Go 中的日志级别

作者：迹忆客最近更新：2023/04/27 浏览次数：

本篇文章介绍如何在 Golang 中创建和使用日志级别。

Go 中的日志级别

Golang提供了一个日志包，名为log，是一个简单的日志包。这个包不提供分级日志；如果我们想要分级日志记录，我们必须手动添加前缀，如 debug、info 和 warn。

即使 Golang 的日志包没有分级日志的功能，但它仍然提供了手动实现日志分级的基本工具。让我们尝试一个 Golang 日志包的基本示例：

package main

import "log"

func main() {
    log.Println("Hello, This is jiyik.com!")
}

上面的代码将记录给定的内容并打印出来。查看输出：

2023/03/10 23:00:00 Hello, This is jiyik.com!

但是日志级别呢？如上所述，我们可以创建自定义日志级别和自定义记录器。

我们可以使用方法 log.New()，它接受以下三个参数来创建一个新的记录器：

out - out 用于实现 io.writer 接口写入日志数据。 prefix - 前缀是将添加到每行开头的字符串。 flag - 该标志用于定义记录器将使用哪些属性。现在通常使用七个日志级别：

Log 级别	描述
Trace	最低级别
Debug	第二级
Info	第三级
Warn	第四级
Error	第五级
Fatal	第六级
Panic	最高级别

让我们尝试一个基于信息、警告、调试和错误级别创建自定义日志记录级别的示例：

package main

import (
    "fmt"
    "io/ioutil"
    "log"
    "os"
)

var (
    Warning_Level *log.Logger
    Info_Level    *log.Logger
    Debug_Level   *log.Logger
    Error_Level   *log.Logger
)

func init() {
    file, err := os.OpenFile("Demo_logs.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0666)
    if err != nil {
        log.Fatal(err)
    }

    Info_Level = log.New(file, "INFO: ", log.Ldate|log.Ltime|log.Lshortfile)
    Warning_Level = log.New(file, "WARNING: ", log.Ldate|log.Ltime|log.Lshortfile)
    Debug_Level = log.New(file, "Debug: ", log.Ldate|log.Ltime|log.Lshortfile)
    Error_Level = log.New(file, "ERROR: ", log.Ldate|log.Ltime|log.Lshortfile)
}

func main() {
    Info_Level.Println("Loading the application.")
    Info_Level.Println("Loading taking time.")
    Warning_Level.Println("There is warning.")
    Debug_Level.Println("Here is debugging information.")
    Error_Level.Println("An Error Occured.")

    // read the log file
    data, err := ioutil.ReadFile("Demo_logs.txt")

    if err != nil {
        log.Panicf("failed reading data from file: %s", err)
    }
    fmt.Printf("\nThe file data is : %s", data)
}

上面的代码使用 Golang 的日志包创建自定义日志级别，并将日志信息写入文件。查看输出：

The file data is : INFO: 2023/03/10 23:00:00 prog.go:32: Loading the application.
INFO: 2023/03/10 23:00:00 prog.go:33: Loading taking time.
WARNING: 2023/03/10 23:00:00 prog.go:34: There is warning.
Debug: 2023/03/10 23:00:00 prog.go:35: Here is debugging information.
ERROR: 2023/03/10 23:00:00 prog.go:36: An Error Occured.

Fatal 和 Panic 级别也会导致程序或应用程序终止，这就是为什么无法使用内置日志包创建这些日志级别的原因。但是除了日志包之外，一些第三方日志包提供了七个内置的日志级别。让我们探索一下。

Go With zerolog 中的日志级别

zerolog 是 Golang 的第三方库，用于结构化 JSON 日志记录。 zerolog 提供了一个全局记录器，可以与 log 子包一起使用进行简单的日志记录。

除了简单的日志记录，zerolog 还提供内置的日志级别。 zerolog有七个日志级别，分别是Info、Warning、Debug、Error和Trace。

Zerolog 包在 GitHub 上提供，可以使用以下命令在 Golang 中下载：

$ go get -u github.com/rs/zerolog/log

使用 zerolog 使用日志级别非常简单。请参见下面的示例：

package main

import (
    "github.com/rs/zerolog"
    "github.com/rs/zerolog/log"
)

func main() {
    zerolog.SetGlobalLevel(zerolog.InfoLevel)

    log.Trace().Msg("Tracing..")
    log.Info().Msg("The file is loading.")
    log.Debug().Msg("Here is some useful debugging information.")
    log.Warn().Msg("There is a warning!")
    log.Error().Msg("An Error Occured.")
    log.Fatal().Msg("An Fatal Error Occured.")
    log.Panic().Msg("This is a panic situation.")

}

上面的代码将根据日志级别记录信息。查看输出：

{"level":"info","time":"2023-03-10T23:00:00Z","message":"The file is loading."}
{"level":"warn","time":"2023-03-10T23:00:00Z","message":"There is a warning!"}
{"level":"error","time":"2023-03-10T23:00:00Z","message":"An Error Occured."}
{"level":"fatal","time":"2023-03-10T23:00:00Z","message":"An Fatal Error Occured."}

Go With Logrus 中的日志级别

Logrus 是 Golang 的另一个第三方包，提供 JSON 日志记录。 GitHub上提供了Logrus包，可以在cmd中使用以下命令下载：

go get “github.com/Sirupsen/logrus”

Logrus 提供了 Trace 、Debug 、Info 、Warn 、Error 、Fatal 和 Panic 七种日志级别，按照严重程度排序。使用这些日志级别也类似于我们需要使用分包日志的zerolog。

让我们尝试一个来自 Logrus 的日志级别的例子：

package main

import (
    log "github.com/sirupsen/logrus"
)

func main() {
    log.SetFormatter(&log.JSONFormatter{})
    log.SetLevel(log.DebugLevel)
    log.SetLevel(log.TraceLevel)
    //log.SetLevel(log.PanicLevel)

    log.Trace("Tracing the log info, Lowest level")
    log.Debug("Debugging information. Level two")
    log.Info("Log Info. Level three")
    log.Warn("This is warning. Level Four")
    log.Error("An error occured. Level Five")
    // Calls os.Exit(1) after logging
    log.Fatal("Application terminated. Level Six")
    // Calls panic() after logging
    log.Panic("Panic Situation. Highest Level.")

}

上面的代码将使用 Logrus 包根据级别记录信息。我们必须设置级别以显示某些日志级别。

查看输出：

{"level":"trace","msg":"Tracing the log info, Lowest level","time":"2023-03-10T23:00:00Z"}
{"level":"debug","msg":"Debugging information. Level two","time":"2023-03-10T23:00:00Z"}
{"level":"info","msg":"Log Info. Level three","time":"2023-03-10T23:00:00Z"}
{"level":"warning","msg":"This is warning. Level Four","time":"2023-03-10T23:00:00Z"}
{"level":"error","msg":"An error occured. Level Five","time":"2023-03-10T23:00:00Z"}
{"level":"fatal","msg":"Application terminated. Level Six","time":"2023-03-10T23:00:00Z"}