Commit cdc5c973 authored by Adrien Kohlbecker's avatar Adrien Kohlbecker Committed by Mike Lewis

Rename gitlab-monitor -> gitlab-exporter

As part of https://gitlab.com/gitlab-org/gitlab-ce/issues/61704 we want
to rename gitlab-monitor to gitlab-exporter, to be less confusing and
better align with naming conventions in the community.
parent cc99c9f4
---
title: Update docs to reflect the rename of gitlab-monitor to gitlab-exporter
merge_request: 31901
author:
type: other
...@@ -183,7 +183,7 @@ Configure the tracking database. ...@@ -183,7 +183,7 @@ Configure the tracking database.
alertmanager['enable'] = false alertmanager['enable'] = false
consul['enable'] = false consul['enable'] = false
gitaly['enable'] = false gitaly['enable'] = false
gitlab_monitor['enable'] = false gitlab_exporter['enable'] = false
gitlab_workhorse['enable'] = false gitlab_workhorse['enable'] = false
nginx['enable'] = false nginx['enable'] = false
node_exporter['enable'] = false node_exporter['enable'] = false
......
...@@ -67,7 +67,7 @@ deploy the bundled PostgreSQL. ...@@ -67,7 +67,7 @@ deploy the bundled PostgreSQL.
alertmanager['enable'] = false alertmanager['enable'] = false
pgbouncer_exporter['enable'] = false pgbouncer_exporter['enable'] = false
redis_exporter['enable'] = false redis_exporter['enable'] = false
gitlab_monitor['enable'] = false gitlab_exporter['enable'] = false
postgresql['listen_address'] = '0.0.0.0' postgresql['listen_address'] = '0.0.0.0'
postgresql['port'] = 5432 postgresql['port'] = 5432
......
...@@ -53,7 +53,7 @@ Omnibus: ...@@ -53,7 +53,7 @@ Omnibus:
gitlab_rails['auto_migrate'] = false gitlab_rails['auto_migrate'] = false
alertmanager['enable'] = false alertmanager['enable'] = false
gitaly['enable'] = false gitaly['enable'] = false
gitlab_monitor['enable'] = false gitlab_exporter['enable'] = false
gitlab_workhorse['enable'] = false gitlab_workhorse['enable'] = false
nginx['enable'] = true nginx['enable'] = true
postgres_exporter['enable'] = false postgres_exporter['enable'] = false
......
...@@ -64,7 +64,7 @@ Omnibus: ...@@ -64,7 +64,7 @@ Omnibus:
prometheus['enable'] = false prometheus['enable'] = false
alertmanager['enable'] = false alertmanager['enable'] = false
pgbouncer_exporter['enable'] = false pgbouncer_exporter['enable'] = false
gitlab_monitor['enable'] = false gitlab_exporter['enable'] = false
gitaly['enable'] = false gitaly['enable'] = false
redis['bind'] = '0.0.0.0' redis['bind'] = '0.0.0.0'
......
# GitLab monitor exporter # GitLab exporter
>**Note:** >**Note:**
Available since [Omnibus GitLab 8.17][1132]. For installations from source Available since [Omnibus GitLab 8.17][1132]. For installations from source
you'll have to install and configure it yourself. you'll have to install and configure it yourself.
The [GitLab monitor exporter] allows you to measure various GitLab metrics, pulled from Redis and the database. The [GitLab exporter] allows you to measure various GitLab metrics, pulled from Redis and the database.
To enable the GitLab monitor exporter: To enable the GitLab exporter:
1. [Enable Prometheus](index.md#configuring-prometheus) 1. [Enable Prometheus](index.md#configuring-prometheus)
1. Edit `/etc/gitlab/gitlab.rb` 1. Edit `/etc/gitlab/gitlab.rb`
1. Add or find and uncomment the following line, making sure it's set to `true`: 1. Add or find and uncomment the following line, making sure it's set to `true`:
```ruby ```ruby
gitlab_monitor['enable'] = true gitlab_exporter['enable'] = true
``` ```
1. Save the file and [reconfigure GitLab][reconfigure] for the changes to 1. Save the file and [reconfigure GitLab][reconfigure] for the changes to
take effect take effect
Prometheus will now automatically begin collecting performance data from Prometheus will now automatically begin collecting performance data from
the GitLab monitor exporter exposed under `localhost:9168`. the GitLab exporter exposed under `localhost:9168`.
[← Back to the main Prometheus page](index.md) [← Back to the main Prometheus page](index.md)
[1132]: https://gitlab.com/gitlab-org/omnibus-gitlab/merge_requests/1132 [1132]: https://gitlab.com/gitlab-org/omnibus-gitlab/merge_requests/1132
[GitLab monitor exporter]: https://gitlab.com/gitlab-org/gitlab-monitor [GitLab exporter]: https://gitlab.com/gitlab-org/gitlab-exporter
[prometheus]: https://prometheus.io [prometheus]: https://prometheus.io
[reconfigure]: ../../restart_gitlab.md#omnibus-gitlab-reconfigure [reconfigure]: ../../restart_gitlab.md#omnibus-gitlab-reconfigure
...@@ -97,9 +97,9 @@ To use an external Prometheus server: ...@@ -97,9 +97,9 @@ To use an external Prometheus server:
1. Set each bundled service's [exporter](#bundled-software-metrics) to listen on a network address, for example: 1. Set each bundled service's [exporter](#bundled-software-metrics) to listen on a network address, for example:
```ruby ```ruby
gitlab_monitor['listen_address'] = '0.0.0.0' gitlab_exporter['listen_address'] = '0.0.0.0'
sidekiq['listen_address'] = '0.0.0.0' sidekiq['listen_address'] = '0.0.0.0'
gitlab_monitor['listen_port'] = '9168' gitlab_exporter['listen_port'] = '9168'
node_exporter['listen_address'] = '0.0.0.0:9100' node_exporter['listen_address'] = '0.0.0.0:9100'
redis_exporter['listen_address'] = '0.0.0.0:9121' redis_exporter['listen_address'] = '0.0.0.0:9121'
postgres_exporter['listen_address'] = '0.0.0.0:9187' postgres_exporter['listen_address'] = '0.0.0.0:9187'
...@@ -163,17 +163,17 @@ To use an external Prometheus server: ...@@ -163,17 +163,17 @@ To use an external Prometheus server:
static_configs: static_configs:
- targets: - targets:
- 1.1.1.1:8082 - 1.1.1.1:8082
- job_name: gitlab_monitor_database - job_name: gitlab_exporter_database
metrics_path: "/database" metrics_path: "/database"
static_configs: static_configs:
- targets: - targets:
- 1.1.1.1:9168 - 1.1.1.1:9168
- job_name: gitlab_monitor_sidekiq - job_name: gitlab_exporter_sidekiq
metrics_path: "/sidekiq" metrics_path: "/sidekiq"
static_configs: static_configs:
- targets: - targets:
- 1.1.1.1:9168 - 1.1.1.1:9168
- job_name: gitlab_monitor_process - job_name: gitlab_exporter_process
metrics_path: "/process" metrics_path: "/process"
static_configs: static_configs:
- targets: - targets:
...@@ -263,11 +263,11 @@ The PgBouncer exporter allows you to measure various PgBouncer metrics. ...@@ -263,11 +263,11 @@ The PgBouncer exporter allows you to measure various PgBouncer metrics.
[➔ Read more about the PgBouncer exporter.](pgbouncer_exporter.md) [➔ Read more about the PgBouncer exporter.](pgbouncer_exporter.md)
### GitLab monitor exporter ### GitLab exporter
The GitLab monitor exporter allows you to measure various GitLab metrics, pulled from Redis and the database. The GitLab exporter allows you to measure various GitLab metrics, pulled from Redis and the database.
[➔ Read more about the GitLab monitor exporter.](gitlab_monitor_exporter.md) [➔ Read more about the GitLab exporter.](gitlab_exporter.md)
## Configuring Prometheus to monitor Kubernetes ## Configuring Prometheus to monitor Kubernetes
......
...@@ -78,11 +78,11 @@ graph TB ...@@ -78,11 +78,11 @@ graph TB
PgBouncerExporter[PgBouncer Exporter] --> PgBouncer PgBouncerExporter[PgBouncer Exporter] --> PgBouncer
Prometheus -- TCP 9187 --> PostgreSQLExporter Prometheus -- TCP 9187 --> PostgreSQLExporter
Prometheus -- TCP 9100 --> NodeExporter[Node Exporter] Prometheus -- TCP 9100 --> NodeExporter[Node Exporter]
Prometheus -- TCP 9168 --> GitLabMonitor[GitLab Monitor] Prometheus -- TCP 9168 --> GitLabExporter[GitLab Exporter]
Prometheus -- TCP 9127 --> PgBouncerExporter Prometheus -- TCP 9127 --> PgBouncerExporter
GitLabMonitor --> PostgreSQL GitLabExporter --> PostgreSQL
GitLabMonitor --> GitLabShell GitLabExporter --> GitLabShell
GitLabMonitor --> Sidekiq GitLabExporter --> Sidekiq
PgBouncer --> Consul PgBouncer --> Consul
PostgreSQL --> Consul PostgreSQL --> Consul
PgBouncer --> PostgreSQL PgBouncer --> PostgreSQL
...@@ -147,7 +147,7 @@ Component statuses are linked to configuration documentation for each component. ...@@ -147,7 +147,7 @@ Component statuses are linked to configuration documentation for each component.
| [Redis Exporter](#redis-exporter) | Prometheus endpoint with Redis metrics | [][redis-exporter-omnibus] | [][redis-exporter-charts] | [][redis-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE | | [Redis Exporter](#redis-exporter) | Prometheus endpoint with Redis metrics | [][redis-exporter-omnibus] | [][redis-exporter-charts] | [][redis-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE |
| [Postgres Exporter](#postgres-exporter) | Prometheus endpoint with PostgreSQL metrics | [][postgres-exporter-omnibus] | [][postgres-exporter-charts] | [][postgres-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE | | [Postgres Exporter](#postgres-exporter) | Prometheus endpoint with PostgreSQL metrics | [][postgres-exporter-omnibus] | [][postgres-exporter-charts] | [][postgres-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE |
| [PgBouncer Exporter](#pgbouncer-exporter) | Prometheus endpoint with PgBouncer metrics | [][pgbouncer-exporter-omnibus] | [][pgbouncer-exporter-charts] | [][pgbouncer-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE | | [PgBouncer Exporter](#pgbouncer-exporter) | Prometheus endpoint with PgBouncer metrics | [][pgbouncer-exporter-omnibus] | [][pgbouncer-exporter-charts] | [][pgbouncer-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE |
| [GitLab Monitor](#gitlab-monitor) | Generates a variety of GitLab metrics | [][gitlab-monitor-omnibus] | [][gitlab-monitor-charts] | [][gitlab-monitor-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE | | [GitLab Exporter](#gitlab-exporter) | Generates a variety of GitLab metrics | [][gitlab-exporter-omnibus] | [][gitlab-exporter-charts] | [][gitlab-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE |
| [Node Exporter](#node-exporter) | Prometheus endpoint with system metrics | [][node-exporter-omnibus] | [][node-exporter-charts] | [][node-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE | | [Node Exporter](#node-exporter) | Prometheus endpoint with system metrics | [][node-exporter-omnibus] | [][node-exporter-charts] | [][node-exporter-charts] | [](https://about.gitlab.com/handbook/engineering/monitoring/) | ❌ | ❌ | CE & EE |
| [Mattermost](#mattermost) | Open-source Slack alternative | [][mattermost-omnibus] | [][mattermost-charts] | [][mattermost-charts] | [](../user/project/integrations/mattermost.md) | ❌ | ❌ | CE & EE | | [Mattermost](#mattermost) | Open-source Slack alternative | [][mattermost-omnibus] | [][mattermost-charts] | [][mattermost-charts] | [](../user/project/integrations/mattermost.md) | ❌ | ❌ | CE & EE |
| [MinIO](#minio) | Object storage service | [][minio-omnibus] | [][minio-charts] | [][minio-charts] | [](https://about.gitlab.com/handbook/engineering/infrastructure/production-architecture/#storage-architecture) | ❌ | [][minio-gdk] | CE & EE | | [MinIO](#minio) | Object storage service | [][minio-omnibus] | [][minio-charts] | [][minio-charts] | [](https://about.gitlab.com/handbook/engineering/infrastructure/production-architecture/#storage-architecture) | ❌ | [][minio-gdk] | CE & EE |
...@@ -228,14 +228,14 @@ Gitaly is a service designed by GitLab to remove our need for NFS for Git storag ...@@ -228,14 +228,14 @@ Gitaly is a service designed by GitLab to remove our need for NFS for Git storag
- Configuration: [Omnibus][geo-omnibus], [Charts][geo-charts], [GDK][geo-gdk] - Configuration: [Omnibus][geo-omnibus], [Charts][geo-charts], [GDK][geo-gdk]
- Layer: Core Service (Processor) - Layer: Core Service (Processor)
#### GitLab Monitor #### Gitlab Exporter
- [Project page](https://gitlab.com/gitlab-org/gitlab-monitor) - [Project page](https://gitlab.com/gitlab-org/gitlab-exporter)
- Configuration: [Omnibus][gitlab-monitor-omnibus], [Charts][gitlab-monitor-charts] - Configuration: [Omnibus][gitlab-exporter-omnibus], [Charts][gitlab-exporter-charts]
- Layer: Monitoring - Layer: Monitoring
- Process: `gitlab-monitor` - Process: `gitlab-exporter`
GitLab Monitor is a process designed in house that allows us to export metrics about GitLab application internals to Prometheus. You can read more [in the project's readme](https://gitlab.com/gitlab-org/gitlab-monitor). GitLab Exporter is a process designed in house that allows us to export metrics about GitLab application internals to Prometheus. You can read more [in the project's readme](https://gitlab.com/gitlab-org/gitlab-exporter).
#### GitLab Pages #### GitLab Pages
...@@ -684,8 +684,8 @@ We've also detailed [our architecture of GitLab.com](https://about.gitlab.com/ha ...@@ -684,8 +684,8 @@ We've also detailed [our architecture of GitLab.com](https://about.gitlab.com/ha
[postgres-exporter-charts]: https://github.com/helm/charts/tree/master/stable/postgresql [postgres-exporter-charts]: https://github.com/helm/charts/tree/master/stable/postgresql
[pgbouncer-exporter-omnibus]: ../administration/monitoring/prometheus/pgbouncer_exporter.md [pgbouncer-exporter-omnibus]: ../administration/monitoring/prometheus/pgbouncer_exporter.md
[pgbouncer-exporter-charts]: https://docs.gitlab.com/charts/installation/deployment.html#postgresql [pgbouncer-exporter-charts]: https://docs.gitlab.com/charts/installation/deployment.html#postgresql
[gitlab-monitor-omnibus]: ../administration/monitoring/prometheus/gitlab_monitor_exporter.md [gitlab-exporter-omnibus]: ../administration/monitoring/prometheus/gitlab_exporter.md
[gitlab-monitor-charts]: https://docs.gitlab.com/charts/charts/gitlab/gitlab-monitor/index.html [gitlab-exporter-charts]: https://docs.gitlab.com/charts/charts/gitlab/gitlab-exporter/index.html
[node-exporter-omnibus]: ../administration/monitoring/prometheus/node_exporter.md [node-exporter-omnibus]: ../administration/monitoring/prometheus/node_exporter.md
[node-exporter-charts]: https://gitlab.com/gitlab-org/charts/gitlab/issues/1332 [node-exporter-charts]: https://gitlab.com/gitlab-org/charts/gitlab/issues/1332
[mattermost-omnibus]: https://docs.gitlab.com/omnibus/gitlab-mattermost/ [mattermost-omnibus]: https://docs.gitlab.com/omnibus/gitlab-mattermost/
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment