Go标准库log包无内置级别,需用zerolog或zap;推荐zerolog,初始化设时间戳和级别字段,输出到stdout/stderr;禁写文件,用LevelParameter注入level字段供Fluent Bit分流;关Caller/Stack避免性能损耗。
log 包不行,得换 zap 或 zerolog
标准库 log 包没有内置级别(INFO/WARN/ERROR),只能靠手动拼接前缀,没法过滤、没法结构化。真要分级,必须引入第三方日志库。zap 性能高、生态稳,zerolog 零分配、API 直观——两者都支持字段注入、输出到文件/网络、按级别切分日志文件。
推荐起步用 zerolog,初始化简单:
import "github.com/rs/zerolog/log"func main() { // 输出到 stdout,带时间戳和级别 log.Logger = log.With().Timestamp().Logger()
log.Info().Str("service", "api").Int("attempts", 3).Msg("request processed") log.Warn().Str("reason", "timeout").Int("code", 408).Msg("upstream slow") log.Error().Err(err).Str("path", "/v1/users").Msg("failed to fetch")}
注意:
zerolog默认不打印级别字段,需显式开启:zerolog.SetGlobalLevel(zerolog.InfoLevel),否则Warn()/Error()调用会被静默丢弃。立即学习“go语言免费学习笔记(深入)”;
容器里日志写哪?别写文件,直接 stdout/stderr
Kubernetes 和 Docker 默认把
stdout和stderr当成日志源采集。一旦你用os写本地文件,日志就脱离平台管控:查不到、收不走、没法轮转、无法对接 Loki 或 ELK。.OpenFile
log.Info().Msg(...) 这类调用,底层输出到 os.Stdout 或 os.Stderr
zerolog 默认输出到 os.Stderr;若想 INFO 以上进 stdout、ERROR 进 stderr,需自定义 zerolog.ConsoleWriter 并做 level 分流/var/log/myapp/ 这类路径——容器里这目录可能不存在,或只读,或重启即丢zerolog.LevelParameter + JSON 解析原生 zerolog 不支持“不同级别写不同输出”,但你可以用 LevelParameter 把级别塞进日志对象,再靠外部工具(如 Fluent Bit、Vector)做路由:
import (
"github.com/rs/zerolog"
"os"
)
func init() {
// 将 level 字段注入每条日志
zerolog.LevelFieldName = "level"
zerolog.LevelFieldMarshalFunc = func(l zerolog.Level) string {
return strings.ToLower(l.String())
}
log.Logger = zerolog.New(os.Stdout).With().Timestamp().Logger()
}
这样每条日志都是标准 JSON,含 "level":"info" 字段。Fluent Bit 配置可按此字段拆流:
[FILTER]
Name kubernetes
Match kube.*
Merge_Log On
[FILTER]
Name grep
Match *
Regex level error|warn
别试图在 Go 进程内开 goroutine 分别写两个 io.Writer——容易阻塞、难同步、违反 12-factor 原则。
开发时喜欢加 .Caller() 或 .Stack(),但在容器里这是性能杀手:每次打日志都做运行时反射、获取调用栈、序列化字符串。线上环境务必关掉:
zerolog.CallerSkipFrame 设为 0(默认已关).Stack(),错误信息用 .Err(err) 即可,zerolog 会自动展开 error 接口,不触发完整栈追踪log.Debug().Caller().Msg("..."),但全局设 zerolog.SetGlobalLevel(zerolog.InfoLevel),确保 Debug 不生效真正影响容器稳定性的,往往不是日志内容本身,而是日志生成时的 CPU 和内存开销——尤其高频 INFO 日志混着 Caller,QPS 上千时 GC 压力会明显上升。