Go语言标准库之log和三方库zap

闲谈社2024-05-28 10:42

一、Log

1.1 logger基本使用

Go语言内置的log包实现了简单的日志服务。本包也提供了一个预定义的"标准"logger，可以通过调用函数Print系列(Print|Printf|Println)、Fatal系列（Fatal|Fatalf|Fatalln)、和Panic系列（Panic|Panicf|Panicln)来使用，比自行创建一个logger对象更容易使用。

Fatal系列用于输出一条致命错误信息，并调用 os.Exit(1) 终止程序运行。这个函数会在打印完错误信息之后立即调用 os.Exit 退出程序。

go 复制代码 
package main

import (
	"log"
)

func main() {
	log.Println("卡卡西的日志")

	x := "鸣人"
	log.Printf("%s的日志\n", x)
	
	log.Fatalln("会触发fatal的日志")
	
	// 这里的代码不会被执行，因为程序已经在 log.Fatalln 后退出了
	log.Panicln("会触发panic的日志")
}
go 复制代码 
2024/05/16 23:03:24 卡卡西的日志
2024/05/16 23:03:24 鸣人的日志       
2024/05/16 23:03:24 会触发fatal的日志
exit status 1

1.2 logger配置

基础的logger只提供日志的时间信息，如果需要获取更多的信息或者输出方式，可以通过进一步配置实现。

1.2.1 标准配置 log.SetFlags.SetFlags

  • log.SetFlags() 函数用于设置日志的输出格式
  • log.Flags() 函数来获取当前日志包的配置标志，并将其打印输出。

以下是 log 包中定义的一些常用选项：

  • log.Ldate：日期：2009/01/23
  • log.Ltime：时间：01:23:23
  • log.Lmicroseconds：微秒级时间：01:23:23.123123
  • log.Llongfile：文件名和行号：/a/b/c/d.go:23
  • log.Lshortfile：文件名和行号：d.go:23
  • log.LUTC：使用 UTC 时间

下面在记录日志之前先设置一下logger的输出选项：

go 复制代码 
package main

import (
	"fmt"
	"log"
)

func main() {
	log.SetFlags(log.Llongfile | log.Lmicroseconds | log.Ldate)
	log.Println("卡卡西的日志")

	flags := log.Flags()
	fmt.Println("Flags:", flags)
}

输出结果

go 复制代码 
2024/05/16 23:25:39.519510 d:/go/练习/main.go:10: 卡卡西的日志
Flags: 13

1.2.2 前缀配置 log.SetPrefix 和 log.Prefix

  • log.SetPrefix 用于设置日志输出的前缀，它接受一个字符串作为参数，这个字符串将会作为日志信息的前缀显示在每条日志的最前面。
  • log.Prefix 则是一个属性，用于获取当前日志输出的前缀。
go 复制代码 
func main() {
	log.SetPrefix("复制忍者：")
	log.Println("卡卡西")

	prefix := log.Prefix()
	fmt.Println(prefix)
}

输出结果是

go 复制代码 
复制忍者：2024/05/18 10:06:56 卡卡西
复制忍者：

1.2.3 输出位置 log.SetOutput

log.SetOutput 用于设置日志输出的目标。这个函数接受一个 io.Writer 类型的参数，将日志输出到指定的 io.Writer 实现。

