Skip to content

Connect HAProxy databases to PMM

Monitor your HAProxy load balancer performance with Percona Monitoring and Management (PMM). PMM collects metrics from HAProxy’s built-in Prometheus endpoint to provide insights into proxy performance, backend health, and traffic patterns.

Prerequisites

Before adding HAProxy to PMM, ensure:

  1. HAProxy configured with metrics endpoint.

    • HAProxy must expose Prometheus metrics. See How to configure HAProxy.
    • Default metrics endpoint: http://localhost:8404/metrics
    • Verify metrics are accessible: curl http://localhost:8404/metrics
  2. PMM Client installed and configured

  3. PMM Client (pmm-agent) running on the same host as HAProxy
  4. Node registered with PMM Server using pmm-admin config

Add HAProxy service

Add HAProxy monitoring with the required port specification:

pmm-admin add haproxy --listen-port=8404

where listen-port is the port number where HAProxy is running. This is the only required flag.

Successful output
HAProxy Service added.
Service ID  : c481183f-70a2-443f-91e5-cae5cecd06a2
Service name: Ubuntu-haproxy

Advanced configuration options

Customize the HAProxy service with additional parameters:

# With authentication
pmm-admin add haproxy --listen-port=8404 --username=pmm --password=pmm MyHAProxy

# With custom metrics path and HTTPS
pmm-admin add haproxy --listen-port=8404 --metrics-path=/prom-metrics --scheme=https

# With custom service name
pmm-admin add haproxy --listen-port=8404 Production-HAProxy

Available options

  • --listen-port: HAProxy metrics port (required)
  • --username: Basic authentication username
  • --password: Basic authentication password
  • --metrics-path: Metrics endpoint path (default: /metrics)
  • --scheme: Connection protocol (http or https)
  • --skip-connection-check: Skip connectivity validation

Via web UI

To add HAProxy through the PMM web interface:

  1. Go to PMM Configuration > PMM Inventory > Add Service.
  2. Select HAProxy from the service types.
  3. Configure the connection parameters then click Add Service.

Verify the connection

Check that HAProxy monitoring is active:

pmm-admin status

HAProxy data is visible in the Advanced Data Exploration dashboard:

!