将Golang服务日志输出到stdout并采用JSON格式，结合Fluent Bit等采集工具与Kubernetes环境对接，可实现高效统一的日志收集。1. 推荐将日志写入stdout/stderr，避免本地文件存储导致的丢失问题，便于Docker和Kubernetes通过默认日志驱动捕获。2. 使用结构化日志（如zap生成的JSON）提升可读性和检索效率，自动适配ELK、Loki等系统。3. 在K8s中部署Fluent Bit DaemonSet，从容器运行时目录读取日志，添加Pod元数据标签，实现精准路由与过滤。4. 针对多行堆栈日志，建议在应用层将错误序列化为单行JSON字段，或在采集端配置多行解析规则，确保完整性。正确设计日志输出位置、格式及采集链路，是保障容器化环境下可观测性的关键。
在容器化部署日益普及的今天，Golang服务产生的日志需要被高效、可靠地收集并统一处理。直接将日志写入文件或标准输出是常见做法，但要实现统一收集，需结合容器运行环境和日志采集系统进行合理设计。
1. 日志输出到标准输出（stdout/stderr）
容器环境下，最推荐的方式是将日志输出到 stdout 和 stderr。Docker 和 Kubernetes 默认会捕获这些输出，并通过其日志驱动转发给后端系统（如 Fluentd、Logstash、Loki 等）。
Golang 中可直接使用 log 包或更高级的日志库（如 zap、logrus）输出到控制台：
package main
import (
"log"
)
func main() {
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.Println("service started")
}
确保不将日志写入本地文件，避免因容器重启导致日志丢失，也便于采集工具统一抓取。
立即学习“go语言免费学习笔记（深入）”；
2. 使用结构化日志格式（JSON）
为方便后续解析与检索，建议使用 JSON 格式输出日志。结构化日志能被 ELK 或 Loki 等系统自动识别字段。
以 uber-go/zap 为例：
package main
import "go.uber.org/zap"
func main() {
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":1717001234.567,"msg":"http request handled","method":"GET","path":"/api/v1/users","status":200}3. 配合日志采集工具（如 Fluent Bit / Filebeat）
Kubernetes 中通常通过 DaemonSet 部署日志采集器，监听容器 stdout。例如，Fluent Bit 可配置从 Docker 的日志目录读取容器日志（/var/lib/docker/containers/*/*.log），并打上 Pod 名称、命名空间等标签。
关键点：
- 确保 Golang 应用日志是单行输出（避免多行异常堆栈干扰）
- 使用 k8s metadata filter 关联日志来源
- 为 Pod 添加合适的 label，便于过滤和路由
4. 处理多行日志（如异常堆栈）
Golang 的 panic 或 error 堆栈通常是多行文本，可能被日志系统误判为多条日志。解决方案：
- 使用 logrus 或 zap 将堆栈序列化为单行 JSON 字段
- 在采集端（如 Fluent Bit）启用多行解析模式，通过正则匹配起始行（如时间戳）合并日志
示例（zap 记录 error 堆栈）：
logger.Error("request failed", zap.Error(err))
基本上就这些。只要把日志写对地方、格式清晰、配合好采集链路，Golang 容器日志的统一收集并不复杂，但容易忽略细节影响排查效率。
