diff options
author | Achilleas Pipinellis <axilleas@axilleas.me> | 2017-02-09 12:20:30 +0300 |
---|---|---|
committer | Achilleas Pipinellis <axilleas@axilleas.me> | 2017-02-09 12:20:30 +0300 |
commit | 419bbbf80d7568640eb7c35b6fa6720191e503a0 (patch) | |
tree | 195510a4e5583d458bc4e78167a49222348b19af | |
parent | 614f371989e9c2f4f9450cddfc9c3f505f977b89 (diff) |
Add info on changing the default address/port Prometheus listens on
Reported in https://gitlab.com/gitlab-org/omnibus-gitlab/issues/1905
[ci skip]
-rw-r--r-- | doc/administration/monitoring/prometheus/index.md | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/administration/monitoring/prometheus/index.md b/doc/administration/monitoring/prometheus/index.md index 86427d232f7..bb8928f16f3 100644 --- a/doc/administration/monitoring/prometheus/index.md +++ b/doc/administration/monitoring/prometheus/index.md @@ -46,6 +46,29 @@ By default, Prometheus will run as the `gitlab-prometheus` user and listen on has been enabled, it will automatically be set up as a monitoring target for Prometheus. +## Changing the port Prometheus listens on + +>**Note:** +The following change was added in [GitLab Omnibus 8.17][1261]. Although possible, +it's not recommended to change the default address and port Prometheus listens +on as this might affect or conflict with other services running on the GitLab +server. Proceed at your own risk. + +To change the address/port that Prometheus listens on: + +1. Edit `/etc/gitlab/gitlab.rb` +1. Find and add/uncomment the following line: + + ```ruby + prometheus['listen_address'] = 'localhost:9090' + ``` + + Replace `localhost:9090` with the address/port you want Prometheus to + listen on. + +1. Save the file and [reconfigure GitLab][reconfigure] for the changes to + take effect + ## Viewing performance metrics After you have [enabled Prometheus](#configuring-prometheus), you can visit @@ -121,3 +144,4 @@ The GitLab monitor exporter allows you to measure various GitLab metrics. [scrape-config]: https://prometheus.io/docs/operating/configuration/#%3Cscrape_config%3E [reconfigure]: ../../restart_gitlab.md#omnibus-gitlab-reconfigure [#27069]: https://gitlab.com/gitlab-org/gitlab-ce/issues/27069 +[1261]: https://gitlab.com/gitlab-org/omnibus-gitlab/merge_requests/1261 |