使用 Prometheus 监控极狐GitLab

Prometheus是一个强大的时序监控服务,为极狐GitLab 等软件产品的监控提供了一个灵活的平台。

极狐GitLab 通过 Prometheus 提供开箱即用的监控,您可以访问极狐GitLab 服务的高质量时间序列监控。

Prometheus 和此页面中列出的各种 exporter 捆绑在 Linux GitLab 包中。检查每个 exporter 的文档,了解添加它们的时间线。对于源安装实例,您必须自己安装。在后续版本中,会抓取更多的极狐GitLab 指标。

Prometheus 服务默认开启。

Prometheus 及其 exporter 不对用户进行身份验证,任何可以访问它们的人都可以使用它们。

概览

Prometheus 通过定期连接到数据源,并通过各种 exporter 收集其性能指标来工作。要查看和使用监控数据,您可以直接连接到 Prometheus,或使用 Grafana 等仪表盘工具。

配置 Prometheus

对于源安装实例,您必须自己安装和配置。

Prometheus 及其 exporter 默认开启。 Prometheus 以 gitlab-prometheus 用户身份运行,并监听 http://localhost:9090。默认情况下,Prometheus 只能从 GitLab 服务器本身访问。 每个 exporter 都会自动设置为 Prometheus 的监控目标,除非单独禁用。

要禁用 Prometheus 及其所有 exporter,以及将来添加的任何 exporter:

  1. 编辑 /etc/gitlab/gitlab.rb
  2. 添加或查找并取消注释以下行,确保将其设置为 false

    prometheus_monitoring['enable'] = false
    
  3. 保存文件并重新配置极狐GitLab,使更改生效。

更改 Prometheus 监听的端口和地址

caution尽管可能,但不建议更改 Prometheus 侦听的端口,因为这可能会影响或与 GitLab 服务器上运行的其他服务发生冲突,继续操作需要您自担风险。

要从 GitLab 服务器外部访问 Prometheus,请更改 Prometheus 侦听的地址/端口:

  1. 编辑 /etc/gitlab/gitlab.rb
  2. 添加或查找并取消注释以下行:

    prometheus['listen_address'] = 'localhost:9090'
    

    localhost:9090 替换为您希望 Prometheus 监听的地址或端口。如果您希望允许除 localhost 以外的主机访问 Prometheus,请省略主机,或使用 0.0.0.0 允许公共访问:

    prometheus['listen_address'] = ':9090'
    # or
    prometheus['listen_address'] = '0.0.0.0:9090'
    
  3. 保存文件并重新配置 GitLab,使更改生效。

添加自定义抓取配置

您可以使用 Prometheus 抓取目标配置语法通过编辑 /etc/gitlab/gitlab.rb 中的 prometheus['scrape_configs'] 来为 Linux 包捆绑的 Prometheus 配置其他抓取目标。

以下是抓取 http://1.1.1.1:8060/probe?param_a=test&param_b=additional_test 的示例配置:

prometheus['scrape_configs'] = [
  {
    'job_name': 'custom-scrape',
    'metrics_path': '/probe',
    'params' => {
      'param_a' => ['test'],
      'param_b' => ['additional_test']
    },
    'static_configs' => [
      'targets' => ['1.1.1.1:8060'],
    ],
  },
]

使用 Linux 软件包的独立 Prometheus

Linux 软件包可用于配置运行 Prometheus 和 Grafana 的独立监控节点。

以下步骤是使用 Linux 软件包配置运行 Prometheus 和 Grafana 的监控节点的最低要求:

  1. SSH 进入监控节点。
  2. 安装使用极狐GitLab 下载页面中的 步骤 1 和 2 的 Linux 软件包,但不要按照其余步骤操作。
  3. 确保收集 Consul 服务器节点的 IP 地址或 DNS 记录,以进行下一步。
  4. 编辑 /etc/gitlab/gitlab.rb 并添加内容:

    roles ['monitoring_role']
    
    external_url 'http://gitlab.example.com'
    
    # Prometheus
    prometheus['listen_address'] = '0.0.0.0:9090'
    prometheus['monitor_kubernetes'] = false
    
    # Grafana
    grafana['enable'] = true
    grafana['admin_password'] = 'toomanysecrets'
    grafana['disable_login_form'] = false
    
    # Enable service discovery for Prometheus
    consul['enable'] = true
    consul['monitoring_service_discovery'] = true
    consul['configuration'] = {
       retry_join: %w(10.0.0.1 10.0.0.2 10.0.0.3), # The addresses can be IPs or FQDNs
    }
    
    # Nginx - For Grafana access
    nginx['enable'] = true
    
  5. 运行 sudo gitlab-ctl reconfigure 来编译配置。

