Go语言logr包V级别理解与配置方法咨询

我已做过相关研究但仍未理清，以下是logr文档内容：

通常我们希望仅在应用处于“verbose模式”时记录信息。要编写更详细的日志行，Logger提供V()方法。日志行的V级别越高，其重要性越低。未启用的V级别日志行（根据LogSink设置）将不会被记录。V(0)是默认级别，logger.V(0).Info()与logger.Info()含义相同。负V级别与V(0)含义一致。错误消息无verbosity级别，始终会被记录。
原本我们可能会这样写：

if flVerbose >= 2 {
log.Printf("an unusual thing happened")
}

现在我们可以这样写：

logger.V(2).Info("an unusual thing happened")

我的理解是logger.V(2).Info("an unusual thing happened")仅会在当前verbosity级别设置为2或更高时打印。在if flVerbose >= 2 { log.Printf("an unusual thing happened") }的场景中，显然需要在代码某处将flVerbose设置为2或更高，但使用logr的V级别时，该如何设置verbosity级别？或者我是否完全误解了上述文档？

你的理解是正确的：logger.V(k).Info(...)确实仅在当前启用的verbosity级别≥k时才会输出日志。

logr是一个抽象的日志接口，本身并不直接提供全局设置verbosity级别的方法，verbosity级别的控制由底层的LogSink实现负责，不同的logr适配后端（比如zapr、klogr）有不同的配置方式，以下是常见场景的设置方法：

1. 使用zapr（zap日志的logr适配器） #

zapr中，logr的V级别与zap的日志级别对应：V(k)对应zap的Level(-k)。要启用V(2)及以下的日志，需要将zap的日志级别设置为zap.Level(-2)，示例代码：

import (
  "go.uber.org/zap"
  "github.com/go-logr/zapr"
)

func main() {
  // 创建zap配置并设置级别
  zapCfg := zap.NewProductionConfig()
  // 允许V(2)及以下的日志，对应zap级别为-2
  zapCfg.Level.SetLevel(zap.Level(-2))
  
  zapLogger, err := zapCfg.Build()
  if err != nil {
    panic(err)
  }
  // 基于zapLogger创建logr实例
  logger := zapr.NewLogger(zapLogger)
  
  // 此时V(2).Info会输出，V(3).Info不会输出
  logger.V(2).Info("an unusual thing happened")
}

2. 使用klogr（klog日志的logr适配器） #

klogr的verbosity级别直接复用klog的全局配置，通常通过命令行参数-v设置：

• 启动程序时添加-v=2，即可启用V(2)及以下的日志
• 代码中创建logger时无需额外配置，直接使用：

import "github.com/go-logr/klogr"

func main() {
  logger := klogr.New()
  logger.V(2).Info("an unusual thing happened")
}

3. 自定义LogSink实现 #

如果自己实现LogSink接口，需要在Enabled(level int)方法中判断是否允许该V级别日志，示例：

import "github.com/go-logr/logr"

type MyLogSink struct {
  maxVerbosity int
}

// Enabled判断是否启用指定V级别
func (s *MyLogSink) Enabled(level int) bool {
  return level <= s.maxVerbosity
}

// 实现LogSink的其他方法（Info、Error等）
func (s *MyLogSink) Info(level int, msg string, keysAndValues ...interface{}) {
  // 日志输出逻辑
}

func (s *MyLogSink) Error(err error, msg string, keysAndValues ...interface{}) {
  // 错误日志输出逻辑
}

func main() {
  // 创建自定义Sink，设置最大允许V级别为2
  sink := &MyLogSink{maxVerbosity: 2}
  logger := logr.New(sink)
  
  logger.V(2).Info("an unusual thing happened") // 会输出
  logger.V(3).Info("a very rare thing happened") // 不会输出
}

总结：logr的V级别控制核心是底层LogSink的Enabled方法，不同实现的配置方式不同，本质都是设置一个最大允许的V级别阈值，超过该阈值的日志会被过滤。

内容的提问来源于stack exchange，提问作者user2810081