log包直接写文件不适合微服务日志收集，因其无法应对多实例、动态调度、分散节点等场景，导致日志丢失、难聚合检索，且缺乏结构化、上下文追踪及标准对接能力。
为什么 log 包直接写文件不适合微服务日志收集
微服务场景下，单机多实例、容器动态调度、日志分散在不同节点，用标准 log 包写本地文件会导致日志丢失、无法聚合、检索困难。它不支持结构化输出、无上下文追踪（如 trace_id）、无法对接 Fluentd/Filebeat 或云原生日志系统（如 Loki、ELK）。更关键的是，log.Printf 默认不带时间戳精度、不区分 level 字段，后续做告警或分析时得靠正则硬解析——错一个空格就崩。
用 zap 输出 JSON 并接入 Filebeat 的最小可行配置
zap 是 Go 生态最主流的高性能结构化日志库，它的 ProductionConfig 默认输出 JSON，字段名固定（如 "level"、"ts"、"msg"），Filebeat 可直接解析。重点不是“怎么装 zap”，而是怎么避免踩坑：
- 别用
zap.NewDevelopment()上生产——它输出带颜色的非 JSON 格式，Filebeat 会解析失败 - 必须调用
logger.Sync()在进程退出前刷盘，否则 k8s pod 重启时日志丢失 - 把 trace_id、service_name、host 等作为
zap.String()字段显式注入，别依赖中间件自动加（容易漏） - Filebeat 配置里
json.keys_under_root: true必须开，否则字段全包在json.下层
package main
import (
"go.uber.org/zap"
"go.uber.org/zap/zapcore"
)
func main() {
cfg := zap.NewProductionConfig()
cfg.OutputPaths = []string{"/var/log/my-service/app.log"} // 确保目录存在且可写
cfg.ErrorOutputPaths = []string{"/var/log/my-service/error.log"}
logger, _ := cfg.Build()
defer logger.Sync() // 关键：防止日志未刷盘
logger.Info("service started",
zap.String("service_name", "order-api"),
zap.String("trace_id", "abc123"),
zap.String("host", "pod-7f8d9a"))
}
如何让多个微服务日志共用一个 trace_id 进行串联
HTTP 请求跨服务时，靠 header 透传 trace_id 最可靠。不要自己拼字符串或用全局变量存——goroutine 不安全。正确做法是用 context.Context 携带，并在每层日志中显式提取：
- 入口处从
r.Header.Get("X-Trace-ID")读取，若为空则生成新 ID（如用google.uuid.New().String()） - 用
context.WithValue(ctx, keyTraceID, traceID)注入 context - 下游调用 HTTP 时，把该
trace_id写入req.Header.Set("X-Trace-ID", traceID) - 每次调用
logger.Info前，从 context 取出trace_id并作为zap.String字段传入
漏掉任意一环（比如没往 header 写、或没从 context 取值），链路就断了。尤其注意中间件（如 JWT 验证）是否透传了 context。
立即学习“go语言免费学习笔记（深入）”；
日志采样和异步写入的取舍点在哪里
高频服务（如网关）打太多日志会拖慢性能，但全量采样又撑不住磁盘和日志系统。zap 本身不内置采样，得自己套一层：
- 用
zap.WrapCore包裹原始 core，实现按 level + key 组合采样（例如只保留 error 日志全量，info 日志 1%） - 避免用 goroutine 异步写日志——zap 的
AsyncWriteCore已废弃，官方明确说“异步丢失日志风险高” - 真正要降压，优先做日志分级：debug 日志只在 debug 环境开启；info 日志控制字段数量（别把整个 request body 打进去）
- 如果必须异步，用带 buffer 的 channel + 单 goroutine 消费，但 buffer 满时得丢弃（设
len(ch) == 1000，超了就select default）
日志不是越全越好，是刚好够排查问题。线上看到 trace_id 对不上、error 日志没上下文，八成是采样逻辑误伤了关键路径，或者 context 传递断在了某次 goroutine spawn 里。
