Golang 结构化日志包 log/slog 详解(三):属性字段和日志级别

上一篇文章讲解了 log/slog 包中的 Handler 的使用方法,通过不同的 Handler 可以输出不同格式的日志。接下来看一下如何自定义日志的属性字段和日志级别。

属性字段(attribute)

许多日志都有一些通用的的字段,例如日志级别 level、日志记录时间 time、日志信息 msg 等,这些字段就是属性字段。log/slog 包自带了有属性字段的日志输出功能,而不需要自己在日志内容里面添加。可以通过 With 函数来设置属性字段,看个简单的例子:

复制代码
package main

import "log/slog"

func main() {
	logger := slog.With("host", "xxx.com")
	logger.Info("hello", "标题", "路多辛的博客")
}

运行看下效果:

复制代码
2023/09/12 21:11:35 INFO hello host=xxx.com 标题=路多辛的博客

可以看到输出的日志里面有了 host 字段。With 函数的参数会以键值对的形式出现在日志中,返回一个新的 Logger,使用新的 Logger 输出日志时,每次输出中都会出现新增的属性字段。log/slog 包内置的几个属性字段如下:

  • time,日志记录时间
  • level,日志级别
  • msg,日志信息
  • source,源文件信息

日志级别(Levels)

slog.Level 是整数类型,表示日志记录的事件的重要程度或严重程度。级别越高,事件越严重。log/slog 包定义了如下几个常用的级别:

复制代码
const (
    LevelDebug Level = -4
    LevelInfo  Level = 0
    LevelWarn  Level = 4
    LevelError Level = 8
)

在应用程序中,一般只记录某个级别或更高级别的日志。常用的做法是在非生产环境将日志设置为 Info 级别,在生产环境将日志设置为 Warn 或者 Error 级别,并且可以通过配置文件动态调整日志级别,遇到比较难以排查的问题时,临时将日志设置为 Debug 级别,定位到问题后再调整回去。

内置的 Handler 可以通过通过 HandlerOptions.Level 参数来设置日志级别,默认为 Info 级别。要动态地改变整个程序的级别,首先需要初始化一个全局的 LevelVar,然后使用 LevelVar 来构造一个 Handler,并将其设为默认值,示例代码如下:

复制代码
package main

import (
	"log/slog"
	"os"
)

func main() {
	var programLevel = new(slog.LevelVar)
	h := slog.NewJSONHandler(os.Stderr, &slog.HandlerOptions{Level: programLevel})
	slog.SetDefault(slog.New(h))
	slog.Debug("hello", "标题", "路多辛的博客")
}

运行代码,是不会输出任何内容的,因为日志级别设置的是 Info,所以不会输出 Debug 级别的日志。更改日志级别为 Debug 后,再使用 Debug 函数输出一次:

复制代码
package main

import (
	"log/slog"
	"os"
)

func main() {
	var programLevel = new(slog.LevelVar)
	h := slog.NewJSONHandler(os.Stderr, &slog.HandlerOptions{Level: programLevel})
	slog.SetDefault(slog.New(h))
	slog.Debug("hello", "标题", "路多辛的博客")

	programLevel.Set(slog.LevelDebug)
	slog.Debug("hello2", "标题2", "路多辛的博客")
}

运行代码,输入了如下内容:

复制代码
{"time":"2023-09-12T21:41:59.960653+08:00","level":"DEBUG","msg":"hello2","标题2":"路多辛的博客"}

可以看出,日志级别被成功更改为了 Debug 并输出了相关日志。

相关推荐
码事漫谈6 小时前
以后人人都可以成为导演
后端
Resean02236 小时前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿6 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
ShineWinsu7 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
北城笑笑8 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
ServBay8 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho9 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
张一凡9310 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员10 小时前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan10 小时前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员