1 files changed, 54 insertions, 48 deletions
diff --git a/doc/administration/monitoring/prometheus/index.md b/doc/administration/monitoring/prometheus/index.md
index 1e233b890a2..f0ad0a1a2e6 100644
--- a/doc/administration/monitoring/prometheus/index.md
+++ b/doc/administration/monitoring/prometheus/index.md
@@ -145,6 +145,12 @@ To use an external Prometheus server:
    gitlab_rails['monitoring_whitelist'] = ['127.0.0.0/8', '192.168.0.1']
    ```
 
+1. On **all** GitLab Rails(Puma/Unicorn, Sidekiq) servers, set the Prometheus server IP address and listen port. For example:
+
+   ```ruby
+   gitlab_rails['prometheus_address'] = '192.168.0.1:9090'
+   ```
+
 1. To scrape NGINX metrics, you'll also need to configure NGINX to allow the Prometheus server
    IP. For example:
 
@@ -165,54 +171,54 @@ To use an external Prometheus server:
 
    ```yaml
    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"
-     static_configs:
-     - targets:
-       - 1.1.1.1:8080
-   - 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: gitlab_exporter_process
-     metrics_path: "/process"
-     static_configs:
-     - targets:
-       - 1.1.1.1:9168
-   - job_name: gitaly
-     static_configs:
-     - targets:
-       - 1.1.1.1:9236
+     - 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"
+       static_configs:
+         - targets:
+           - 1.1.1.1:8080
+     - 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: gitlab_exporter_process
+       metrics_path: "/process"
+       static_configs:
+         - targets:
+           - 1.1.1.1:9168
+     - job_name: gitaly
+       static_configs:
+         - targets:
+           - 1.1.1.1:9236
    ```
 
 1. Reload the Prometheus server.