Linux中GitLab的监控如何搭建

一、前置准备 在Linux系统（如CentOS、Ubuntu）上搭建GitLab监控前，需确保已安装GitLab且服务正常运行。可通过gitlab-ctl status（源安装）或systemctl status gitlab-runsvdir（RPM安装）检查GitLab状态。

二、启用GitLab自监控功能 GitLab内置了Prometheus指标导出功能，需通过配置文件开启：

1. 编辑GitLab主配置文件（路径因安装方式而异，源安装为/etc/gitlab/gitlab.rb，RPM安装为/etc/gitlab/gitlab.rb），添加以下配置：

   gitlab_rails['prometheus_enable'] = true
   gitlab_rails['prometheus_port'] = 9090  # 指标端口（默认9090，可自定义）
   gitlab_rails['prometheus_address'] = '0.0.0.0'  # 监听所有IP
   

2. 重新配置GitLab使设置生效：

   sudo gitlab-ctl reconfigure
   sudo gitlab-ctl restart
   

3. 验证指标是否可访问：在浏览器或终端输入http://<GitLab服务器IP>:9090/metrics，若能看到GitLab相关的指标（如gitlab_rails_database_queries_seconds、sidekiq_queue_size），则说明自监控已开启。

三、安装与配置Prometheus采集GitLab指标 Prometheus是开源时序数据库，用于收集、存储GitLab指标，步骤如下：

1. 安装Prometheus：
   • 下载最新版本（如prometheus-2.40.0.linux-amd64.tar.gz），解压后进入目录：

     wget https://github.com/prometheus/prometheus/releases/download/v2.40.0/prometheus-2.40.0.linux-amd64.tar.gz
     tar xvfz prometheus-2.40.0.linux-amd64.tar.gz
     cd prometheus-2.40.0.linux-amd64
     

   • 启动Prometheus（前台模式，生产环境建议用systemd或Docker）：

     ./prometheus --config.file=prometheus.yml
     

2. 配置Prometheus抓取GitLab指标：
   编辑prometheus.yml，添加GitLab的scrape_configs：

   scrape_configs:
     - job_name: 'gitlab'
       static_configs:
         - targets: ['<GitLab服务器IP>:9090']  # 替换为GitLab服务器IP
   

   若GitLab启用了认证，需添加basic_auth或bearer_token_file配置。
3. 验证Prometheus是否采集到GitLab指标：
   访问Prometheus Web界面（默认http://<Prometheus服务器IP>:9090），在“Graph”页面输入gitlab_rails_up（GitLab状态指标），若返回值为1，则表示采集成功。

四、配置Grafana可视化监控 Grafana是开源可视化工具，可与Prometheus集成，创建直观的监控仪表盘：

1. 安装Grafana：
   • 下载最新版本（如grafana-10.0.0.linux-amd64.tar.gz），解压后进入目录：

     wget https://dl.grafana.com/oss/release/grafana-10.0.0.linux-amd64.tar.gz
     tar -zxvf grafana-10.0.0.linux-amd64.tar.gz
     cd grafana-10.0.0
     

   • 启动Grafana：

     ./bin/grafana-server
     

   生产环境建议用systemd管理（参考Grafana官方文档）。
2. 添加Prometheus数据源：
   • 访问Grafana Web界面（默认http://<Grafana服务器IP>:3000），登录（默认账号admin，密码admin，首次登录需修改密码）。
   • 进入“Configuration”→“Data Sources”，点击“Add data source”，选择“Prometheus”。
   • 输入Prometheus服务器地址（如http://<Prometheus服务器IP>:9090），点击“Save & test”，确认连接成功。
3. 导入GitLab监控仪表盘：
   • 在Grafana界面点击“+”→“Dashboard”，选择“Import”。
   • 输入GitLab官方提供的仪表盘ID（如4385，涵盖CPU、内存、作业等指标），点击“Load”，然后选择Prometheus数据源，点击“Import”即可查看可视化面板。

五、设置Alertmanager报警 Alertmanager用于处理Prometheus的报警规则，并通过邮件、Slack等方式通知管理员：

1. 安装Alertmanager：
   • 下载最新版本（如alertmanager-0.26.0.linux-amd64.tar.gz），解压后进入目录：

     wget https://github.com/prometheus/alertmanager/releases/download/v0.26.0/alertmanager-0.26.0.linux-amd64.tar.gz
     tar xvfz alertmanager-0.26.0.linux-amd64.tar.gz
     cd alertmanager-0.26.0.linux-amd64
     

   • 启动Alertmanager：

     ./alertmanager --config.file=alertmanager.yml
     

2. 配置Alertmanager：
   编辑alertmanager.yml，设置报警接收方式（以邮件为例）：

   global:
     smtp_smarthost: 'smtp.example.com:587'
     smtp_from: 'alertmanager@example.com'
     smtp_auth_username: 'username'
     smtp_auth_password: 'password'
   route:
     receiver: 'email'
   receivers:
     - name: 'email'
       email_configs:
         - to: 'admin@example.com'
   

3. 定义GitLab报警规则：
   在Prometheus中创建alerts.yml文件，添加GitLab报警规则（如CPU使用率超过80%、内存不足）：

   groups:
     - name: gitlab_alerts
       rules:
         - alert: GitLabHighCPU
           expr: sum(gitlab_rails_process_cpu_seconds_total) / count(gitlab_rails_process_cpu_seconds_total) > 0.8
           for: 5m
           labels:
             severity: warning
           annotations:
             summary: "GitLab CPU usage is high (instance {{ $labels.instance }})"
             description: "GitLab CPU usage has exceeded 80% for 5 minutes."
         - alert: GitLabHighMemory
           expr: sum(gitlab_rails_process_resident_memory_bytes) / 1024 / 1024 > 2048  # 内存超过2GB
           for: 5m
           labels:
             severity: warning
           annotations:
             summary: "GitLab memory usage is high (instance {{ $labels.instance }})"
             description: "GitLab memory usage has exceeded 2GB for 5 minutes."
   

   在Prometheus的prometheus.yml中加载报警规则：

   rule_files:
     - "/path/to/alerts.yml"
   

   重启Prometheus使规则生效。
4. 测试报警：
   可通过调整报警阈值（如将0.8改为0.1）触发报警，检查是否收到邮件通知。

六、可选：使用GitLab内置监控面板 GitLab Admin Area提供了内置的监控面板，无需额外安装工具：

1. 登录GitLab，进入“Admin Area”（管理区域）。
2. 点击“Monitoring”→“Metrics”，即可查看GitLab实例的CPU、内存、磁盘空间、作业队列等关键指标。

七、系统级辅助监控 除上述工具外，可使用Linux系统自带工具辅助监控GitLab所在服务器的整体状态：

• top/htop：实时查看进程CPU、内存占用（top按P键按CPU排序，M键按内存排序）。
• vmstat：查看系统虚拟内存、CPU、磁盘I/O统计（vmstat 1 5每秒刷新一次，共5次）。
• free：查看内存使用情况（free -h以人类可读格式显示）。
• iostat：查看磁盘I/O性能（iostat -x 1查看详细磁盘统计）。
• netstat/ss：查看网络连接状态（ss -tulnp查看监听端口）。