# Prometheus HAProxy Exporter

How to Integrate **Prometheus HAProxy Exporter** with **Apica Ascent**

### 1. Introduction

This guide explains how to send HAProxy metrics from Prometheus HAProxy Exporter to Apica Ascent, and how to monitor and visualize them.

You’ll learn:

* How to install HAProxy Exporter
* How to configure Prometheus to scrape HAProxy metrics
* How to connect Prometheus with Apica Ascent
* How to visualize metrics in dashboards

### 2. Install and Run HAProxy Exporter

Follow the official documentation for installation as per your requirements:\
[HAProxy Installation](https://github.com/prometheus/haproxy_exporter?tab=readme-ov-file%23haproxy-exporter-for-prometheus)

### 3. Configure Prometheus to Scrape HAProxy Exporter

Update your prometheus.yml with a scrape job for HAProxy Exporter:

```
scrape_configs:
  - job_name: 'haproxy'
    static_configs:
      - targets: ['localhost:9101']
```

Restart Prometheus and check the /targets page to verify that metrics are being scraped.

### 4. Connect Prometheus to Apica Ascent

To send metrics to Apica Ascent, add the following remote\_write configuration to your prometheus.yml:

```
remote_write:
  - url: "https://<your-ascent-env>/v1/receive/prometheus"
    tls_config:
      insecure_skip_verify: true
    authorization:
      type: "Bearer"
      credentials: "<YOUR_INGEST_TOKEN>"
```

Optional: Relabel metrics for easier identification:

```
write_relabel_configs:
  - action: replace
    source_labels: [__name__]
    regex: "(.*)"
    target_label: __name__
    replacement: "ascent_$1"
```

This will rename metrics to ascent\_\<metric-name> before sending them.

### 5. Verify Metrics in Apica Ascent

* Log in to Apica Ascent
* Navigate to Queries → New Query
* Run a query such as:

```
haproxy_up
haproxy_frontend_sessions_total
haproxy_backend_current_sessions
```

Execute and verify that results are populated.

### 6. Example Dashboards

You can build dashboards for common HAProxy metrics:

* **Traffic:** Requests/sec, Bytes in/out
* **Reliability:** 4xx/5xx response rates, server UP status
* **Capacity:** Queue length, max sessions

**Alerts:**

* Backend down
* High 5xx error rate

**Dashboard templates**: GitHub repository

### 7. Troubleshooting

Here are some common resolution areas:

* **HAProxy Exporter not reachable** → Check firewall on port 9101.
* **Prometheus not scraping** → Verify prometheus.yml configuration.
* **Metrics not in Apica** → Validate remote\_write URL and ingest token.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apica.io/integrations/list-of-integrations/prometheus/prometheus-haproxy-exporter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.