Linux环境下Golang日志配置指南

Linux环境下Golang日志配置指南

一 选型与总体建议

• 在 Linux 服务器上，优先使用结构化日志（如 JSON），便于对接 ELK/Loki 等集中式日志平台；开发环境可用更易读的 console 格式。
• 库的选择：标准库 log 适合简单场景；对可观测性与扩展性要求高时选 logrus；对性能敏感时选 zap/zerolog；Go 1.21+ 可直接使用官方结构化日志 slog。
• 输出目标：容器与系统服务建议输出到 stdout/stderr，由 systemd/journald 或容器运行时收集；物理机/虚拟机可将日志写入文件并配合 logrotate 做轮转与压缩。

二 快速上手示例

• 标准库 log 输出到文件与控制台
  • 要点：使用 os.OpenFile 以 O_CREATE|O_WRONLY|O_APPEND 打开日志文件，设置前缀与标志，使用 io.MultiWriter 同时输出到文件与控制台。
  • 示例：
    • logFile, _ := os.OpenFile(“app.log”, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    • log.SetOutput(io.MultiWriter(logFile, os.Stdout))
    • log.SetPrefix("INFO: "); log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
• logrus 输出到文件并轮转
  • 要点：使用 lumberjack.Logger 实现按大小/时间切割、保留与压缩。
  • 示例：
    • logger := logrus.New(); logger.SetFormatter(&logrus.JSONFormatter{})
    • logger.SetOutput(&lumberjack.Logger{
      • Filename: “./logs/app.log”, MaxSize: 10, MaxBackups: 3, MaxAge: 28, Compress: true })
• zap 生产环境 JSON 日志到文件
  • 要点：使用 zap.NewProductionConfig 或自定义 zapcore.Core，配合 lumberjack 写入文件；记得 defer logger.Sync() 刷盘。
  • 示例：
    • cfg := zap.NewProductionConfig(); cfg.OutputPaths = []string{“app.log”}; cfg.ErrorOutputPaths = []string{“stderr”}
    • logger, _ := cfg.Build(); defer logger.Sync()
    • logger.Info(“started”, zap.String(“version”, “1.2.3”))
• 以上示例覆盖了“标准库/logrus/zap + 轮转”的最常用路径，可直接改造用于你的项目。

三 生产级配置要点

• 日志级别：开发环境设 Debug，生产环境设 Info/Warn，避免过多日志影响性能与成本。
• 结构化与字段：统一使用 key=value 的结构化字段（如 trace_id、user_id、method、path、status、duration），便于检索与聚合。
• 时间与调用者：统一时间格式（如 ISO8601），开启 caller 定位文件与行号；在封装函数中可用 AddCallerSkip(n) 修正调用栈。
• 性能与可靠性：高并发场景优先 zap/zerolog；必要时开启 Sync 或批量/异步写入减少 I/O 抖动；避免在热路径拼接大对象。
• 输出策略：容器化优先 stdout/stderr；物理机可写文件并配合 logrotate；错误日志可单独输出到 error.log 便于告警与追踪。

四 日志轮转与系统日志集成

• 应用内轮转（推荐与文件输出搭配）：使用 lumberjack.Logger 控制单个文件大小（MaxSize/MB）、保留个数（MaxBackups）、保留天数（MaxAge/天）与压缩（Compress）。示例参数：MaxSize 10、MaxBackups 3、MaxAge 28、Compress true。
• 系统级轮转（适合长期运行进程）：使用 logrotate 管理日志生命周期，示例配置：
  • /var/log/myapp/*.log {
    • daily; missingok; rotate 7; compress; notifempty
    • create 640 appuser appgroup
  • }
• 与 systemd/journald 集成：将日志输出到 stdout/stderr，通过 journalctl -u your.service -f 查看；如需对接 rsyslog/syslog-ng，可在 systemd 服务中配置 SyslogIdentifier 或使用本地 syslog 驱动。

五 HTTP 访问日志与可观测性增强

• 使用 zap 编写结构化访问日志中间件，记录 method、path、query、ip、user_agent、status、duration 等关键字段；根据 status 动态选择日志级别（如 5xx 用 Error、4xx 用 Warn）。
• 建议将访问日志与业务日志分离（不同文件或不同 logger 实例），并在 context 中透传 trace_id，实现链路追踪与日志关联。