下一步是告诉所有其它节点,监控节点在哪里:

  1. 编辑 /etc/gitlab/gitlab.rb,添加或查找并取消注释以下行:

    gitlab_rails['prometheus_address'] = '10.0.0.1:9090'
    

    其中 10.0.0.1:9090 是 Prometheus 节点的 IP 地址和端口。

  2. 保存文件并重新配置极狐GitLab,使更改生效。

在使用 consul['monitoring_service_discovery'] = true 启用使用 Service Discovery 进行监视后,请确保在 /etc/gitlab/gitlab.rb 中未设置 prometheus['scrape_configs']。在 /etc/gitlab/gitlab.rb 中同时设置 consul['monitoring_service_discovery'] = trueprometheus['scrape_configs'] 会导致错误。

使用外部 Prometheus 服务器

cautionPrometheus 和大多数 exporter 不支持身份验证。我们不建议将它们暴露在本地网络之外。

需要进行一些配置更改来允许极狐GitLab 由外部 Prometheus 服务器监控。对于具有多个节点的极狐GitLab 部署实例,建议使用外部服务器。

要使用外部 Prometheus 服务器:

  1. 编辑 /etc/gitlab/gitlab.rb
  2. 禁用捆绑的 Prometheus:

    prometheus['enable'] = false
    
  3. 将每个捆绑服务的 exporter 设置为侦听网络地址,例如:

    node_exporter['listen_address'] = '0.0.0.0:9100'
    gitlab_workhorse['prometheus_listen_addr'] = "0.0.0.0:9229"
    
    # Rails nodes
    gitlab_exporter['listen_address'] = '0.0.0.0'
    gitlab_exporter['listen_port'] = '9168'
    
    # Sidekiq nodes
    sidekiq['listen_address'] = '0.0.0.0'
    
    # Redis nodes
    redis_exporter['listen_address'] = '0.0.0.0:9121'
    
    # PostgreSQL nodes
    postgres_exporter['listen_address'] = '0.0.0.0:9187'
    
    # Gitaly nodes
    gitaly['prometheus_listen_addr'] = "0.0.0.0:9236"
    
  4. 如有必要,使用官方安装说明,安装并设置专用的 Prometheus 实例。
  5. 将 Prometheus 服务器 IP 地址添加到监控 IP 许可列表。例如:

    gitlab_rails['monitoring_whitelist'] = ['127.0.0.0/8', '192.168.0.1']
    
  6. 所有 GitLab Rails(Puma, Sidekiq) 服务器上,设置 Prometheus 服务器 IP 地址和监听端口。 例如:

    gitlab_rails['prometheus_address'] = '192.168.0.1:9090'
    
  7. 要抓取 NGINX 指标,您还必须配置 NGINX 来允许 Prometheus 服务器 IP。例如:

    nginx['status']['options'] = {
          "server_tokens" => "off",
          "access_log" => "off",
          "allow" => "192.168.0.1",
          "deny" => "all",
    }
    
  8. 重新配置极狐GitLab,应用更改。
  9. 编辑 Prometheus 服务器的配置文件。
  10. 将各个节点的 exporter 添加到 Prometheus 服务器的抓取目标配置。例如,使用 static_configs 的示例片段:

    scrape_configs:
      - job_name: nginx
        static_configs:
          - targets:
            - 1.1.1.1:8060
      - job_name: redis
        static_configs:
          - targets:
            - 1.1.1.1:9121
      - job_name: postgres
        static_configs:
          - targets:
            - 1.1.1.1:9187
      - job_name: node
        static_configs:
          - targets:
            - 1.1.1.1:9100
      - job_name: gitlab-workhorse
        static_configs:
          - targets:
            - 1.1.1.1:9229
      - job_name: gitlab-rails
        metrics_path: "/-/metrics"
        scheme: https
        static_configs:
          - targets:
            - 1.1.1.1
      - job_name: gitlab-sidekiq
        static_configs:
          - targets:
            - 1.1.1.1:8082
      - job_name: gitlab_exporter_database
        metrics_path: "/database"
        static_configs:
          - targets:
            - 1.1.1.1:9168
      - job_name: gitlab_exporter_sidekiq
        metrics_path: "/sidekiq"
        static_configs:
          - targets:
            - 1.1.1.1:9168
      - job_name: gitaly
        static_configs:
          - targets:
            - 1.1.1.1:9236
    
    caution片段中的 gitlab-rails 作业假设极狐GitLab 可以通过 HTTPS 访问。如果您的部署不使用 HTTPS,则作业配置将调整为使用 http 方案和端口 80。
  11. 重新加载 Prometheus 服务器。

配置存储保留大小

Prometheus 有几个自定义标志来配置本地存储:

  • storage.tsdb.retention.time:何时删除旧数据。默认为 15d。如果此标志设置为默认值以外的任何值,则覆盖 storage.tsdb.retention
  • storage.tsdb.retention.size:(实验性)要保留的存储块的最大字节数。首先删除最旧的数据。默认为 0(禁用)。此标志是实验性的,可能会在未来的版本中更改。支持的单位:BKBMBGBTBPBEB。例如,512MB

