GitLab Linux版系统状态监控实践
一 监控体系概览
- 使用GitLab 自带监控：在管理员区域进入Administration Area > Monitoring查看实例健康与性能指标；开启**Performance Bar（Admin Area > Settings > Metrics and Profiling > Profiling - Performance bar）**可在页面端快速定位单次请求的耗时分布。
- 采用Prometheus + Grafana：GitLab默认集成并启用Prometheus，配合各类Exporter（如node_exporter、redis_exporter、postgres_exporter）采集主机与组件指标；用Grafana做可视化与告警。
- 做好日志与系统级监控：通过命令行与系统工具实时查看服务状态与资源瓶颈，配合日志分析定位问题。
二 快速检查与内置监控
- 服务运行状态：执行sudo gitlab-ctl status，快速确认Unicorn/NGINX/Sidekiq/PostgreSQL/Redis等组件是否健康。
- 实时日志排查：执行sudo gitlab-ctl tail查看全局日志；或指定组件，如sudo gitlab-ctl tail gitlab-rails、sudo gitlab-ctl tail nginx/gitlab_error.log。
- Web 端内置监控：进入Administration Area > Monitoring查看CPU、内存、磁盘空间、网络流量等；开发/排障时开启Performance Bar观察接口与 SQL 耗时。
三 Prometheus Grafana 集成步骤
- 确认采集目标：GitLab 默认启用Prometheus；确保各组件Exporter已部署并暴露**/metrics**。
- 配置 Prometheus：在prometheus.yml添加抓取任务（示例）：
- job_name: ‘gitlab’
static_configs:
- targets: [‘your-gitlab-server-ip:8080’] # 以实际GitLab Prometheus抓取端口为准
- 配置 Grafana：添加Prometheus数据源，导入GitLab Overview等仪表盘，展示请求延迟、错误率、数据库/缓存性能等。
- 告警示例（Prometheus 规则）：
- groups:
- name: gitlab_alerts
rules:
- alert: GitLabHighCPU
expr: node_cpu_seconds_total{job=“gitlab”} > 0.8 for: 1m
labels: {severity: warning}
annotations:
summary: “High CPU Usage on GitLab Server”
description: “CPU usage is above 80%”
以上步骤完成后，即可获得指标存储、可视化与告警的完整链路。
四 系统级监控与日志管理
- 常用命令：
- 资源与负载：top/htop、vmstat 1、iostat -x 1、free -m、df -h
- 网络与端口：ss -tulpen | grep -E ‘(:80|:443|:8080)’
- 日志路径与轮转：
- 关键路径：/var/log/gitlab/（如gitlab-rails/production.log、nginx/error.log、postgresql/postgresql-main.log）
- 实时查看：sudo tail -f /var/log/gitlab/gitlab-rails/production.log
- 日志轮转：GitLab内置logrotate，可在**/etc/gitlab/gitlab.rb**中自定义保留策略与压缩方式。
五 告警与第三方监控
- 告警通知：在Prometheus中配置Alertmanager或通过Grafana通知渠道（如邮件、Slack、Webhook）发送告警，覆盖CPU、内存、磁盘、响应时延等关键指标。
- 第三方与 API：
- 企业级监控：Zabbix、New Relic、Datadog等可与 GitLab 集成，提供更强的异常检测与告警能力。
- GitLab API：使用curl获取实例状态，例如：
- curl --header “PRIVATE-TOKEN: <your_access_token>” “http://your-gitlab-url/api/v4/system/status”