go 复制代码 
func main() {
	file, err := os.OpenFile("logfile.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
	if err != nil {
		log.Fatal("Failed to open logfile.log", err)
	}
	defer file.Close()

	log.SetOutput(file)
	log.SetFlags(log.Llongfile | log.Lmicroseconds | log.Ldate)
	log.Println("卡卡西")
	log.SetPrefix("复制忍者：")
}

1.3 logger对象创建

log.New 用于创建一个新的 Logger 对象。这个函数接受三个参数：一个实现了 io.Writer 接口的目标输出流、一个用于添加前缀的字符串、以及一个用于指定日志属性的标志选项。

go 复制代码 
func main() {
	// 创建一个新的 Logger 对象，将日志输出到标准错误输出，并添加前缀 "ERROR: "
	logger := log.New(os.Stderr, "ERROR: ", log.LstdFlags)

	// 使用新创建的 Logger 对象输出日志
	logger.Println("This is an error message.")
}

输出结果

go 复制代码 
ERROR: 2024/05/18 10:27:40 This is an error message.

二、第三方日志库 Zap

注意：Zap并不是Go的标准库，而是为了解决Go内置log库功能有限的问题，所引入的第三方日志库。在此处介绍Zap是为了方便与log库进行对比学习。

  • Zap的优点：快、结构化，分日志级别。

Zap 日志库提供了两种类型的日志记录器：Sugared Logger 和 Logger。它们分别适用于不同的日志记录场景。

  1. Sugared Logger:

    • Sugared Logger 提供了结构化和格式化的日志记录功能，支持使用类似 Printf 风格的方法记录日志。
    • 它使用了结构化的上下文字段，可以方便地记录关键-值对形式的日志信息。
    • Sugared Logger 适合用于一般的日志记录需求，提供了更直观、易用的 API。

  2. Logger:

    • Logger 提供了更底层的、零分配（zero-allocation）的日志记录功能，适用于高性能、高吞吐量的日志记录需求。
    • 它的 API 相对更加简洁，不支持结构化的上下文字段，但在性能方面有优势。
    • Logger 适合用于需要尽量减少内存分配和提升性能的场景。

根据具体的需求和场景，可以选择使用 Zap 提供的 Sugared Logger 或 Logger 来实现相应的日志记录功能。

2.1 Logger

  1. 调用zap.NewProduction()或者zap.NewDevelopment()或者zap.Example()创建了一个 Zap 日志记录器
  2. 通过Logger调用Info/Error等
  3. 程序结束前调用 logger.Sync() 来确保所有日志都被输出

zap.NewProduction()：会配置 Logger 以适应生产环境的需求，例如默认会将日志输出到标准错误输出，并且会禁用堆栈跟踪等详细的调试信息，以减少对性能的影响。适合用于生产环境中记录稳定运行日志的场景。
zap.NewDevelopment()：会配置 Logger 以便于开发过程中更好地跟踪和调试日志，例如会输出更详细的调试信息和堆栈跟踪。适合用于开发和调试过程中辅助定位问题、跟踪日志的场景。
zap.Example()：是一个示例方法，提供了一个简单的例子，演示了如何创建 Logger 实例、记录不同级别的日志、以及如何添加结构化的上下文字段等操作。

下面通过简单的http get介绍logger的用法

go 复制代码 
package main

import (
	"net/http"
	"go.uber.org/zap"
)

var logger *zap.Logger

// 初始化日志记录器
func InitLogger() {
	logger, _ = zap.NewProduction()
}

// 发送 HTTP GET 请求
func httpGet(url string){
	resp, err := http.Get(url)
	if err != nil {
		// 如果请求中出现错误，记录错误日志
		logger.Error(
			"Error fetching url: ",
			zap.String("url",url),
			zap.Error(err))
	} else {
		// 如果请求成功，记录成功日志
		logger.Info(
			"Success: ",
			zap.String("statusCode", resp.Status),
			zap.String("url", url))
		resp.Body.Close()
	}
}

func main() {
	InitLogger()

	// 使用了 defer 关键字来延迟执行 logger.Sync()，以确保在程序退出前执行同步操作
	defer logger.Sync()

	httpGet("https://blog.csdn.net/Ricardo2/article/details/134253323")
	httpGet("www.google.com")
}

输出结果

go 复制代码 
{"level":"info","ts":1716001211.442937,"caller":"练习/main.go:26","msg":"Success: ","statusCode":"403 Forbidden","url":"https://blog.csdn.net/Ricardo2/article/details/134253323"}
{"level":"error","ts":1716001211.443463,"caller":"练习/main.go:20","msg":"Error fetching url: ","url":"www.google.com","error":"Get \"www.google.com\": unsupported protocol scheme \"\"","stacktrace":"main.httpGet\n\td:/go/练习/main.go:20\nmain.main\n\td:/go/练习/main.go:41\nruntime.main\n\tE:/goland/src/runtime/proc.go:250"}

2.2 SugaredLogger

大部分的实现基本都相同。

惟一的区别是，我们通过logger.Sugar()方法来获取一个SugaredLogger。

go 复制代码 
package main

import (
	"net/http"
	"go.uber.org/zap"
)

var sugarLogger *zap.SugaredLogger

// 初始化日志记录器
func InitLogger() {
	logger, _ := zap.NewProduction()
	sugarLogger = logger.Sugar()
}

// 发送 HTTP GET 请求
func httpGet(url string){
	sugarLogger.Debugf("Trying to grt request for %s", url)
	resp, err := http.Get(url)
	if err != nil {
		// 如果请求中出现错误，记录错误日志
		sugarLogger.Error(
			"Error fetching url: ",
			zap.String("url",url),
			zap.Error(err))
	} else {
		// 如果请求成功，记录成功日志
		sugarLogger.Info(
			"Success: ",
			zap.String("statusCode", resp.Status),
			zap.String("url", url))
		resp.Body.Close()
	}
}

func main() {
	InitLogger()

	// 使用了 defer 关键字来延迟执行 logger.Sync()，以确保在程序退出前执行同步操作
	defer sugarLogger.Sync()

	httpGet("https://blog.csdn.net/Ricardo2/article/details/134253323")
	httpGet("www.google.com")
}

输出结果

go 复制代码 
{"level":"info","ts":1716001865.691326,"caller":"练习/main.go:28","msg":"Success: {statusCode 15 0 403 Forbidden <nil>} {url 15 0 https://blog.csdn.net/Ricardo2/article/details/134253323 <nil>}"}
{"level":"error","ts":1716001865.6924412,"caller":"练习/main.go:22","msg":"Error fetching url: {url 15 0 www.google.com <nil>} {error 26 0  Get \"www.google.com\": unsupported protocol scheme \"\"}","stacktrace":"main.httpGet\n\td:/go/练习/main.go:22\nmain.main\n\td:/go/练习/main.go:43\nruntime.main\n\tE:/goland/src/runtime/proc.go:250"}

2.3 日志级别

Zap 日志库支持以下几种日志级别，可以根据不同的需求来选择合适的级别记录日志：

  • Debug:
    用于记录调试过程中的详细信息，通常在开发和调试阶段使用。
    使用 logger.Debug() 方法记录 Debug 级别的日志。
  • Info:
    用于记录程序运行过程中的一般信息，例如启动信息、关键事件等。
    使用 logger.Info() 方法记录 Info 级别的日志。
  • Warn:
    用于记录可能出现问题但不会影响程序正常运行的警告信息，例如参数使用不当、潜在的问题等。
    使用 logger.Warn() 方法记录 Warn 级别的日志。
  • Error:
    用于记录程序中的错误信息，例如异常、错误状态等。
    使用 logger.Error() 方法记录 Error 级别的日志。
  • DPanic:
    用于记录严重的错误，会导致程序进入恐慌状态的错误。
    使用 logger.DPanic() 方法记录 DPanic 级别的日志。
  • Panic:
    用于记录导致程序无法继续正常运行的错误，记录后会触发程序 panic。
    使用 logger.Panic() 方法记录 Panic 级别的日志。
  • Fatal:
    用于记录导致程序无法继续运行的严重错误，记录后会触发程序退出。
    使用 logger.Fatal() 方法记录 Fatal 级别的日志。

2.4 Zap配置

2.4.1 标准配置

下面介绍如何对Zap的日志做详细的配置：

  • 如何写入日志
  • 日志写入到哪里
  • 写入什么级别的日志

具体来说，将使用zap.New(...)方法来手动传递所有配置

go 复制代码 
func New(core zapcore.Core, options ...Option) *Logger

zapcore.Core 接口类型的实例，定义了日志记录的核心功能，包括日志级别的判断LogLevel、格式化日志消息Encoder、输出日志的目的地WriteSyncer等。

（1）Encoder：编码器(如何写入日志)。我们将使用开箱即用的NewJSONEncoder()，并使用预先设置的ProductionEncoderConfig()

go 复制代码 
zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig())

