gitlab-org--gitlab-foss/doc/user/project/integrations/prometheus_library/metrics.md

26 lines
1.9 KiB
Markdown
Raw Normal View History

2017-07-14 23:52:21 -04:00
# Prometheus Metrics library
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/8935) in GitLab 9.0
2017-07-16 22:09:56 -04:00
GitLab offers automatic detection of select [Prometheus exporters](https://prometheus.io/docs/instrumenting/exporters/). Currently supported exporters are:
* [Kubernetes](kubernetes.md)
* [NGINX](nginx.md)
* [Amazon Cloud Watch](cloudwatch.md)
2017-07-14 23:52:21 -04:00
2017-07-16 22:09:56 -04:00
We have tried to surface the most important metrics for each exporter, and will be continuing to add support for additional exporters in future releases. If you would like to add support for other official exporters, [contributions](#adding-to-the-library) are welcome.
2017-07-14 23:52:21 -04:00
2017-07-16 22:09:56 -04:00
## Identifying Environments
2017-07-14 23:52:21 -04:00
2017-07-16 22:09:56 -04:00
GitLab retrieves performance data from the configured Prometheus server, and attempts to identifying the presence of known metrics. Once identified, GitLab then needs to be able to map the data to a particular environment.
In order to isolate and only display relevant metrics for a given environment, GitLab needs a method to detect which labels are associated. To do that,
GitLab will look for the required metrics which have a label that
2017-07-14 23:52:21 -04:00
matches the [$CI_ENVIRONMENT_SLUG][ci-environment-slug].
2017-07-16 22:09:56 -04:00
For example if you are deploying to an environment named `production`, there must be a label for the metric with the value of `production`.
2017-07-14 23:52:21 -04:00
2017-07-16 22:09:56 -04:00
## Adding to the library
2017-07-14 23:52:21 -04:00
2017-07-16 22:09:56 -04:00
We strive to support the 2-4 most important metrics for each common system service that supports Prometheus. If you are looking for support for a particular exporter which has not yet been added to the library, additions can be made [to the `additional_metrics.yml`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/prometheus/additional_metrics.yml) file.
2017-07-14 23:52:21 -04:00
2017-07-16 22:09:56 -04:00
> Note: The library is only for monitoring public, common, system services which all customers can benefit from. Support for monitoring [customer proprietary metrics](https://gitlab.com/gitlab-org/gitlab-ee/issues/2273) will be added in an subsequent release.