如何在Golang中处理容器化服务日志_Golang容器日志管理与收集-Golang

Go服务应将日志输出到stdout/stderr而非文件，因容器运行时仅捕获标准流以对接日志驱动；写文件会绕过采集链路、引发竞态、脱离生命周期管理且不被K8s日志后端支持。

Go 服务在容器中默认将日志输出到 stdout 和 stderr，这是最佳实践；直接写文件或轮转日志反而会破坏容器日志采集链路。

为什么不能在 Go 程序里自己轮转日志文件

容器运行时（如 Docker、containerd）只捕获进程的 stdout/stderr 流，并转发给日志驱动（json-file、syslog、fluentd 等）。一旦 Go 程序用 os.OpenFile 写本地文件：

• 该文件不在容器日志路径下，docker logs 完全看不到
• 多个副本共享挂载卷时，多进程写同一文件易导致内容错乱或丢失
• 日志生命周期脱离容器管理，无法自动清理、压缩、归档
• K8s 的 ClusterLogging 或 Loki 等后端通常只对接标准流，不拉取容器内任意路径的文件

用 log 包 + os.Stdout 输出结构化日志

Go 标准 log 包本身不支持 JSON，但可轻松封装成结构化输出。关键不是“用什么库”，而是“输出到哪里”和“格式是否可解析”：

import (
    "encoding/json"
    "log"
    "os"
    "time"
)

type LogEntry struct {
    Time  time.Time `json:"time"`
    Level string    `json:"level"`
    Msg   string    `json:"msg"`
    Data  map[string]interface{} `json:"data,omitempty"`
}

func main() {
    // 直接写到 stdout，不加缓冲、不重定向
    log.SetOutput(os.Stdout)
    log.SetFlags(0) // 关闭默认时间戳等，由我们自己控制

    entry := LogEntry{
        Time:  time.Now(),
        Level: "info",
        Msg:   "service started",
        Data:  map[string]interface{}{"port": 8080},
    }
    enc := json.NewEncoder(os.Stdout)
    enc.Encode(entry) // 输出一行 JSON，方便 fluentd / vector 解析
}

• 每条日志必须是单行 JSON（换行分隔），否则日志采集器会解析失败
• 避免在 enc.Encode() 前/后额外打印空行或前缀（比如 log.Println 混用）
• 不要调用 log.SetPrefix 或 log.SetFlags，它们会污染 JSON 格式

使用 zerolog 或 zap 时的容器适配要点

第三方日志库更高效，但需显式配置输出目标与格式：