Skip to content
PERCONA MONITORING AND MANAGEMENT DOCUMENTATION

For help, click the link below to get free database assistance or contact our experts for personalized support.

Get help from Percona

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:

!