Prometheus Settings

Remote read/write

Prometheus supports reading and writing to remote services.

To configure a remote remote read or write service, you can include the following in gitlab.rb.

prometheus['remote_write'] = [
    url: '',
    basic_auth: {
      password: 'remote write secret password'
prometheus['remote_read'] = [
    url: ''

For more documentation on the options available, see the remote write and remote read sections of the official documentation.

Rules files

Prometheus allows for recording and alerting rules.

Omnibus includes some default rules files that are stored in /var/opt/gitlab/prometheus/rules/.

To override the default rules, you can change the default list in gitlab.rb..

No rules:

prometheus['rules_files'] = []

Custom list:

prometheus['rules_files'] = ['/path/to/rules/*.rules', '/path/to/single/file.rules']

Grafana dashboards

Grafana is a powerful dashboard software for presenting Prometheus metrics data. GitLab Omnibus >= 11.9 includes an embedded copy.

See the embedded Grafana documentation for more information.