要配置存储保留大小:

  1. 编辑 /etc/gitlab/gitlab.rb

    prometheus['flags'] = {
      'storage.tsdb.path' => "/var/opt/gitlab/prometheus/data",
      'storage.tsdb.retention.time' => "7d",
      'storage.tsdb.retention.size' => "2GB",
      'config.file' => "/var/opt/gitlab/prometheus/prometheus.yml"
    }
    
  2. 重新配置极狐GitLab:

    sudo gitlab-ctl reconfigure
    

查看性能指标

您可以访问 Prometheus 默认提供的仪表盘 http://localhost:9090

如果您的极狐GitLab 实例上启用了 SSL,如果由于 HSTS 使用相同的 FQDN,您可能无法在与极狐GitLab 相同的浏览器上访问 Prometheus。

Prometheus 收集的性能数据可以直接在 Prometheus 控制台中查看,也可以通过兼容的仪表盘工具查看。 Prometheus 界面提供了一种灵活的查询语言来处理收集的数据,您可以在其中可视化输出。 对于功能更全的仪表盘,可以使用 Grafana,并且官方支持 Prometheus

Prometheus 查询示例:

  • % Memory available: ((node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes) or ((node_memory_MemFree_bytes + node_memory_Buffers_bytes + node_memory_Cached_bytes) / node_memory_MemTotal_bytes)) * 100
  • % CPU utilization: 1 - avg without (mode,cpu) (rate(node_cpu_seconds_total{mode="idle"}[5m]))
  • Data transmitted: rate(node_network_transmit_bytes_total{device!="lo"}[5m])
  • Data received: rate(node_network_receive_bytes_total{device!="lo"}[5m])

Prometheus 作为 Grafana 数据源

Grafana 允许您将 Prometheus 性能指标作为数据源导入,并将指标呈现为图形和仪表盘,这有助于可视化。

要为单节点极狐GitLab 设置添加 Prometheus 仪表板:

  1. 在 Grafana 中新建一个数据源。
  2. 命名您的数据源(例如 GitLab)。
  3. 在类型下拉框中选择 Prometheus
  4. 添加您的 Prometheus 监听地址作为 URL,并设置访问 Browser
  5. 将 HTTP 方法设置为 GET
  6. 保存并测试您的配置,验证它是否有效。

极狐GitLab 指标

极狐GitLab 监控自己的内部服务指标,并在 /-/metrics 端点提供这些指标。与其他 exporter 不同,此端点需要身份验证,因为它与用户流量在相同的 URL 和端口上可用。

阅读有关极狐GitLab 指标的更多信息。

捆绑软件指标

Linux 软件包中捆绑的许多极狐GitLab 依赖项已预先配置为导出 Prometheus 指标。

Node exporter

Node exporter 允许您测量各种机器资源,例如内存、磁盘和 CPU 利用率。

阅读更多关于 node exporter 的内容

Web exporter

Web exporter 是一个专用的指标服务器,它允许将最终用户和 Prometheus 流量拆分为两个独立的应用程序,以提高性能和可用性。

阅读更多关于 web exporter 的内容

Redis exporter

Redis exporter 允许您测量各种 Redis 指标。

阅读更多关于 Redis exporter 的内容

PostgreSQL exporter

PostgreSQL exporter 允许您测量各种 PostgreSQL 指标。

阅读更多关于 PostgreSQL exporter 的内容

PgBouncer exporter

PgBouncer exporter 允许您测量各种 PgBouncer 指标。

阅读更多关于 PgBouncer exporter 的内容

Registry exporter

Registry exporter 允许您测量各种 Registry 指标。

阅读更多关于 Registry exporter 的内容

GitLab exporter

GitLab exporter 允许您测量从 Redis 和数据库中提取的各种极狐GitLab 指标。

阅读更多关于 GitLab exporter 的内容

故障排查

/var/opt/gitlab/prometheus 占用太多磁盘空间

如果您使用 Prometheus 监控:

  1. 禁用 Prometheus
  2. 删除 /var/opt/gitlab/prometheus 下的数据。

如果您使用 Prometheus 监控:

  1. 停止 Prometheus(在运行时删除数据会导致数据损坏):

    gitlab-ctl stop prometheus
    
  2. 删除/var/opt/gitlab/prometheus/data下的数据。
  3. 再次启动服务:

    gitlab-ctl start prometheus
    
  4. 验证服务是否已启动并正在运行:

    gitlab-ctl status prometheus
    
  5. 可选。配置存储保留大小

监控节点未收到数据

如果监控节点没有收到任何数据,请检查导出器是否正在捕获数据:

curl "http[s]://localhost:<EXPORTER LISTENING PORT>/metrics"

或者

curl "http[s]://localhost:<EXPORTER LISTENING PORT>/-/metrics"