（2）WriterSyncer ：指定日志将写到哪里去。我们使用zapcore.AddSync()函数并且将打开的文件句柄传进去。通过使用 AddSync 函数，可以将一个标准的 Go io.Writer 实例（比如文件、标准输出等）包装成一个符合 Zap 日志库要求的 WriteSyncer 实例

go 复制代码 
file, _ := os.Create("./test.log")
writeSyncer := zapcore.AddSync(file)

（3）Log Level：哪种级别的日志将被写入。

下面将修改上述部分中的Logger代码，主要是重写InitLogger()方法。

go 复制代码 
package main

import (
	"net/http"
	"os"

	"go.uber.org/zap"
	"go.uber.org/zap/zapcore"
)

var sugarLogger *zap.SugaredLogger

func getEncoder() zapcore.Encoder {
	return zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig())
}

func getLogWriter() zapcore.WriteSyncer {
	file, _ := os.Create("./test.log")
	return zapcore.AddSync(file)
}

// 初始化日志记录器
func InitLogger() {
	writeSyncer := getLogWriter()
	encoder := getEncoder()
	core := zapcore.NewCore(encoder, writeSyncer, zapcore.DebugLevel)

	logger := zap.New(core)
	sugarLogger = logger.Sugar()
}

// 发送 HTTP GET 请求
func httpGet(url string) {
	sugarLogger.Debugf("Trying to grt request for %s", url)
	resp, err := http.Get(url)
	if err != nil {
		// 如果请求中出现错误，记录错误日志
		sugarLogger.Error(
			"Error fetching url: ",
			zap.String("url", url),
			zap.Error(err))
	} else {
		// 如果请求成功，记录成功日志
		sugarLogger.Info(
			"Success: ",
			zap.String("statusCode", resp.Status),
			zap.String("url", url))
		resp.Body.Close()
	}
}

