Go 1.21.0 中新增的结构化日志记录标准库 log/slog 详解

开发 前端
本文我们介绍 log/slog 的使用方式,包括日志级别和输出日志格式。限于篇幅,还有一些进阶用法没有介绍,比如 LogAttrs​ 函数,以及 NewTextHandler​ 和 NewJSONHandler 的方法。

01 、介绍

在 Go 语言项目开发中,我们通常需要查看日志来调试程序,所以日志的快捷搜索和过滤就会至关重要。

因为 Go 标准库中的 log,它不是结构化日志格式,使用上并不方便,所以在 Go 1.21.0 中,Go 标准库新增结构化日志记录包 log/slog,它支持键值对格式。

本文我们介绍 log/slog 的使用方式。

02、log/slog 使用方式

log/slog 的默认 logger 使用的是 log 的默认 logger,新增日志包 log/slog 和原始日志包 log 协同工作,使 log/slog 更易上手。

日志级别

log/slog 日志级别包括 Info、Debug、Warn 和 Error,log/slog 为它们分别提供了函数。

示例代码:

func main() {
 log.Println("This is log")
 slog.Debug("This is Debug Level")
 slog.Info("This is Info Level")
 slog.Warn("This is Warn Level")
 slog.Error("This is Error Level")
}

输出结果:

2023/10/06 11:18:04 This is log
2023/10/06 11:18:04 INFO This is Info Level
2023/10/06 11:18:04 WARN This is Warn Level
2023/10/06 11:18:04 ERROR This is Error Level

阅读上面这段代码,我们可以发现 log/slog 的输出结果和 log 的输出结果非常相似,只是在日志时间和日志消息之间多了日志级别。

因为 log/slog 的默认 logger 使用的是 log 的默认 logger。

除了上述 4 个不同日志级别的函数之外,还有一个函数 log,我们可以使用 log 函数替代上述 4 个函数。

示例代码:

func main() {
 slog.Log(context.Background(), -4, "This is Debug Level")
 slog.Log(context.Background(), 0, "This is Info Level")
 slog.Log(context.Background(), 4, "This is Warn Level")
 slog.Log(context.Background(), 8, "This is Error Level")
}

输出结果:

2023/10/06 11:41:47 INFO This is Info Level
2023/10/06 11:41:47 WARN This is Warn Level
2023/10/06 11:41:47 ERROR This is Error Level

阅读上面这段代码,我们可以发现,log 函数通过参数定义日志级别,数字越大,级别越严重,并且不同级别之间,预留 4 个数字,我们可以定义其他日志级别。

log 函数与 4 个分别代表不同级别的函数之间,还有另外一个区别,它的第一参数是上下文,其实 4 个分别代表不同级别的函数也对应 4 个支持第一个参数是上下文的函数,分别是 InfoContext()、DebugContext()、WarnContext() 和 ErrorContext。

细心的读者朋友们可能发现了,为什么输出结果没有 Debug 级别的日志输出?

因为  log/slog 的默认 logger 的默认日志级别是 Info,如果我们想要使用日志级别 Debug,可以新建 logger,并把默认日志级别设置为 Debug。

键值对

前面我们已经说过 log/slog 支持键值对格式,但是上述示例代码中并没有体现,接下来,我们以 Info 函数为例,介绍 log/slog 怎么输出键值对格式。

func main() {
 slog.Info("This is Info Level", "uid", 1001)
}

输出结果:

2023/10/06 11:58:07 INFO This is Info Level uid=1001

阅读上面这段代码,我们发现 Info 函数中,在日志消息之后新增两个参数,分别是 uid 和 1001,它们就是键值对的 key 和 value。

Logger 修改输出日志格式

因为 log/slog 默认使用 log 的默认 logger,所以输出格式就是我们上面看到的文本格式。

我们可以使用内置的 Handler NewTextHandler 和 NewJSONHandler创建新的 Logger,来输出新文本格式和 json 格式。

示例代码:

func main() {
 logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
 logger.Info("This is a new text Info Level", "uid", 1002)

 jsonLogger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
 jsonLogger.Info("This is a json format Info Level", "uid", 1003)
}

输出结果:

time=2023-10-06T12:19:21.676+08:00 level=INFO msg="This is a new text Info Level" uid=1002
{"time":"2023-10-06T12:19:21.676846+08:00","level":"INFO","msg":"This is a json format Info Level","uid":1003}

阅读上面这段代码,我们可以发现通过内置 Handler 创建新的 Logger,输出新的日志格式,其中 NewTextHandler 输出的所有内容都是键值对格式,NewJSONHandler 输出一个 json 对象。

此外,我们还可以自定义 Handler,通过实现 slog.Handler 接口,生成特定的输出日志格式或者 wrap 另一个 Handler 来丰富其功能。

03 、总结

本文我们介绍 log/slog 的使用方式,包括日志级别和输出日志格式。

限于篇幅,还有一些进阶用法没有介绍,比如 LogAttrs 函数,以及 NewTextHandler 和 NewJSONHandler 的方法。

责任编辑:武晓燕 来源: Golang语言开发栈
相关推荐

2023-09-27 08:26:48

Go标准库函数

2024-03-01 01:25:40

结构化日志可读性

2024-02-01 13:30:53

Go语言开发

2011-03-01 09:39:51

结构化布线

2009-10-15 13:49:23

结构化布线系统

2016-01-22 12:36:51

TAXII威胁情报安全威胁情报

2023-04-02 23:13:07

Go语言bufio

2021-12-12 08:37:18

结构化数据非结构化数据数据

2018-04-03 14:00:03

结构化数据非结构化数据数据库

2009-10-15 11:46:36

结构化综合布线系统

2019-07-13 15:00:17

结构化SQLNOSQL数据库

2023-12-25 15:00:18

结构化布线光纤

2010-01-13 13:20:08

VB.NET结构化异常

2012-02-08 15:54:05

ibmdw

2021-12-29 10:51:19

JavaSPL架构

2009-10-14 09:27:15

结构化综合布线

2011-02-28 13:55:00

结构化布线

2009-10-09 17:57:20

结构化布线

2011-03-01 13:59:43

结构化

2017-05-16 21:31:03

结构化数据新模式
点赞
收藏

51CTO技术栈公众号