Golang应用在容器化部署中应输出结构化日志到stdout，由容器运行时（如Docker json-file驱动）和采集Agent（如Fluent Bit）完成收集，结合请求ID实现链路追踪，实现集中化、可扩展的日志管理。
在容器化部署 Golang 应用时，日志的集中收集是可观测性建设的关键环节。传统的文件写入方式不再适用，必须结合容器环境的日志机制与平台能力进行统一管理。核心思路是：应用只负责输出日志到标准输出（stdout/stderr），由容器运行时和日志采集系统完成后续的收集、传输与存储。
1. Golang 应用日志输出规范
为适配容器环境，Golang 服务应避免直接写本地日志文件。推荐使用结构化日志库，如 logrus 或 zap，并将日志格式设为 JSON，便于后续解析。
示例（使用 zap）：
logger, _ := zap.NewProduction()
defer logger.Sync()
logger.Info("http request handled",
zap.String("method", "GET"),
zap.String("path", "/api/v1/user"),
zap.Int("status", 200),
)
确保所有日志都输出到 stdout/stderr，不要重定向到文件。Kubernetes 等平台默认会捕获容器的标准输出并写入日志文件（如 /var/log/containers/ 下），这是实现集中收集的基础。
立即学习“go语言免费学习笔记（深入）”；
2. 容器运行时日志驱动配置
Docker 支持多种日志驱动，推荐使用默认的 json-file 驱动，它将 stdout 输出按行记录为 JSON 格式，每条包含时间戳、流类型和内容。
可在 docker run 时指定：
--log-driver=json-file --log-opt max-size=100m --log-opt max-file=3
限制日志大小防止磁盘打满。若使用 Kubernetes，该配置通常在节点级统一设置。
3. 日志采集 Agent 部署
在集群每个节点部署日志采集组件，常用方案包括：
- Fluent Bit：轻量高效，适合 Kubernetes，常以 DaemonSet 方式运行，读取容器日志文件并转发至后端
- Filebeat：Elastic 生态组件，可监控日志目录并发送到 Logstash 或 Elasticsearch
- Logtail（阿里云）、Cloud Logging Agent（GCP）：云厂商提供的一体化方案
以 Fluent Bit 为例，配置其输入源为容器日志路径（如 /var/log/containers/*.log），过滤识别 Golang 应用标签，解析 JSON 内容，并输出到 Elasticsearch、Kafka 或 Loki。
4. 结合上下文增强日志可追溯性
单一日志条目信息有限，需通过字段关联请求链路。建议在 Golang 中引入全局唯一请求 ID（如 X-Request-ID），并在处理过程中透传。
中间件示例：
func RequestIDMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
rid := r.Header.Get("X-Request-ID")
if rid == "" {
rid = uuid.New().String()
}
ctx := context.WithValue(r.Context(), "request_id", rid)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
日志中打印 request_id，可在 Kibana 或 Grafana 中按 ID 聚合查看完整调用流程。
基本上就这些。关键是让 Golang 应用保持“无状态日志输出”，把收集、归集、存储交给平台层处理，才能实现高可用、易扩展的日志管理体系。
