Ubuntu GitLab监控与日志分析指南

一、Ubuntu GitLab监控方法

1. GitLab内建监控工具

GitLab提供内置监控功能，可通过Web界面查看核心指标。操作路径：登录GitLab → 点击顶部导航栏「Administration Area」→ 选择「Settings」→ 进入「Monitoring」页面。在此可查看响应时间、错误率、系统负载等基础性能指标，帮助快速识别实例健康状态。

2. 系统级监控工具

利用Ubuntu自带的命令行工具实时监控系统资源使用情况：

• top/htop：实时查看GitLab进程的CPU、内存占用（如top -p $(pgrep -f gitlab)）；
• vmstat/iostat：监控系统整体资源（如vmstat 1查看内存/磁盘I/O，iostat -x 1查看磁盘详细使用情况）；
• free：查看内存使用情况（如free -h以人类可读格式显示）。

3. 第三方监控工具（Prometheus+Grafana）

Prometheus（开源监控系统）+ Grafana（可视化平台）是GitLab监控的主流组合：

• 配置Prometheus：编辑/etc/prometheus/prometheus.yml，添加GitLab监控目标：

  scrape_configs:
    - job_name: 'gitlab'
      static_configs:
        - targets: ['your_gitlab_server_address:8080']  # GitLab默认暴露8080端口
  

• 配置Grafana：添加Prometheus为数据源（填写Prometheus URL），导入GitLab预设仪表盘（如ID 11863，包含CPU、内存、请求延迟等面板），实现可视化监控。

4. GitLab API监控

通过GitLab REST API获取实例状态及性能数据，适合自动化监控：

• 示例命令：使用curl获取系统状态（需替换PRIVATE-TOKEN为有效Token）：

  curl --header "PRIVATE-TOKEN: <your_token>" "http://your_gitlab_server/api/v4/system/status"
  

  返回结果包含GitLab运行状态（status字段）、数据库连接情况等信息。

二、Ubuntu GitLab日志分析与处理

1. 日志查看方法

GitLab日志集中存储在/var/log/gitlab目录下，常用查看方式：

• gitlab-ctl命令（GitLab自带工具）：
  • 实时查看所有日志：sudo gitlab-ctl tail；
  • 查看特定服务日志（如Nginx错误日志）：sudo gitlab-ctl tail nginx/gitlab_error.log；
  • 查看Rails应用日志：sudo gitlab-ctl tail gitlab-rails/production.log。
• 直接查看日志文件：
  • 使用cat/less查看静态日志（如sudo cat /var/log/gitlab/gitlab-rails/production.log）；
  • 使用tail -f实时监控日志变化（如sudo tail -f /var/log/gitlab/gitlab-rails/production.log）。
• journalctl命令（systemd工具）：
  • 查看所有GitLab服务日志：sudo journalctl -u gitlab；
  • 查看指定时间范围日志（如2025年9月1日至9月30日）：sudo journalctl --since "2025-09-01" --until "2025-09-30"。

2. 日志分析与工具

• 基本命令分析：
  • 搜索错误信息（忽略大小写）：grep -i "error" /var/log/gitlab/gitlab-rails/production.log；
  • 统计错误数量：grep -c "error" /var/log/gitlab/gitlab-rails/production.log；
  • 查看最近10条错误日志：tail -n 10 /var/log/gitlab/gitlab-rails/production.log | grep "error"。
• 日志分析工具：
  • ELK Stack（Elasticsearch+Logstash+Kibana）：收集、存储GitLab日志，通过Kibana创建可视化 dashboard（如请求频率、错误分布），支持全文搜索和异常检测；
  • Graylog：开源SIEM平台，集中管理GitLab日志，提供实时告警、日志关联分析功能；
  • Splunk：商业化工具，支持高级日志分析（如趋势预测、根因分析），适合企业级场景。

3. 日志轮转管理

GitLab内置logrotate服务，自动切割、压缩旧日志（避免单个日志文件过大）。自定义配置路径：/etc/gitlab/gitlab.rb，常见参数：

• gitlab_rails['logrotate_max_size']：单个日志文件最大大小（如100MB）；
• gitlab_rails['logrotate_keep_time']：日志保留时间（如30天）；
• 修改后需运行sudo gitlab-ctl reconfigure使配置生效。