func main() {
	InitLogger()

	// 使用了 defer 关键字来延迟执行 logger.Sync()，以确保在程序退出前执行同步操作
	defer sugarLogger.Sync()

	httpGet("https://blog.csdn.net/Ricardo2/article/details/134253323")
	httpGet("www.google.com")
}

结果是

go 复制代码 
{"level":"debug","ts":1716607412.904807,"msg":"Trying to grt request for https://blog.csdn.net/Ricardo2/article/details/134253323"}
{"level":"info","ts":1716607415.0869148,"msg":"Success: {statusCode 15 0 200 OK <nil>} {url 15 0 https://blog.csdn.net/Ricardo2/article/details/134253323 <nil>}"}
{"level":"debug","ts":1716607415.0869148,"msg":"Trying to grt request for www.google.com"}
{"level":"error","ts":1716607415.0869148,"msg":"Error fetching url: {url 15 0 www.google.com <nil>} {error 26 0  Get \"www.google.com\": unsupported protocol scheme \"\"}"}

2.4.2 修改输出格式

NewJSONEncoder() 创建的编码器将日志事件格式化为 JSON 格式的字符串。这种格式在日志收集系统、日志分析工具等场景中通常更易于处理和解析。
NewConsoleEncoder() 创建的编码器将日志事件格式化为人类可读的文本格式，通常采用一种类似于控制台输出的格式。这种格式适合在终端中查看日志。

go 复制代码 
func getEncoder() zapcore.Encoder {
	return zapcore.NewConsoleEncoder(zap.NewProductionEncoderConfig())
}

结果是

