log.Printf 不能用于微服务日志集中管理，因其输出非结构化纯文本、无 trace_id 关联、无法跨服务追踪；应统一使用 zerolog/zap 等结构化日志库，输出 JSON 到 stdout，并注入 service_name、trace_id、level、ts 等字段。
为什么 log.Printf 不能直接用于微服务日志集中管理
微服务部署后，每个服务实例都独立写本地文件或控制台，log.Printf 输出的日志分散、无结构、缺少 trace ID 关联，根本无法跨服务追踪请求。ELK 或 Loki 这类日志系统只接受结构化（如 JSON）且带统一字段（service_name、trace_id、level）的日志流。log.Printf 默认输出纯文本，没有字段可提取，也没有上下文透传能力。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 禁用所有裸
log.Printf和fmt.Println，哪怕只是临时调试 - 统一使用支持结构化输出和 context 注入的日志库，如
zerolog或zap - 在服务启动时配置日志为
JSON格式输出到os.Stdout（而非文件），由容器运行时（如 Docker、K8s）接管 stdout/stderr 流向 - 确保每条日志至少包含：
service_name（硬编码或从环境变量读取）、level、ts、trace_id（从 HTTP header 或 context 提取）
如何让 zerolog 自动注入 trace_id 和请求上下文
zerolog 本身不自动解析 HTTP 请求，必须手动从 context.Context 或 http.Request 中提取并注入。常见错误是只在 handler 入口加一次 trace_id，但后续 goroutine 或异步调用丢失上下文。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义中间件，在
http.Handler中从X-Request-ID或traceparentheader 读取trace_id，写入context.WithValue - 封装一个日志工厂函数，每次从 request context 中提取
trace_id并创建带字段的子 logger：logger := zerolog.Ctx(r.Context()).With().Str("trace_id", tid).Logger() - 避免在 goroutine 中直接用外部 logger；必须显式传入带 context 的 logger，或用
zerolog.Ctx(ctx)重新获取 - 若用 gRPC，需在
UnaryServerInterceptor中做同样处理，并将trace_id写入metadata.MD向下游透传
Kubernetes 中日志采集为何收不到 stderr 日志
很多 Golang 服务把 error 日志写到 os.Stderr，但在 K8s 里，如果容器 runtime 没有正确配置日志驱动（如 json-file），或 DaemonSet 形式的采集器（如 Promtail、Filebeat）没监听 /var/log/pods/... 下对应 symlink 路径，stderr 就会静默丢弃。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认容器使用默认
json-file日志驱动：docker info | grep "Logging Driver"或检查 K8s node 上/var/lib/docker/containers/**/config.v2.json中LogConfig.Type - Promtail 配置中，
scrape_configs的static_configs.paths必须包含/var/log/pods/*_YOUR-SERVICE-NAME*_*/**/*.log，否则 stderr 不会被识别 - Golang 中不要手动重定向
os.Stderr到文件——这会绕过 K8s 日志收集链路；所有日志统一走os.Stdout，用 level 字段区分"level":"error" - 验证方式：在 Pod 内执行
ls -l /proc/1/fd/{1,2}，应看到指向/dev/pts/0或pipe:，而非某个具体文件路径
日志采集中时间戳乱序、重复或缺失的根本原因
不是采集工具的问题，而是 Golang 程序自身日志时间戳生成时机与采集缓冲不一致。典型场景：多个 goroutine 并发调用 zerolog.TimeField，但未启用 zerolog.TimestampFunc 统一纳秒级时钟；或 Prometheus metrics push 与日志写入共享同一 stdout pipe，造成行缓冲错位。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 强制设置高精度时间戳：
zerolog.TimeFieldFormat = time.RFC3339Nano zerolog.TimestampFunc = func() time.Time { return time.Now().UTC() } - 关闭日志库的异步写（如
zerolog.NewConsoleWriter()默认异步），改用同步 writer 或直接写os.Stdout - 禁止在日志语句中拼接动态字符串（如
logger.Info().Msg("user " + u.Name + " logged in")），改用结构化字段，避免因字符串拼接阻塞主线程导致时间戳偏移 - 若同时上报 metrics，确保 metrics client 使用独立 HTTP client，不与日志共用 stdout 或同一 goroutine
trace_id、精确时间戳和所属服务身份——这要求从第一行 main() 开始就约束日志初始化方式，而不是等日志查不到时再补中间件。 
