GitLab在CentOS系统上的日志管理如何操作

CentOS 上 GitLab 日志管理实操指南

一 日志查看与定位

• 使用 Omnibus 提供的命令行工具实时查看：
  • 查看全部日志：sudo gitlab-ctl tail
  • 查看某服务日志：sudo gitlab-ctl tail nginx/gitlab_error.log
• 直接查看磁盘日志目录（默认在 /var/log/gitlab）：
  • Rails 应用：/var/log/gitlab/gitlab-rails/production.log
  • Nginx：/var/log/gitlab/nginx/access.log、/var/log/gitlab/nginx/error.log
  • Sidekiq：/var/log/gitlab/sidekiq/current
  • Unicorn：/var/log/gitlab/unicorn/*.log
• 使用 systemd 查看服务日志（如系统采用 systemd 管理 GitLab 相关单元）：
  • 查看所有 GitLab 单元日志：sudo journalctl -u gitlab
  • 查看指定服务：sudo journalctl -u gitlab-rails
  • 按时间过滤：sudo journalctl --since “2024-01-01” --until “2024-01-31”。

二 日志轮转与保留策略

• Runit 日志（各组件服务日志，由 svlogd 管理）：在 /etc/gitlab/gitlab.rb 中调整
  • 示例：
    • 单个日志达到 200MB 轮转：logging[‘svlogd_size’] = 200 * 1024 * 1024
    • 保留 30 个历史文件：logging[‘svlogd_num’] = 30
    • 每隔 24 小时强制轮转：logging[‘svlogd_timeout’] = 24 * 60 * 60
    • 压缩历史日志：logging[‘svlogd_filter’] = “gzip”
• Logrotate（整实例日志归档）：Omnibus 自 7.4 起内置 logrotate，可在 /etc/gitlab/gitlab.rb 中统一配置
  • 示例：
    • 按天轮转：logging[‘logrotate_frequency’] = “daily”
    • 保留 30 天：logging[‘logrotate_rotate’] = 30
    • 启用压缩：logging[‘logrotate_compress’] = “compress”
    • 按大小触发（可选）：logging[‘logrotate_size’] = “200M”
  • 服务级覆盖（示例为 Nginx）：
    • 仅按大小轮转：nginx[‘logrotate_frequency’] = nil
    • 大小阈值：nginx[‘logrotate_size’] = “200M”
  • 禁用内置 logrotate（不建议）：logrotate[‘enable’] = false
• 使配置生效：每次修改 gitlab.rb 后执行 sudo gitlab-ctl reconfigure。

三 日志分析与监控

• 内置与系统工具：
  • Web 端 CI/CD 查看作业日志；必要时通过 GitLab API 拉取作业日志（如 /api/v4/projects/:id/jobs/:id/trace）。
  • 使用 logwatch 生成日报/周报（安装：sudo yum install logwatch；生成报告：sudo logwatch --output mail）。
• 集中化与可视化：
  • 将 /var/log/gitlab 通过 rsyslog/syslog-ng 或 Filebeat 发送到 ELK（Elasticsearch/Logstash/Kibana） 或 Splunk 做检索与可视化。
  • 结合 Prometheus + Grafana 做指标监控与告警，与日志联动排查。

四 常见问题与维护建议

• 日志目录确认与自定义：默认在 /var/log/gitlab；如需变更，可在 /etc/gitlab/gitlab.rb 中设置如 gitlab_rails[‘log_directory’] 等路径后执行 gitlab-ctl reconfigure。
• 变更生效与生效验证：所有通过 gitlab.rb 的日志参数修改，均需执行 sudo gitlab-ctl reconfigure；验证可用 gitlab-ctl tail 或检查 /var/log/gitlab 下文件是否按策略轮转。
• 磁盘空间治理：
  • 优先依靠 logrotate 的 rotate/compress 策略控制体积与保留天数。
  • 如确需清理历史归档，建议先备份，再删除超过保留期的 .gz 文件，避免直接删除正在写入的 current 或 production.log。
  • 不建议使用 git log/reflog/gc 清理服务器日志，这些命令用于 Git 仓库对象，与系统/应用日志无关。