日志应输出到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）转发。
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 在容器中的日志就能被有效采集和利用。
