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

---
stage: Monitor
group: Respond
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---

# Monitoring HAProxy (DEPRECATED) **(FREE)**

> [Deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/346541) in GitLab 14.7.

WARNING:
This feature is in its end-of-life process. It is [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/346541)
for use in GitLab 14.7, and is planned for removal in GitLab 15.0.

GitLab has support for automatically detecting and monitoring HAProxy. This is provided by leveraging the [HAProxy Exporter](https://github.com/prometheus/haproxy_exporter), which translates HAProxy statistics into a Prometheus readable form.

## Requirements

The [Prometheus service](../prometheus.md) must be enabled.

## Metrics supported

| Name | Query |
| ---- | ----- |
| Throughput (req/sec) | `sum(rate(haproxy_frontend_http_requests_total{%{environment_filter}}[2m])) by (code)` |
| HTTP Error Rate (%) | `sum(rate(haproxy_frontend_http_requests_total{code="5xx",%{environment_filter}}[2m])) / sum(rate(haproxy_frontend_http_requests_total{%{environment_filter}}[2m]))` |

## Configuring Prometheus to monitor for HAProxy metrics

To get started with NGINX monitoring, you should install and configure the [HAProxy exporter](https://github.com/prometheus/haproxy_exporter) which parses these statistics and translates them into a Prometheus monitoring endpoint.

## Specifying the Environment label

In order to isolate and only display relevant metrics for a given environment
however, GitLab needs a method to detect which labels are associated. To do this, GitLab [looks for an `environment` label](index.md#identifying-environments).
Add latest changes from gitlab-org/gitlab@master 2020-05-07 17:09:26 -04:00			`---`
			`stage: Monitor`
Add latest changes from gitlab-org/gitlab@master 2022-01-27 13:14:37 -05:00			`group: Respond`
Add latest changes from gitlab-org/gitlab@master 2020-11-26 01:09:20 -05:00			`info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments`
Add latest changes from gitlab-org/gitlab@master 2020-05-07 17:09:26 -04:00			`---`

Add latest changes from gitlab-org/gitlab@master 2022-01-11 13:16:38 -05:00			`# Monitoring HAProxy (DEPRECATED) (FREE)`

			`> [Deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/346541) in GitLab 14.7.`

			`WARNING:`
			`This feature is in its end-of-life process. It is [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/346541)`
			`for use in GitLab 14.7, and is planned for removal in GitLab 15.0.`
Clean up headers in markdown Some markdown headers needed tweaking to adhere to standards, including blank lines above and below, only one space after hash, first header should be h1, and only one h1 per doc 2019-07-24 09:10:06 -04:00
Docs: fix HAProxy name and exporter's link 2017-07-25 17:12:33 -04:00			`GitLab has support for automatically detecting and monitoring HAProxy. This is provided by leveraging the [HAProxy Exporter](https://github.com/prometheus/haproxy_exporter), which translates HAProxy statistics into a Prometheus readable form.`
Add HA Proxy metrics, fix NGINX 2017-07-19 21:22:46 -04:00
Clean up Kubernetes integration docs page 2017-09-15 05:05:58 -04:00			`## Requirements`

Link Monitor docs to the front page 2018-04-11 08:25:29 -04:00			`The [Prometheus service](../prometheus.md) must be enabled.`
Clean up Kubernetes integration docs page 2017-09-15 05:05:58 -04:00
Add HA Proxy metrics, fix NGINX 2017-07-19 21:22:46 -04:00			`## Metrics supported`

			`\| Name \| Query \|`
			`\| ---- \| ----- \|`
Fix markdown to reduce number of kramdown warnings Add backticks around square brackets, or fix links, as necessary. 2019-07-03 03:12:04 -04:00			\| Throughput (req/sec) \| `sum(rate(haproxy_frontend_http_requests_total{%{environment_filter}}[2m])) by (code)` \|
			\| HTTP Error Rate (%) \| `sum(rate(haproxy_frontend_http_requests_total{code="5xx",%{environment_filter}}[2m])) / sum(rate(haproxy_frontend_http_requests_total{%{environment_filter}}[2m]))` \|
Add HA Proxy metrics, fix NGINX 2017-07-19 21:22:46 -04:00
Docs: fix HAProxy name and exporter's link 2017-07-25 17:12:33 -04:00			`## Configuring Prometheus to monitor for HAProxy metrics`
Add HA Proxy metrics, fix NGINX 2017-07-19 21:22:46 -04:00
Docs: fix HAProxy name and exporter's link 2017-07-25 17:12:33 -04:00			`To get started with NGINX monitoring, you should install and configure the [HAProxy exporter](https://github.com/prometheus/haproxy_exporter) which parses these statistics and translates them into a Prometheus monitoring endpoint.`
Add HA Proxy metrics, fix NGINX 2017-07-19 21:22:46 -04:00
			`## Specifying the Environment label`

			`In order to isolate and only display relevant metrics for a given environment`
Add latest changes from gitlab-org/gitlab@master 2020-11-18 10:09:08 -05:00			however, GitLab needs a method to detect which labels are associated. To do this, GitLab [looks for an `environment` label](index.md#identifying-environments).