Commit 7726cb39 authored by Joshua Lambert's avatar Joshua Lambert

Add prometheus memory requirements, include additional detail on disabling prometheus in docs.

parent a5134f10
...@@ -22,26 +22,22 @@ dashboard tool like [Grafana]. ...@@ -22,26 +22,22 @@ dashboard tool like [Grafana].
## Configuring Prometheus ## Configuring Prometheus
>**Note:** >**Note:**
Available since Omnibus GitLab 8.16. For installations from source you'll - For installations from source you'll have to install and configure it yourself.
have to install and configure it yourself.
To enable Prometheus: Prometheus and it's exporters are on by default, starting with GitLab 9.0. Prometheus will run as the `gitlab-prometheus` user and listen on `http://localhost:9090`. Each exporter will be automatically be set up as a monitoring target for Prometheus, unless individually disabled.
To disable Prometheus and all of its exporters, as well as any added in the future:
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
prometheus['enable'] = true prometheus['disable_all'] = 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
By default, Prometheus will run as the `gitlab-prometheus` user and listen on
`http://localhost:9090`. If the [node exporter](#node-exporter) service
has been enabled, it will automatically be set up as a monitoring target for
Prometheus.
## Changing the port Prometheus listens on ## Changing the port Prometheus listens on
>**Note:** >**Note:**
...@@ -67,8 +63,7 @@ To change the address/port that Prometheus listens on: ...@@ -67,8 +63,7 @@ To change the address/port that Prometheus listens on:
## Viewing performance metrics ## Viewing performance metrics
After you have [enabled Prometheus](#configuring-prometheus), you can visit You can visit `http://localhost:9090` for the dashboard that Prometheus offers by default.
`http://localhost:9090` for the dashboard that Prometheus offers by default.
>**Note:** >**Note:**
If SSL has been enabled on your GitLab instance, you may not be able to access If SSL has been enabled on your GitLab instance, you may not be able to access
......
...@@ -108,7 +108,7 @@ use the CI features. ...@@ -108,7 +108,7 @@ use the CI features.
## Unicorn Workers ## Unicorn Workers
It's possible to increase the amount of unicorn workers and this will usually help for to reduce the response time of the applications and increase the ability to handle parallel requests. It's possible to increase the amount of unicorn workers and this will usually help to reduce the response time of the applications and increase the ability to handle parallel requests.
For most instances we recommend using: CPU cores + 1 = unicorn workers. For most instances we recommend using: CPU cores + 1 = unicorn workers.
So for a machine with 2 cores, 3 unicorn workers is ideal. So for a machine with 2 cores, 3 unicorn workers is ideal.
...@@ -148,6 +148,12 @@ Sidekiq processes the background jobs with a multithreaded process. ...@@ -148,6 +148,12 @@ Sidekiq processes the background jobs with a multithreaded process.
This process starts with the entire Rails stack (200MB+) but it can grow over time due to memory leaks. This process starts with the entire Rails stack (200MB+) but it can grow over time due to memory leaks.
On a very active server (10,000 active users) the Sidekiq process can use 1GB+ of memory. On a very active server (10,000 active users) the Sidekiq process can use 1GB+ of memory.
## Prometheus and its exporters
As of GitLab 9.0, [Prometheus](https://prometheus.io) and its related exporters are enabled by default, to enable easy and in depth monitoring of GitLab. Approximately 200MB of memory will be consumed by these processes, with default settings.
If you would like to disable Prometheus and it's exporters, simply set `prometheus['disable_all']=true` in `gitlab.rb`. More information is available in [the documentation](https://docs.gitlab.com/ce/doc/administration/monitoring/prometheus/index.html).
## Supported web browsers ## Supported web browsers
We support the current and the previous major release of Firefox, Chrome/Chromium, Safari and Microsoft browsers (Microsoft Edge and Internet Explorer 11). We support the current and the previous major release of Firefox, Chrome/Chromium, Safari and Microsoft browsers (Microsoft Edge and Internet Explorer 11).
......
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