17370845950

使用结构化日志库如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：

{"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服务的日志就能轻松接入各类可观测性系统。不复杂但容易忽略。