Go中使用charmbracelet/log同时输出日志到stdout与文件的更优方案

一、基础方案：io.MultiWriter实现双输出 #

io.MultiWriter是Go标准库提供的可靠方案，完全适配charmbracelet/log，无额外依赖，代码可直接落地：

import (
    "io"
    "os"
    "time"

    "github.com/charmbracelet/log"
)

func init() {
    // 打开日志文件：追加模式，不存在则创建，权限0644
    logFile, err := os.OpenFile("ares.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
    if err != nil {
        log.Fatalf("failed to open log file: %v", err)
    }

    // 同时输出到标准输出和日志文件
    log.SetOutput(io.MultiWriter(os.Stdout, logFile))

    // 保留原有核心配置
    log.SetReportCaller(true)
    log.SetReportTimestamp(true)
    log.SetTimeFormat(time.RFC3339) // 改用标准RFC3339格式，方便后续ELK解析
    log.SetPrefix("Ares")
    log.SetLevel(log.DebugLevel)
    log.SetFormatter(log.TextFormatter)
}

这个方案轻量稳定，适合快速实现需求，但面对大量日志时，需要补充日志轮转机制避免文件体积失控。

二、进阶更优方案：适配大规模日志与监控栈 #

针对你计划搭建的ELK、Grafana、Prometheus栈，以及多语言微服务场景，推荐以下优化方案：

1. 日志自动轮转 #

引入lumberjack库实现日志切割、过期删除，解决大日志文件问题：

import (
    "io"
    "os"
    "time"

    "github.com/charmbracelet/log"
    "gopkg.in/natefinch/lumberjack.v2"
)

func init() {
    // 配置日志轮转规则
    logRotator := &lumberjack.Logger{
        Filename:   "ares.log",
        MaxSize:    100,    // 单个文件最大100MB
        MaxBackups: 30,     // 最多保留30个备份文件
        MaxAge:     7,      // 日志保留7天
        Compress:   true,   // 自动压缩旧日志
    }

    // 同时输出到标准输出和轮转日志文件
    log.SetOutput(io.MultiWriter(os.Stdout, logRotator))

    // 核心配置调整为适配监控栈的格式
    log.SetReportCaller(true)
    log.SetReportTimestamp(true)
    log.SetTimeFormat(time.RFC3339)
    log.SetPrefix("Ares")
    log.SetLevel(log.DebugLevel)
    log.SetFormatter(log.JSONFormatter) // 改用JSON格式，方便ELK解析
}

2. 日志参数可配置化 #

将日志级别、格式、文件路径等参数改为环境变量读取，方便不同环境（开发/测试/生产）快速切换：

func init() {
    // 从环境变量读取日志级别，默认Debug
    logLevelStr := os.Getenv("LOG_LEVEL")
    logLevel, err := log.ParseLevel(logLevelStr)
    if err != nil {
        logLevel = log.DebugLevel
    }

    // 从环境变量读取日志格式，默认文本格式
    logFormat := os.Getenv("LOG_FORMAT")
    var formatter log.Formatter
    if logFormat == "json" {
        formatter = log.JSONFormatter
    } else {
        formatter = log.TextFormatter
    }

    // 日志轮转配置
    logRotator := &lumberjack.Logger{
        Filename:   os.Getenv("LOG_FILE_PATH"),
        MaxSize:    100,
        MaxBackups: 30,
        MaxAge:     7,
        Compress:   true,
    }

    log.SetOutput(io.MultiWriter(os.Stdout, logRotator))
    log.SetReportCaller(true)
    log.SetReportTimestamp(true)
    log.SetTimeFormat(time.RFC3339)
    log.SetPrefix("Ares")
    log.SetLevel(logLevel)
    log.SetFormatter(formatter)
}

3. 多语言微服务统一日志规范 #

因为项目包含Go和Python服务，需要统一日志格式以适配ELK：

• 统一时间戳格式为RFC3339
• 统一核心字段：service_name（如"Ares"）、level、message、caller、timestamp
• Go使用log.JSONFormatter输出，Python使用python-json-logger库输出同结构JSON日志

4. 日志指标集成Prometheus #

为监控日志量、错误率等指标，可通过Prometheus客户端库添加日志计数器：

import (
    "github.com/prometheus/client_golang/prometheus"
    "github.com/prometheus/client_golang/prometheus/promauto"
)

// 定义日志统计指标
var logCounter = promauto.NewCounterVec(
    prometheus.CounterOpts{
        Name: "ares_logs_total",
        Help: "Total number of logs emitted by Ares service",
    },
    []string{"level"},
)

// 包装日志函数，自动统计对应级别的日志量
func logWithMetrics(level log.Level, msg string, args ...interface{}) {
    logCounter.WithLabelValues(level.String()).Inc()
    log.Log(level, msg, args...)
}

后续可通过Grafana基于Prometheus的日志指标配置监控告警。

三、方案对比 #

• io.MultiWriter基础版：适合快速实现双输出，无额外依赖，适配小体量服务
• 进阶版（轮转+结构化+可配置）：适配大规模日志场景，完美兼容ELK/Prometheus栈，是生产环境的最优选择

内容的提问来源于stack exchange，提问作者theredditbandit