使用结构化日志库如zap、zerolog实现Golang应用日志标准化，输出JSON格式日志，统一字段命名规范，集成K8s环境元数据，动态调整日志级别，确保日志输出到stdout并避免敏感信息泄露。
在Golang开发的容器化应用中，日志是排查问题、监控服务状态的重要手段。但若日志格式混乱、缺少关键信息，会给运维和日志系统解析带来很大困难。实现日志标准化，不仅能提升可读性，还能让ELK、Loki等日志系统更高效地采集和分析。
统一使用结构化日志
避免使用fmt.Println或简单的log包输出非结构化文本。推荐使用支持JSON格式输出的结构化日志库：
- uber-go/zap：高性能、结构化强，适合生产环境
- rs/zerolog：轻量级，API简洁，原生支持JSON
- sirupsen/logrus：功能丰富，插件多，但性能略低
示例（zap）：
logger, _ := zap.NewProduction()
defer logger.Sync()
logger.Info("请求处理完成",
zap.String("method", "GET"),
zap.String("path", "/api/users"),
zap.Int("status", 200),
zap.Duration("duration", 150*time.Millisecond),
)
输出为标准JSON：
立即学习“go语言免费学习笔记（深入）”；
{"level":"info","ts":1712345678.123,"msg":"请求处理完成","method":"GET","path":"/api/users","status":200,"duration":150000000}
定义通用日志字段规范
为保证不同服务日志字段一致，建议制定团队级日志字段命名规范。常见关键字段包括：
- level：日志级别（info、warn、error、debug）
- ts 或 time：时间戳，建议使用ISO8601或Unix时间戳
- msg：简要描述信息
- trace_id / request_id：用于链路追踪
- service.name：服务名称
- container.id 或 pod.name：运行实例标识（K8s环境）
- caller：记录日志的文件和行号
可在初始化Logger时注入服务名、版本等静态字段：
logger = logger.With(
zap.String("service.name", "user-service"),
zap.String("service.version", "v1.2.0"),
)
与容器运行环境集成
Kubernetes等平台默认采集容器stdout/stderr日志。Golang应用应将日志输出到标准输出，而非写入本地文件。
- 禁用日志文件写入，除非特殊审计需求
- 确保日志编码为UTF-8，避免乱码
- 避免在日志中输出敏感信息（密码、token等），可通过中间件过滤
- 结合K8s downward API注入pod_name、namespace等元数据
示例：通过环境变量注入Pod信息
os.Setenv("POD_NAME", os.Getenv("HOSTNAME"))
logger = logger.With(zap.String("pod.name", os.Getenv("POD_NAME")))
配置日志级别动态调整
生产环境中不应默认开启debug日志。建议支持通过环境变量或信号动态调整日志级别。
- 使用zap.AtomicLevel实现运行时级别切换
- 监听SIGHUP或HTTP接口触发重载
- 开发环境设为debug，生产环境默认info
示例：
atomicLevel := zap.NewAtomicLevel() atomicLevel.SetLevel(zap.InfoLevel) logger := zap.New(zap.NewCore(...), zap.IncreaseLevel(atomicLevel)) // 接收信号后：atomicLevel.SetLevel(zap.DebugLevel)
基本上就这些。核心是结构化输出、字段统一、与容器平台协作。只要坚持使用结构化日志库并规范字段，Golang服务的日志就能轻松接入各类可观测性系统。不复杂但容易忽略。
