From 419bbbf80d7568640eb7c35b6fa6720191e503a0 Mon Sep 17 00:00:00 2001 From: Achilleas Pipinellis Date: Thu, 9 Feb 2017 10:20:30 +0100 Subject: Add info on changing the default address/port Prometheus listens on Reported in https://gitlab.com/gitlab-org/omnibus-gitlab/issues/1905 [ci skip] --- doc/administration/monitoring/prometheus/index.md | 24 +++++++++++++++++++++++ 1 file changed, 24 insertions(+) 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 -- cgit v1.2.1