go 复制代码 
1.7166081613816104e+09	debug	Trying to grt request for https://blog.csdn.net/Ricardo2/article/details/134253323
1.7166081620810077e+09	info	Success: {statusCode 15 0 200 OK <nil>} {url 15 0 https://blog.csdn.net/Ricardo2/article/details/134253323 <nil>}
1.7166081620810077e+09	debug	Trying to grt request for www.google.com
1.7166081620815365e+09	error	Error fetching url: {url 15 0 www.google.com <nil>} {error 26 0  Get "www.google.com": unsupported protocol scheme ""}

2.4.3 修改时间展示方式

首先要覆盖Encoder终默认的ProductionConfig()，进行手动配置：

  • 修改时间编码器
  • 在日志文件中使用大写字母记录日志级别
go 复制代码 
func getEncoder() zapcore.Encoder {
	encoderConfig := zap.NewProductionEncoderConfig()
	encoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder
	encoderConfig.EncodeLevel = zapcore.CapitalLevelEncoder
	return zapcore.NewConsoleEncoder(encoderConfig)
}

2.4.4 增加调用者函数的信息

将在zap.New(..)函数中添加一个Option。

go 复制代码 
logger := zap.New(core, zap.AddCaller())

最后，结果是

go 复制代码 
2024-05-25T11:41:42.283+0800	DEBUG	练习/main.go:37	Trying to grt request for https://blog.csdn.net/Ricardo2/article/details/134253323
2024-05-25T11:41:43.196+0800	INFO	练习/main.go:47	Success: {statusCode 15 0 200 OK <nil>} {url 15 0 https://blog.csdn.net/Ricardo2/article/details/134253323 <nil>}
2024-05-25T11:41:43.199+0800	DEBUG	练习/main.go:37	Trying to grt request for www.google.com
2024-05-25T11:41:43.199+0800	ERROR	练习/main.go:41	Error fetching url: {url 15 0 www.google.com <nil>} {error 26 0  Get "www.google.com": unsupported protocol scheme ""}

2.4.5 将日志同时输出到文件和终端

go 复制代码 
func getLogWriter() zapcore.WriteSyncer {
	file, _ := os.Create("./test.log")
	// 利用io.MultiWriter支持文件和终端两个输出目标
	ws := io.MultiWriter(file, os.Stdout)
	return zapcore.AddSync(ws)
}

2.4.6 将err日志单独输出到文件

将ERROR级别的日志单独输出到一个名为xx.err.log的日志文件中。

go 复制代码 
func InitLogger() {
	encoder := getEncoder()
	// test.log记录全量日志
	logF, _ := os.Create("./test.log")
	c1 := zapcore.NewCore(encoder, zapcore.AddSync(logF), zapcore.DebugLevel)
	// test.err.log记录ERROR级别的日志
	errF, _ := os.Create("./test.err.log")
	c2 := zapcore.NewCore(encoder, zapcore.AddSync(errF), zap.ErrorLevel)
	// 使用NewTee将c1和c2合并到core
	core := zapcore.NewTee(c1, c2)
	logger = zap.New(core, zap.AddCaller())
}
相关推荐
2401_857439692 小时前
SSM 架构下 Vue 电脑测评系统：为电脑性能评估赋能
开发语言·php
SoraLuna2 小时前
「Mac畅玩鸿蒙与硬件47」UI互动应用篇24 - 虚拟音乐控制台
开发语言·macos·ui·华为·harmonyos
xlsw_2 小时前
java全栈day20--Web后端实战(Mybatis基础2)
java·开发语言·mybatis
Dream_Snowar3 小时前
速通Python 第三节
开发语言·python
远游客07133 小时前
centos stream 8下载安装遇到的坑
linux·服务器·centos
高山我梦口香糖4 小时前
[react]searchParams转普通对象
开发语言·前端·javascript
信号处理学渣5 小时前
matlab画图，选择性显示legend标签
开发语言·matlab
红龙创客5 小时前
某狐畅游24校招-C++开发岗笔试（单选题）
开发语言·c++
jasmine s5 小时前
Pandas
开发语言·python
biomooc5 小时前
R 语言 | 绘图的文字格式(绘制上标、下标、斜体、文字标注等)
开发语言·r语言
热门推荐
01〔AI 绘画〕Stable Diffusion 之 解决绘制多人或面部很小的人物时面部崩坏问题 篇02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04DisplayPort AltMode On Type-c协议_Ver2.0(学习笔记)05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问076个主流的工业3D管道设计软件08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10树莓派 5 AI 套件（Hailo-8L）使用教程