Go应用日志接入核心是规范输出：结构化JSON到stdout、禁用console格式、避免手动拼接和本地文件，统一trace_id与字段命名，采集端按规模选Fluent Bit+Loki或Filebeat+Elasticsearch。
Go 应用接入日志收集系统，核心不是“怎么连”，而是“怎么输出才让采集器能稳定、准确、高效地收”。只要日志格式结构化、输出目标明确（stdout 或指定文件）、上下文字段统一，90% 的采集链路问题就已规避。
用 zap 或 logrus 输出 JSON 到 stdout 是最稳起点
容器/K8s 环境下，docker logs 和 kubectl logs 本质就是读取 stdout/stderr。采集器（如 Fluent Bit、Filebeat、Promtail）也默认监听这些流。非结构化文本（比如 log.Printf）会让后续解析失败或字段丢失。
-
zap.NewProduction()默认输出 JSON，带ts、level、caller、msg字段，开箱即用 -
logrus.SetFormatter(&logrus.JSONFormatter{})同样可靠，适合已有 logrus 生态的项目 - 务必禁用 console 格式（如
logrus.TextFormatter），它在容器里会破坏多行日志合并逻辑 - 避免手动拼接字符串：
logger.Info("user " + uid + " failed")→ 丢失结构，应改用字段：logger.WithField("user_id", uid).Error("login failed")
别写本地文件，除非你真需要落盘且能管控生命周期
在容器中写 /app/logs/app.log 是典型反模式：容器重启日志即丢；挂载卷增加运维负担；采集器需额外配置路径和权限；多副本时日志分散难聚合。
- K8s 场景下，让采集器通过
hostPath或symlink读取/var/log/pods/...下的容器 stdout 文件 —— 这是 Kubelet 自动做的，无需应用干预 - 若必须落盘（如离线环境），用
lumberjack控制滚动：lumberjack.Logger{Filename: "/var/log/myapp.json", MaxSize: 100, MaxBackups: 7}，并确保目录可写、权限匹配 - 写文件时若未设
os.O_APPEND | os.O_CREATE，可能覆盖旧日志；未调用Sync()可能丢最后几条
采集端选型取决于你的后端存储和团队能力
不是越重越好，而是看日志量、查询需求、基础设施成熟度。常见组合中，Fluent Bit + Loki 和 Filebeat + Elasticsearch 覆盖了绝大多数场景。
立即学习“go语言免费学习笔记（深入）”；
-
Fluent Bit（K8s DaemonSet）+Loki：轻量、按标签索引、与Prometheus共享 Grafana，适合中小规模云原生团队；注意__path__配置要匹配容器日志路径，否则 Promtail 找不到文件 -
Filebeat（主机级部署）+Elasticsearch：全文检索强、支持复杂过滤（如 grok），但 ES 内存和磁盘压力大；若用json.keys_under_root: true，必须确保 Go 日志是合法 JSON，否则 Filebeat 会跳过整行 - 直接用 Docker
--log-driver=fluentd：省去应用内采集器，但要求 Fluentd 服务高可用；tag参数建议包含服务名和环境，如golang-api-prod，方便后端路由
加 trace_id 和 request_id 是微服务日志可查性的分水岭
没有唯一请求标识的日志，在跨服务调用中等于无源之水。单靠时间戳对齐误差大，且无法区分并发请求。
- 在 HTTP 中间件生成
trace_id（如uuid.New().String()），注入到context.Context并透传 - 所有日志调用都显式带上该字段：
logger.With(zap.String("trace_id", traceID)).Info("request started") - 若已用 OpenTelemetry，优先从
trace.SpanFromContext(r.Context()).SpanContext().TraceID()提取，保证与链路追踪 ID 一致 - 切忌把
trace_id拼进msg字段（如"[trace:abc] user login"），这会让结构化解析失效
最容易被忽略的一点：日志字段命名不统一。一个服务用 user_id，另一个用 uid，再一个用 userId，会导致 Grafana/Loki 查询时反复试错。建议团队约定基础字段集（service、env、trace_id、span_id、http_method、http_status），并在日志库封装层做标准化注入。
