Linux系统下Golang日志如何管理

Linux 下 Golang 日志管理实践

一 核心要点

• 选择日志库：简单场景用标准库 log；需要结构化与生态集成用 logrus；高性能与低开销用 zap/zerolog；Go 1.21+ 可优先 slog。
• 统一输出与格式：生产建议输出到文件+控制台，格式用 JSON 便于检索与聚合。
• 日志轮转与归档：应用内用 lumberjack 或 file-rotatelogs；系统级用 logrotate。
• 运行期可观测：通过 环境变量 动态调整日志级别；结合 systemd/journalctl 查看服务日志。
• 集中式与检索：对接 ELK/EFK、Graylog、Loki 等平台做统一存储、分析与告警。

二 日志库选型与快速上手

• 标准库 log（简单可用）
  • 要点：设置输出、前缀与标志位，适合快速接入与小型工具。
  • 示例：
    • 打开日志文件：logFile, _ := os.OpenFile(“app.log”, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    • 配置：log.SetOutput(logFile); log.SetPrefix("INFO: "); log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
• logrus（结构化、插件丰富）
  • 要点：支持 JSON/Text、字段、钩子；生态成熟。
  • 示例：
    • logger := logrus.New(); logger.SetFormatter(&logrus.JSONFormatter{})
    • logger.SetOutput(os.Stdout); logger.SetLevel(logrus.InfoLevel)
    • logger.WithFields(logrus.Fields{“module”:“auth”}).Info(“login success”)
• zap（高性能、生产推荐）
  • 要点：结构化、可定制编码与采样，性能优于多数库。
  • 示例：
    • config := zap.NewProductionConfig(); config.OutputPaths = []string{“app.log”}; config.ErrorOutputPaths = []string{“stderr”}
    • logger, _ := config.Build(); defer logger.Sync(); logger.Info(“started”)
• 标准库 slog（Go 1.21+）
  • 要点：官方结构化日志，接口统一、依赖少，便于长期维护。

三 输出目标与轮转策略

• 应用内轮转（代码可控）
  • lumberjack（适配 zap/logrus）
    • 示例：
      • &lumberjack.Logger{Filename:“app.log”, MaxSize:10(MB), MaxBackups:3, MaxAge:28(天), Compress:true}
  • file-rotatelogs（适配 logrus）
    • 示例：
      • rotateLogs, _ := file-rotatelogs.New(“app.log.%d”, file-rotatelogs.WithLinkName(“app.log”), WithMaxAge(724time.Hour), WithRotationTime(24*time.Hour))
• 系统级轮转（运维友好）
  • logrotate 配置示例（/etc/logrotate.d/myapp）：
    • /var/log/myapp/*.log { daily; missingok; rotate 7; compress; notifempty; create 0640 appuser appgroup }
• 输出目标组合
  • 生产建议同时输出到文件（持久化/轮转）与控制台（容器/前台调试），便于本地排查与平台采集。

四 级别控制与动态配置

• 常见级别：DEBUG、INFO、WARN、ERROR、FATAL；开发环境用 DEBUG，生产用 INFO/WARN 降低噪声与开销。
• 运行时通过环境变量设置
  • 示例（logrus）：
    • level, _ := logrus.ParseLevel(os.Getenv(“LOG_LEVEL”)); logrus.SetLevel(level)
    • 启动：LOG_LEVEL=debug ./your_app
• 配置文件中设置
  • 读取 JSON/YAML 配置后解析为对应级别并调用 SetLevel。
• 标准库 log 的级别模拟
  • 通过自定义包装函数按阈值打印，实现“级别”控制。

五 监控检索与运维实践

• systemd 场景
  • 服务单元将日志输出到 stdout/stderr，使用 journalctl 查看：journalctl -u your.service -f
• 集中式日志平台
  • 小规模/云原生：对接 Loki + Promtail/Grafana；中大规模：对接 ELK/EFK（Elasticsearch/Logstash/Kibana） 或 Graylog。
• 检索与分析建议
  • 统一使用结构化字段（如 level、time、service、trace_id、method、status、path、ip、error）。
  • 为错误日志增加堆栈/错误链（如 Go 1.13+ 的 errors.Unwrap/Wrap/Is），便于定位根因。
• 性能与可靠性
  • 生产开启 logger.Sync()（zap）或使用 SugaredLogger 平衡性能与易用性；避免同步写磁盘造成阻塞。
  • 容器/高并发场景优先写入 stdout/stderr，由平台侧采集与轮转。