Ubuntu GitLab的日志管理技巧

Ubuntu 上 GitLab 日志管理实用技巧

一 快速定位与实时查看

• 使用 Omnibus 提供的命令行工具查看与跟踪日志：
  • 实时查看所有服务：sudo gitlab-ctl tail
  • 查看指定服务：sudo gitlab-ctl tail gitlab-rails
  • 查看具体文件：sudo gitlab-ctl tail nginx/gitlab_error.log
• 直接读取日志目录：GitLab 主要日志位于 /var/log/gitlab，常用示例：
  • Rails 应用日志：sudo cat /var/log/gitlab/gitlab-rails/production.log
  • JSON 格式日志：sudo cat /var/log/gitlab/gitlab-rails/production_json.log
  • Nginx 访问/错误：sudo cat /var/log/gitlab/nginx/gitlab_access.log 或 gitlab_error.log
• 使用 systemd 的 journalctl（若使用 systemd 管理 GitLab 服务）：
  • 查看所有 GitLab 服务：sudo journalctl -u gitlab
  • 查看 Rails 服务：sudo journalctl -u gitlab-rails
• 在 CI/CD 任务界面或 API 获取流水线/作业日志（便于聚合与审计）。

二 日志轮转与保留策略

• 内置 Logrotate（适用于非 Runit 管理的日志，如 gitlab-rails/production.log、nginx/gitlab_access.log）：
  • 常用参数（/etc/gitlab/gitlab.rb）：
    • logging[‘logrotate_frequency’] = “daily”（按天轮转）
    • logging[‘logrotate_rotate’] = 30（保留 30 天）
    • logging[‘logrotate_compress’] = “compress”（压缩旧日志）
    • logging[‘logrotate_method’] = “copytruncate”（切割方式）
  • 可按服务覆盖：例如 nginx[‘logrotate_size’] = “200M”
  • 应用变更：sudo gitlab-ctl reconfigure
• Runit 服务日志（由 svlogd 管理，如 sidekiq、unicorn 等）：
  • 常用参数（/etc/gitlab/gitlab.rb）：
    • logging[‘svlogd_size’] = 200 * 1024 * 1024（单文件超过 200MB 切割）
    • logging[‘svlogd_num’] = 30（保留 30 个）
    • logging[‘svlogd_timeout’] = 24 * 60 * 60（按天切割）
    • logging[‘svlogd_filter’] = “gzip”（压缩）
    • 可按组件设置前缀：nginx[‘svlogd_prefix’] = “nginx”
• 企业版可选：通过 UDP 将日志发往远程 syslog（需 EE）
  • 示例：logging[‘udp_log_shipping_host’] = ‘1.2.3.4’；logging[‘udp_log_shipping_port’] = 1514（默认 514）

三 常用排查命令与过滤技巧

• 实时跟踪 Rails 日志并筛选错误：
  • sudo gitlab-ctl tail gitlab-rails | grep -i “error|exception|failed”
• 查看 JSON 日志中的异常（结构化检索更友好）：
  • sudo cat /var/log/gitlab/gitlab-rails/production_json.log | jq ‘select(.severity == “ERROR”)’
• 按时间窗口查看 systemd 日志（便于定位某时段故障）：
  • sudo journalctl -u gitlab-rails --since “2025-11-19 00:00:00” --until “2025-11-19 12:00:00”
• 查看 Nginx 访问日志中 5xx 错误：
  • sudo gitlab-ctl tail nginx/gitlab_access.log | awk ‘$9 >= 500 {print $0}’
• 查看 Sidekiq 失败任务：
  • sudo gitlab-ctl tail sidekiq | grep -i “fail|exception”

四 日志分析与集中化

• 使用 ELK Stack（Elasticsearch + Logstash + Kibana）、Graylog 或 Splunk 做集中采集、检索与可视化，将 /var/log/gitlab/ 与 systemd 日志统一接入，配置索引生命周期与告警规则，便于容量规划与异常检测。
• 在 CI/CD 中通过 GitLab API 拉取作业日志进行归档与二次分析（例如审计、合规与性能回溯）。

五 Docker 部署的日志管理要点

• 运行容器时将日志目录挂载到宿主机，便于外部采集与归档：
  • -v /home/www/gitlab/log:/var/log/gitlab
• 容器内仍可用 gitlab-ctl tail 与常规路径访问日志；宿主机可直接对挂载目录执行 logrotate、Fluentd/Filebeat 采集等运维操作。