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

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.