CentOS下Golang日志管理实践

一 总体思路与方案选型

在CentOS上为Golang应用规划日志方案，其实就围绕几个核心问题：日志往哪写、怎么转、谁来管。下面这几点，算是业界比较成熟的实践路径。

• 输出目标：通常有两个主流选择。一是优先输出到标准输出或标准错误，然后交给systemd接管，由journald统一写入系统日志。二是让程序直接将日志写入文件，再配合logrotate做后续的轮转与压缩。
• 轮转策略：轮转这事儿，可以在程序内部做，也可以在系统层面做，甚至两者叠加。比如，用lumberjack在程序内按日志文件大小滚动切割，同时再用系统的logrotate按天或按周进行归档清理，双管齐下，管理更精细。
• 权限与目录：这是运维安全的基本功。日志目录和文件必须确保运行用户（比如myapp）有写入权限。通常建议将日志集中放在/var/log/myapp/这样的专属目录下，并设置合适的属主、属组和文件权限（例如0640），避免权限过宽带来风险。
• 集中与检索：单机日志查看，用journalctl命令查询服务日志就很方便。但如果需要跨服务器检索或做可视化分析，那就得考虑接入rsyslog进行转发，或者上ELK（Elasticsearch, Logstash, Kibana）这类集中式日志方案了。

二 输出到标准输出并用 systemd 管理

对于使用systemd管理的服务，将日志输出到标准输出（stdout）和标准错误（stderr）是最优雅的方式。这样一来，systemd的journald服务就能自动捕获、存储和索引这些日志。

• 示例服务文件：在/etc/systemd/system/myapp.service中，关键配置如下：

[Unit]
Description=My Go Application
After=network.target

[Service]
Type=simple
User=myapp
Group=myapp
ExecStart=/opt/myapp/myapp
StandardOutput=journal
StandardError=journal
Restart=always
WorkingDirectory=/opt/myapp

[Install]
WantedBy=multi-user.target

• 常用查看命令：配置好后，查看日志就非常顺手了：
  • 实时跟踪服务日志：sudo journalctl -u myapp -f
  • 仅查看本次启动后的日志：sudo journalctl -u myapp -b
  • 按时间范围过滤：sudo journalctl -u myapp --since “2025-11-25 00:00:00”
• 说明：这种方式的好处显而易见。journald不仅统一管理了所有服务的日志，还支持丰富的结构化查询和过滤，并且可以轻松配置将日志转发到其他系统，为后续的集中化处理铺平道路。

三 写入文件并用 logrotate 轮转

如果应用场景不适合或不想用systemd管理，直接将日志写入文件，再交给老牌工具logrotate来轮转，是另一条经典且可靠的路径。

• 创建日志目录与权限：首先，得把日志的“家”安好：

sudo mkdir -p /var/log/myapp
sudo chown myapp:myapp /var/log/myapp
sudo chmod 0755 /var/log/myapp

• 创建轮转配置：接下来，在/etc/logrotate.d/myapp中定义轮转规则：

/var/log/myapp/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
    create 0640 myapp myapp
    copytruncate
}

• 说明：这个配置定义了一套清晰的轮转逻辑：
  • daily、rotate 7、compress：按天轮转，保留最近7份日志，并且自动用gzip压缩旧文件以节省空间。
  • create 0640 myapp myapp：轮转后创建新日志文件，并直接设置好权限和属主，安全又省心。
  • copytruncate：采用“先复制后截断”的方式，而不是移动文件。这适用于那些不支持通过接收信号（如SIGHUP）来重新打开日志文件句柄的程序，避免了日志丢失。
• 测试与生效：配置完，务必先测试一下：
  • 手动触发轮转测试：sudo logrotate -f /etc/logrotate.d/myapp
  • 验证目录下是否生成了轮转后的文件：ls -lh /var/log/myapp/。

四 在程序内使用 lumberjack 进行内置轮转

对于一些特定环境，比如容器化部署，或者没有系统级logrotate的场景，在Golang程序内部集成日志轮转能力就变得非常必要。lumberjack库正是为此而生。

• 安装依赖：首先，把库引入项目：

go get gopkg.in/natefinch/lumberjack.v2

• 示例代码（标准库 log + lumberjack）：集成起来非常简洁：

package main

import (
    “log”
    “gopkg.in/natefinch/lumberjack.v2”
)

func main() {
    logger := log.New(&lumberjack.Logger{
        Filename: “/var/log/myapp/app.log”, // 日志路径
        MaxSize:10, // 单个文件最大 10MB
        MaxBackups: 7,// 最多保留 7 个备份
        MaxAge: 28, // 备份最多保留 28 天
        Compress: true, // 启用压缩
    }, “”, log.LstdFlags)

    logger.Println(“hello, this is a log message”)
}

• 说明：这种方案将轮转逻辑内置于应用，不依赖外部环境，尤其适合云原生场景。有意思的是，它和系统级的logrotate并不冲突，完全可以叠加使用——例如，让lumberjack负责按大小切割，再让logrotate按时间归档清理，形成双重保障。

五 权限与集中式日志方案

聊完了输出和轮转，最后再强调两个支撑性的要点：安全权限和日志的“诗和远方”——集中化管理。

• 权限与目录建议：安全无小事，日志文件的权限必须收紧：
  • 目录：建议使用/var/log/myapp，权限设置为0755，属主设为myapp:myapp。
  • 文件：日志文件本身的权限建议设为0640，属主同样为myapp:myapp。务必避免设置为0666这类过于宽松的权限。
• 集中式日志：当服务器数量增长后，登录每台机器看日志就成了噩梦。这时就需要集中式日志方案：
  • 可以使用rsyslog作为日志收集器，将日志写入本地文件或直接转发到远程日志中心。通常编辑/etc/rsyslog.conf，启用UDP或TCP 514端口监听，然后重启服务即可。
  • 为了便于后续分析，建议在程序中使用如logrus、zap等支持结构化输出的日志库，将日志格式化为JSON。这样，ELK、Splunk等日志平台就能轻松地进行采集、解析和深度分析了，这才是发挥日志最大价值的正确方式。