go-logr 和 uber 的 zap 详细程度有什么对应关系？

Question

我看到 Uber Zap 实现中有日志级别：

    const (
            // DebugLevel logs are typically voluminous, and are usually disabled in
            // production.
            DebugLevel Level = iota - 1
            // InfoLevel is the default logging priority.
            InfoLevel
            // WarnLevel logs are more important than Info, but don't need individual
            // human review.
            WarnLevel
            // ErrorLevel logs are high-priority. If an application is running smoothly,
            // it shouldn't generate any error-level logs.
            ErrorLevel
            // DPanicLevel logs are particularly important errors. In development the
            // logger panics after writing the message.
            DPanicLevel
            // PanicLevel logs a message, then panics.
            PanicLevel
            // FatalLevel logs a message, then calls os.Exit(1).
            FatalLevel
        ) 

当我在 sigs.k8s.io/controller-runtime/pkg/log/zap 记录器中设置级别时使用它，它在引擎盖下使用 go-logr：

func determineLogLevel(verbosityLevel string) zapcore.Level {
    var zapLevel zapcore.Level
    verbosityLevel = strings.ToLower(verbosityLevel)
    switch verbosityLevel {
    case ERROR:
        zapLevel = zapcore.ErrorLevel
    case WARNING:
        zapLevel = zapcore.WarnLevel
    case INFO:
        zapLevel = zapcore.InfoLevel
    case DEBUG:
        zapLevel = zapcore.DebugLevel
    default:
        zapLevel = zapcore.InfoLevel
    }
    return zapLevel
}

// here zap is "sigs.k8s.io/controller-runtime/pkg/log/zap"
opts := zap.Options{
    StacktraceLevel: ... ,
    Level:           determineLogLevel("ERROR"),
    Encoder:         ... ,
    ZapOpts:         ...,
}

但也可以选择使用logr.Logger.V。

这里的level值和Uber Zap的常量一样吗？ (DebugLevel, InfoLevel, WarnLevel, ....)

我也看到了：

flag --zap-log-level：Zap 级别，用于配置日志记录的详细程度。可以是“调试”、“信息”、“错误”或任何大于 0 的整数值之一，对应于增加详细程度的自定义调试级别”

此标志值是否与sigs.k8s.io 的zap.Options 中的zapcore.Level 相同？

logr.Logger.V 的文档

    // V returns an Logger value for a specific verbosity level, relative to
    // this Logger.  In other words, V values are additive.  V higher verbosity
    // level means a log message is less important.  It's illegal to pass a log
    // level less than zero.
    V(level int) Logger

Answer 1

go-logr和go.uber.org/zap日志级别的对应关系如下：

zapLevel = -1 * logrLevel

换句话说，go-logr 级别是zap 级别的逆。此信息可在 go-logr/zapr 包文档中找到：

logr 中的级别对应于 Zap 中的自定义调试级别。 logr 中的任何给定级别都由其在 zap (zapLevel = -1*logrLevel) 中的倒数表示。例如 V(2) 相当于 Zap 中的日志级别 -2，而 V(1) 相当于 Zap 的 DebugLevel。

您还可以通过查看zapr 包的logr.Logger.V 实现来查看关卡如何初始化的具体示例：

func (zl *zapLogger) V(level int) logr.Logger {
    return &zapLogger{
        lvl: zl.lvl - zapcore.Level(level),
        l:   zl.l,
    }
}

方法zapr.NewLogger 构造了一个zapr.zapLogger，其中lvl 字段设置为zap.InfoLevel（你知道它是0），所以每次你在这个实现上调用V，它都会减去给定的int值，从而得到它的负数。

---

--zap-log-level 标志从命令行（或 k8s yaml 配置）传递的字符串值映射到 Uber Zap 的级别，基于此：

var levelStrings = map[string]zapcore.Level{
    "debug": zap.DebugLevel,
    "info":  zap.InfoLevel,
    "error": zap.ErrorLevel,
}

然后将数值乘以-1，然后设置为logr.Logger 实现，如上面引用的文档所要求的那样。