日志应输出到stdout/stderr并采用jsON格式，由外部系统采集。使用zap等库生成结构化日志，通过环境变量控制级别，配合kubernetes或docker日志驱动实现集中收集与分析。

在容器化环境中，golang 程序的日志采集与输出需要遵循一些最佳实践，以确保日志能被正确收集、分析和监控。核心原则是：将日志直接输出到标准输出（stdout）和标准错误（stderr），由外部日志系统统一采集。

使用 stdout/stderr 输出日志

容器环境下不建议将日志写入本地文件，因为文件难以持久化且不利于集中管理。正确的做法是让 golang 应用将日志打印到控制台。

关键点：

• 所有日志通过 log.Println、log.printf 或结构化日志库（如 zap、logrus）输出到 stdout/stderr
• 避免使用 os.Open 创建日志文件，除非有特殊归档需求
• 错误日志应使用 stderr，例如 log.New(os.Stderr, “”, log.LstdFlags)

采用结构化日志格式

纯文本日志不利于解析。推荐使用 json 格式的结构化日志，便于 elk、Loki 等系统提取字段。

示例（使用 uber-go/zap）：

立即学习“go语言免费学习笔记（深入）”；

logger, _ := zap.NewProduction() defer logger.Sync() logger.Info("http request handled",     zap.String("method", "GET"),     zap.String("path", "/api/v1/users"),     zap.Int("status", 200), ) 

输出示例：

{"level":"info","ts":1710893421.123,"caller":"main.go:45","msg":"http request handled","method":"GET","path":"/api/v1/users","status":200} 

配合 Docker 和 Kubernetes 日志驱动

Docker 默认会捕获容器的 stdout/stderr 并通过配置的日志驱动（如 json-file、fluentd、syslog）转发。

集简云

软件集成平台，快速建立企业自动化与智能化

22

查看详情

Kubernetes 中，kubelet 会自动读取容器日志文件（位于 /var/log/containers/），前提是日志输出到控制台。

• 确保 Pod 的日志路径可被节点上的日志采集器（如 fluent-bit、filebeat）读取
• 可通过 sidecar 模式部署日志收集容器，专门挂载并转发日志
• 设置合理的日志轮转策略，防止占用过多磁盘空间

环境区分与日志级别控制

通过环境变量控制日志级别，避免生产环境输出过多调试信息。

示例：

logLevel := os.Getenv("LOG_LEVEL") if logLevel == "" {     logLevel = "info" } // 使用 zap 等库动态设置级别 

部署时通过 YAML 配置：

env: - name: LOG_LEVEL   value: "warn" 

基本上就这些。只要保证日志输出到 stdout/stderr、使用结构化格式、配合平台日志机制，Golang 在容器中的日志就能被有效采集和利用。