Linux系统下Golang日志配置指南

一、基础日志配置：使用标准库log包

Golang标准库的log包提供了最基础的日志功能，适合小型项目或快速原型开发。其核心功能包括输出日志到文件/控制台、添加前缀和日志级别标识。
关键配置项：

• 输出目标：通过os.OpenFile打开日志文件，设置os.O_CREATE|os.O_WRONLY|os.O_APPEND模式（创建文件、写入模式、追加内容），权限设为0666（所有用户可读写）。
• 日志格式：使用log.SetFlags设置时间戳（log.Ldate、log.Ltime）、文件名及行号（log.Lshortfile），例如log.SetFlags(log.LstdFlags | log.Lshortfile)会输出类似2025/10/27 14:30:00 main.go:10: This is a log message的内容。
• 前缀：通过log.SetPrefix添加日志前缀（如"INFO: "），用于区分日志类型。

二、进阶日志配置：第三方日志库

1. Logrus（功能全面，适合传统项目）

Logrus是Golang最流行的第三方日志库之一，支持日志级别、结构化日志、钩子机制（如发送日志到Elasticsearch）和日志轮转。
关键配置步骤：

• 初始化Logger：创建logrus.New()实例，设置日志级别（如logrus.InfoLevel）、输出目标（文件或控制台）和格式化器（JSONFormatter或TextFormatter）。
• 结构化日志：使用WithFields方法添加上下文字段（如event、status），输出JSON格式日志，便于后续分析。
• 日志轮转：集成lumberjack库，设置MaxSize（单个文件最大大小，单位MB）、MaxBackups（保留的旧日志文件数量）、MaxAge（保留天数）和Compress（是否压缩），避免日志文件过大。

示例代码：

package main
import (
    "github.com/sirupsen/logrus"
    "os"
    "gopkg.in/natefinch/lumberjack.v2"
)
func main() {
    logger := logrus.New()
    logger.SetLevel(logrus.InfoLevel)
    logger.SetFormatter(&logrus.JSONFormatter{})
    
    // 日志轮转配置
    logFile := &lumberjack.Logger{
        Filename:   "app.log",
        MaxSize:    5,    // MB
        MaxBackups: 3,    // 保留3个旧文件
        MaxAge:     28,   // 保留28天
        Compress:   true, // 压缩旧文件
    }
    logger.SetOutput(logFile)
    
    // 结构化日志记录
    logger.WithFields(logrus.Fields{
        "event": "startup",
        "status": "running",
    }).Info("Application started")
}

2. Zap（高性能，适合生产环境）

Zap是Uber开源的高性能日志库，专注于速度和低延迟，适合对性能要求高的生产环境（如微服务、高频交易系统）。
关键配置步骤：

• 初始化Logger：使用zap.NewProduction（生产环境）或zap.NewDevelopment（开发环境）创建Logger，支持JSON格式输出和自定义编码器（如时间格式、调用栈信息）。
• 性能优化：通过zapcore.AddSync将日志输出到文件或标准输出，结合lumberjack实现日志轮转。
• 上下文信息：使用zap.String、zap.Int等方法添加结构化字段，避免字符串拼接带来的性能损耗。

示例代码：

package main
import (
    "go.uber.org/zap"
    "go.uber.org/zap/zapcore"
    "gopkg.in/natefinch/lumberjack.v2"
)
func main() {
    // 日志轮转配置
    lumberjackLogger := &lumberjack.Logger{
        Filename:   "app.log",
        MaxSize:    5,
        MaxBackups: 3,
        MaxAge:     28,
        Compress:   true,
    }
    
    // Zap配置
    encoderConfig := zapcore.EncoderConfig{
        TimeKey:        "timestamp",
        LevelKey:       "level",
        NameKey:        "logger",
        CallerKey:      "caller",
        MessageKey:     "message",
        StacktraceKey:  "stacktrace",
        LineEnding:     zapcore.DefaultLineEnding,
        EncodeLevel:    zapcore.LowercaseLevelEncoder,
        EncodeTime:     zapcore.ISO8601TimeEncoder,
        EncodeCaller:   zapcore.ShortCallerEncoder,
    }
    core := zapcore.NewCore(
        zapcore.NewJSONEncoder(encoderConfig),
        zapcore.AddSync(lumberjackLogger),
        zap.InfoLevel,
    )
    logger := zap.New(core)
    defer logger.Sync() // 确保日志刷新到文件
    
    // 结构化日志记录
    logger.Info("Application started",
        zap.String("event", "startup"),
        zap.Int("port", 8080),
    )
}

三、日志轮转：使用lumberjack库

无论使用标准库还是第三方库，日志轮转都是生产环境的必备功能，用于防止日志文件占用过多磁盘空间。lumberjack是Golang常用的日志轮转库，支持按大小、时间和备份数量控制日志文件。
核心配置参数：

• Filename：日志文件路径（如"app.log"）。
• MaxSize：单个日志文件最大大小（单位：MB），超过则创建新文件。
• MaxBackups：保留的旧日志文件数量（如3表示保留最近3个文件）。
• MaxAge：保留旧日志文件的天数（如28表示保留最近28天的文件）。
• Compress：是否压缩旧日志文件（如true表示压缩为.gz格式）。

四、结构化日志：提升可观测性

结构化日志（如JSON格式）是现代日志系统的核心要求，便于日志收集系统（如ELK、Loki、Fluentd）解析、搜索和分析。相比传统的文本日志，结构化日志能更好地关联上下文信息（如请求ID、用户ID、状态码）。
实现方式：

• 标准库log：自定义Formatter，将日志转换为JSON格式（如前面提到的JSONFormatter示例）。
• Logrus：内置JSONFormatter，通过WithFields方法添加结构化字段。
• Zap：默认输出JSON格式，使用zap.String、zap.Int等方法添加字段，性能优于文本格式。

五、容器环境下的日志配置

在Docker/Kubernetes环境中，推荐将Golang应用的日志输出到stdout/stderr，由外部日志系统（如Fluentd、Filebeat）采集并转发至集中式日志平台（如ELK、Loki）。
关键配置：

• 输出到stdout：使用log.SetOutput(os.Stdout)（标准库）或logger.SetOutput(os.Stdout)（Logrus），或Zap的zapcore.AddSync(os.Stdout)。
• Docker日志驱动：运行容器时指定--log-driver=json-file（默认），并通过--log-opt max-size和--log-opt max-file限制日志文件大小和数量（如docker run --log-driver=json-file --log-opt max-size=10m --log-opt max-file=3 your-golang-app）。
• 边车模式：在Kubernetes中，通过共享EmptyDir卷让应用容器和日志采集容器（如Filebeat）读取同一日志目录，实现日志收集。

六、最佳实践总结

1. 生产环境选型：优先选择Zap（高性能）或Logrus（功能全面），避免使用标准库log（功能有限）。
2. 结构化日志：始终使用JSON格式输出日志，添加足够的上下文信息（如请求ID、用户ID、状态码）。
3. 日志轮转：集成lumberjack库，避免日志文件过大导致磁盘空间耗尽。
4. 容器环境：输出日志到stdout/stderr，结合外部日志系统实现集中式管理。
5. 日志级别：根据环境设置不同日志级别（开发环境用Debug，生产环境用Info/Error），减少不必要的日志输出。