查看 CentOS 上 Golang 应用日志的实用方法

一 确认日志输出位置

日志究竟写到哪里去了？这是排查问题的第一步。通常，日志会出现在以下几个地方：应用的工作目录（比如当前目录或者项目目录）、自定义的目录（例如 /var/log/your_app/）、用户的家目录（比如 /home/username/logs/）。当然，还有一种常见情况是通过 syslog 或 journald 写入系统日志。如果你的服务是用 systemd 托管的，那么日志大概率就归 journald 管理了。

最直接的定位方法，就是去翻看应用的配置文件、启动脚本，或者直接查看源码里日志初始化的部分——找找类似 log.SetOutput 的调用，或者 logrus、zap 这些库的输出设置，答案往往就在里面。

二 常用查看命令

知道了位置，接下来就是怎么看了。这里分几个场景，掌握几个命令就够用了。

• 实时查看文件日志：用 tail -f /path/to/app.log 可以紧盯着日志的最新动态。如果想在茫茫日志中快速找到关键信息，可以配合 grep，比如 grep ‘error’ /path/to/app.log 专门看错误，或者用 grep -v ‘debug’ 过滤掉调试信息。
• 查看 systemd 服务日志：如果服务名叫 my-golang-app.service，那么 journalctl -u my-golang-app.service 就是查看其全部日志的钥匙。加上 -f 参数就能实时跟踪。它还能按时间检索，比如 journalctl --since “2024-04-01” --until “2024-04-30”，同样也能结合 grep 进行搜索。
• 直接查看控制台输出：应用如果在前台运行，日志会直接打印到终端；如果是通过 nohup 启动的，那别忘了去 nohup.out 文件里看看。以上这些命令，基本覆盖了文件日志和 systemd 日志这两大主力场景。

三 按场景给出的命令示例

光说理论可能有点抽象，这里直接上几个“开箱即用”的命令示例，遇到对应场景直接套用，效率倍增。

• 场景：文件日志 – 想实时监控日志，并且高亮显示错误行。
  • 命令：tail -f /var/log/myapp/app.log | grep --color=auto -i error
• 场景：systemd 服务日志 – 想先看看最近100条日志，然后持续跟踪。
  • 命令：journalctl -u my-golang-app.service -n 100 -f
• 场景：时间范围检索 – 只想查看昨天一天的日志。
  • 命令：journalctl -u my-golang-app.service --since “2025-12-24 00:00:00” --until “2025-12-24 23:59:59”
• 场景：关键字统计与排查 – 想统计一下错误总共出现了多少次，有个量化概念。
  • 命令：grep -c ‘error’ /var/log/myapp/app.log

这些示例能帮你快速定位服务启动失败、运行异常，或者锁定错误频繁出现的时间段和上下文。

四 日志轮转与长期管理

日志文件如果放任不管，很容易就会膨胀成几个G的“庞然大物”，既占空间又难查阅。所以，日志轮转是生产环境必不可少的一环。

• 应用内轮转：对于 Go 应用，可以使用 lumberjack 这类库来实现。配置起来很直观：设定单个文件的最大大小（比如10MB）、保留的备份文件数（比如3个）、文件保留天数（比如28天），以及是否压缩旧日志。日志路径可以指定为 /var/log/myapp.log。
• 系统级轮转：更通用的做法是交给系统的 logrotate 工具来管理。做法是在 /etc/logrotate.d/ 目录下为你的应用创建一个配置文件（例如 /etc/logrotate.d/myapp）。在里面设置轮转周期（daily/weekly）、保留份数（rotate 7）、是否压缩（compress）等。关键一点是，轮转后可能需要通知应用重新打开日志文件，这可以通过 postrotate 指令，执行类似 systemctl reload my-golang-app 的命令来实现。一套合理的轮转策略，能有效避免单个日志文件过大，也让历史日志的归档和追溯变得轻松。

五 让日志更易查的编码建议

说到底，日志是写给人看的。在编码阶段就养成好习惯，能极大提升后续排查问题的效率。

• 优先使用成熟的日志库（如 logrus、zap），并统一日志格式，确保每条日志都包含时间戳、日志级别、调用者信息等关键字段。为了在分布式系统中串联请求，强烈建议在日志中输出 request_id 或 trace_id。
• 对于 systemd 服务，在单元文件（.service）中明确设置 StandardOutput=journal 和 StandardError=journal，必要时指定 SyslogIdentifier=my-golang-app。同时，为服务配置合适的运行用户/组（User/Group）和工作目录（WorkingDirectory）。最后，务必确保日志目录（如 /var/log/myapp/）存在且进程有写入权限（目录权限建议755，日志文件权限644）。
• 除了被动查看，还可以建立主动告警。为关键错误配置告警机制，对接到企业微信、钉钉或邮件，做到问题早发现。在目录结构上，也可以考虑按天或按业务模块划分，让海量日志井井有条。

遵循这些实践，你的 Golang 应用日志的可读性和可运维性将会得到显著提升，定位问题的效率自然也就水涨船高了。