ubuntu上gitlab监控与告警设置

Ubuntu上GitLab监控与告警设置指南

在Ubuntu系统上，GitLab的监控与告警可通过自带的轻量级工具或第三方开源解决方案（如Prometheus+Grafana）实现。以下是具体配置步骤：

一、使用Prometheus+Grafana实现专业监控告警

1. 安装与配置Prometheus（指标收集）

Prometheus是开源的时序数据库，负责从GitLab收集性能指标。

安装Prometheus：
通过APT快速安装：sudo apt-get update && sudo apt-get install prometheus。
配置GitLab监控目标：
编辑Prometheus主配置文件/etc/prometheus/prometheus.yml，添加GitLab监控任务：
```
scrape_configs:
  - job_name: 'gitlab'
    static_configs:
      - targets: ['localhost:8080']  # GitLab默认暴露指标的端口（需确认GitLab配置）
```
若GitLab部署在远程服务器，需将localhost替换为服务器IP，并确保防火墙开放8080端口。
启动Prometheus：
执行sudo systemctl start prometheus并设置开机自启：sudo systemctl enable prometheus。
验证连接：
访问http://<Ubuntu_IP>:9090/targets，若GitLab目标状态显示“UP”，则表示连接成功。

2. 安装与配置Grafana（可视化与告警）

Grafana是基于Prometheus的可视化工具，用于创建仪表盘和告警规则。

安装Grafana：
通过APT安装：sudo apt-get install grafana。
配置Prometheus数据源：
访问http://<Ubuntu_IP>:3000（默认用户名/密码：admin/admin），进入“Configuration→Data Sources”，添加Prometheus数据源，填写URL为http://localhost:9090，点击“Save & Test”验证连通性。
创建监控仪表盘：
点击“+”→“Dashboard”，添加“Graph”面板，输入GitLab指标（如gitlab_rails_database_queries_seconds_max表示数据库查询耗时、process_cpu_seconds_total表示GitLab进程CPU使用率），设置可视化选项（如折线图、阈值颜色）。

设置告警规则：
在Grafana中点击“Alerting→Alert Rules”，新建规则组（如“GitLab Alerts”），添加告警规则：

- alert: HighGitLabCPU
  expr: process_cpu_seconds_total{job="gitlab"} > 0.8  # CPU使用率超过80%
  for: 1m  # 持续1分钟触发
  labels:
    severity: warning
  annotations:
    summary: "GitLab CPU usage is high ({{ $value }})"
    description: "GitLab process CPU usage has exceeded 80% for 1 minute."

配置通知渠道（如邮件、Slack）：进入“Alerting→Notification channels”，添加对应渠道的配置（如SMTP邮件服务器），并在告警规则中关联该渠道。

二、使用GitLab自带监控功能（轻量级方案）

GitLab内置了基础的监控能力，适合快速查看实例健康状态。

启用GitLab指标：
编辑GitLab主配置文件/etc/gitlab/gitlab.rb，开启指标收集：
```
gitlab_rails['gitlab_metrics_enabled'] = true
gitlab_runner['metrics_enabled'] = true
global['monitoring_enabled'] = true
```
执行sudo gitlab-ctl reconfigure使配置生效。
创建自监控项目：
进入GitLab控制台，导航至“Projects→New Project”，名称填写“Monitoring”，勾选“Create from template”→“Self Monitoring”，创建后GitLab会自动收集实例指标并展示在项目仪表盘中。
查看内置指标：
访问GitLab控制台的“Admin Area→Monitoring→Metrics”，可查看CPU、内存、数据库查询等基础指标；“Admin Area→Monitoring→Alerts”可配置邮件、Slack等通知方式（如设置当“Failed jobs”超过阈值时发送邮件）。

三、第三方监控工具补充

若需要更全面的监控（如网络、磁盘），可集成第三方工具：

Zabbix：支持服务器、应用层监控，配置GitLab为Zabbix agent节点，通过模板收集指标并设置告警。
Datadog/New Relic：商业工具，提供GitLab专用集成插件，支持实时性能分析、异常检测和多渠道通知。

四、注意事项

权限与安全：Prometheus和Grafana需配置防火墙规则，仅允许可信IP访问；Grafana通知渠道的敏感信息（如SMTP密码）需妥善保管。
版本兼容性：确保Prometheus、Grafana版本与GitLab版本兼容（参考官方文档）。
定期维护：定期审查告警规则（如调整CPU阈值），清理过期仪表盘，避免误报。