HAProxy Prometheus

Plugin: go.d.plugin Module: prometheus

Overview

Monitor HAProxy process, frontend, listener, backend, server, and stick-table behavior through its Prometheus endpoint.

Netdata periodically scrapes the HAProxy Prometheus endpoint with the generic Prometheus collector and applies the built-in haproxy profile.

This collector is supported on all platforms.

This collector supports collecting metrics from multiple instances of this integration, including remote instances.

HAProxy Prometheus can be monitored further using the following other integrations:

HAProxy

Default Behavior

Auto-Detection

By default, it detects instances running on the local host by trying to connect to known ports that are allocated to exporters.

Limits

The default configuration for this integration does not impose any limits on data collection.

Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Setup

You can configure the prometheus collector in two ways:

Method	Best for	How to
UI	Fast setup without editing files	Go to Nodes → Configure this node → Collectors → Jobs, search for prometheus, then click + to add a job.
File	If you prefer configuring via file, or need to automate deployments (e.g., with Ansible)	Edit `go.d/prometheus.conf` and add a job.

important

UI configuration requires paid Netdata Cloud plan.

Prerequisites

Enable the HAProxy Prometheus endpoint

Configure HAProxy's built-in Prometheus exporter as described in the HAProxy documentation.

Configuration

Options

The following options can be defined globally: update_every, autodetection_retry.

Config options

Group	Option	Description	Default	Required
Collection	update_every	Data collection interval (seconds).	10	no
	autodetection_retry	Autodetection retry interval (seconds). Set 0 to disable.	0	no
Target	url	Target endpoint URL.		yes
	timeout	HTTP request timeout (seconds).	10	no
	expected_prefix	If set, the job's check passes only when at least one post-job, pre-profile metric name starts with this prefix. Guards against scraping an unexpected endpoint; profile-owned relabeling cannot satisfy it.		no
Customization	app	Application name used as the app segment of chart contexts (`prometheus.<app>.<metric>`). When unset, it is taken from a matched profile, otherwise it falls back to the job name.		no
Filters	selector	Time series selector (filter).		no
Limits	max_time_series	Global time series limit applied after job and profile relabeling. If the final output exceeds it, the data is not processed.	2000	no
	max_time_series_per_metric	Per-metric time series limit applied to final metric families. Metrics exceeding it are skipped.	200	no
Customization	fallback_type	Job-level fallback type overrides for untyped metrics.		no
	relabeling	Job-owned Prometheus-compatible metric relabeling, applied before profile selection.		no
	profiles	Curated, exporter-specific chart profiles with optional untyped classification, profile-owned normalization, and scoped fallback-chart policy. User profiles may constrain unmatched fallback charts; stock profiles preserve unknown future families. Disable profiles with mode `none`.	auto	no
HTTP Auth	username	Username for Basic HTTP authentication.		no
	password	Password for Basic HTTP authentication.		no
	bearer_token_file	Path to a file containing a bearer token (used for `Authorization: Bearer`).		no
TLS	tls_skip_verify	Skip TLS certificate and hostname verification (insecure).	no	no
	tls_ca	Path to CA bundle used to validate the server certificate.		no
	tls_cert	Path to client TLS certificate (for mTLS).		no
	tls_key	Path to client TLS private key (for mTLS).		no
Proxy	proxy_url	HTTP proxy URL.		no
	proxy_username	Username for proxy Basic HTTP authentication.		no
	proxy_password	Password for proxy Basic HTTP authentication.		no
Request	method	HTTP method to use.	GET	no
	body	Request body (e.g., for POST/PUT).		no
	headers	Additional HTTP headers (one per line as key: value).		no
	not_follow_redirects	Do not follow HTTP redirects.	no	no
	force_http2	Force HTTP/2 (including h2c over TCP).	no	no
Virtual Node	vnode	Associates this data collection job with a Virtual Node.		no

selector

This option allows you to filter out unwanted time series. Only metrics matching the selector will be collected.

Logic: (pattern1 OR pattern2) AND !(pattern3 or pattern4)
Pattern syntax: selector.
Option syntax:

selector:
  allow:
    - pattern1
    - pattern2
  deny:
    - pattern3
    - pattern4

fallback_type

This job option allows you to process untyped metrics as Counter or Gauge instead of ignoring them. Classification uses the post-job, pre-profile metric name. Profile relabeling preserves the selected type but cannot create or change it by renaming the final metric.

Selected profiles may provide exporter-owned fallback_type defaults inside their own match scope. Job gauge rules take precedence over job counter rules, and both job rule sets take precedence over every profile rule. Use them for deployment-specific overrides rather than exporter behavior that belongs in a profile. Keep patterns narrow: a broad job rule such as gauge: ['*'] overrides profile counter classifications. Blank patterns and patterns with leading or trailing whitespace are rejected.

Metric name pattern syntax: shell file name pattern.
Option syntax:

fallback_type:
  counter:
    - metric_name_pattern1
    - metric_name_pattern2
  gauge:
    - metric_name_pattern3
    - metric_name_pattern4

relabeling

A list of job-owned relabeling blocks, applied after selector and before profile selection. Each block applies a list of Prometheus metric_relabel_configs rules to the metrics whose name matches match. Profiles may own the same block format for exporter normalization after selection. See the relabeling reference for the full action set and more examples.

match: Netdata simple patterns matched against the full metric name — including any _bucket/_sum/_count suffix, so prefer globs like app_lat* over an exact app_lat (space-separated; * matches any sequence, ? any character, a leading ! negates). Use * to target every metric. Required.
metric_relabel_configs: Prometheus relabel rules (source_labels, separator, regex, modulus, target_label, replacement, action), applied in order to the scraped samples before charts are built.

Relabeling that would corrupt a histogram or summary — splitting it, dropping a component, mutating the le/quantile label, or merging two families — is rejected.

relabeling:
  - match: 'http_*'
    metric_relabel_configs:
      - source_labels: [code]
        regex: '(\d)\d\d'
        target_label: code_class
        replacement: '${1}xx'

profiles

Profiles ship curated charts for recognized exporters -- see the profile format for the file format and how to author your own. profiles.mode selects them:

auto (default): every profile whose match hits at least one scraped metric.
exact: only the profiles named in mode_exact.entries (each must match, or the job fails its check).
combined: auto plus the profiles named in mode_combined.entries.
none: no profiles — generic autogen charts only (the pre-profile behavior).

Selection uses post-job, pre-profile family names. A selected profile may carry fallback_type rules that classify untyped scalar families inside its match scope and relabeling blocks that normalize matching source families automatically before chart routing. Job fallback policy takes precedence; conflicting profile rules use the same ordering as normalization. Each original family is processed only by the first applicable profile normalizer: profile-name order in auto, configured entry order in exact, and configured entries followed by remaining auto profiles in name order in combined. Later profile pipelines do not see the family. All selected templates consume the same final names and labels; the collector does not create a private metric stream per profile.

Only the block matching the selected mode (mode_exact or mode_combined) is read; entries under the other block are ignored. Metrics not covered by an authored profile chart keep their generic autogen charts unless an applicable profile autogen.selector rejects them. Every selector is limited to its profile's match scope; when scopes overlap, every applicable selector must accept the series. This changes fallback charts only; use selector or a relabeling drop rule to discard samples. Stock profiles leave unknown future families eligible for generic fallback; closed fallback selectors are a user-owned deployment policy, not a stock-profile authoring pattern.

profiles:
  mode: exact
  mode_exact:
    entries:
      - name: haproxy

via UI

Configure the prometheus collector from the Netdata web interface:

Go to Nodes.
Select the node where you want the prometheus data-collection job to run and click the ⚙ (Configure this node). That node will run the data collection.
The Collectors → Jobs view opens by default.
In the Search box, type prometheus (or scroll the list) to locate the prometheus collector.
Click the + next to the prometheus collector to add a new job.
Fill in the job fields, then click Test to verify the configuration and Submit to save.
- Test runs the job with the provided settings and shows whether data can be collected.
- If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.

via File

The configuration file name for this integration is go.d/prometheus.conf.

The file format is YAML. Generally, the structure is:

update_every: 1
autodetection_retry: 0
jobs:
  - name: some_name1
  - name: some_name2

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config go.d/prometheus.conf

Examples

HAProxy Prometheus

Collect HAProxy metrics with the automatically matched stock profile.

jobs:
  - name: haproxy
    url: http://127.0.0.1:8404/metrics
    expected_prefix: haproxy_

Alerts

There are no alerts configured by default for this integration.

Metrics

The built-in Prometheus profiles on this page define 204 curated charts across the primary and applicable supporting profiles. The catalogue is generated from the same profile design and runtime chart contracts used by the Agent.

Eligible metrics that are not covered by a curated chart, including future exporter metrics, can still be collected through the generic Prometheus autogeneration behavior. This catalogue describes curated profile coverage; it is not an allowlist of every metric that the collector can render.

Curated profile coverage (204 charts)

HAProxy Prometheus — 204 charts

Curated process, frontend, listener, backend, server, and stick-table metrics from the HAProxy Prometheus exporter.

Process (58 charts)

Activity (5 charts)

Received Logs

Entity scope: HAProxy worker process
Units: logs/s
Dimensions: value

Source metric selectors (1)

haproxy_process_recv_logs_total

Relative Process ID

Entity scope: HAProxy worker process
Units: process id
Dimensions: value

Source metric selectors (1)

haproxy_process_relative_process_id

Requests

Entity scope: HAProxy worker process
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_process_requests_total

Threads

Entity scope: HAProxy worker process
Units: threads
Dimensions: value

Source metric selectors (1)

haproxy_process_nbthread

Worker Processes

Entity scope: HAProxy worker process
Units: processes
Dimensions: value

Source metric selectors (1)

haproxy_process_nbproc

Compression (3 charts)

Current Zlib Memory

Entity scope: HAProxy worker process
Units: bytes
Dimensions: value

Source metric selectors (1)

haproxy_process_current_zlib_memory

HTTP Compression Limit

Entity scope: HAProxy worker process
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_process_limit_http_comp

Max Zlib Memory

Entity scope: HAProxy worker process
Units: bytes
Dimensions: value

Source metric selectors (1)

haproxy_process_max_zlib_memory

Connections (11 charts)

Connections

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_connections_total

Current Connection Rate

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_current_connection_rate

Current Connections

Entity scope: HAProxy worker process
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_process_current_connections

Hard Max Connections

Entity scope: HAProxy worker process
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_process_hard_max_connections

Limit Connection Rate

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_limit_connection_rate

Max Connection Rate

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_max_connection_rate

Max Connections

Entity scope: HAProxy worker process
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_process_max_connections

Max FDs

Entity scope: HAProxy worker process
Units: file descriptors
Dimensions: value

Source metric selectors (1)

haproxy_process_max_fds

Max Pipes

Entity scope: HAProxy worker process
Units: pipes
Dimensions: value

Source metric selectors (1)

haproxy_process_max_pipes

Max Sockets

Entity scope: HAProxy worker process
Units: sockets
Dimensions: value

Source metric selectors (1)

haproxy_process_max_sockets

Pipes

Entity scope: HAProxy worker process
Units: pipes
Dimensions: used, free

Source metric selectors (2)

haproxy_process_pipes_used_total
haproxy_process_pipes_free_total

Errors (3 charts)

Dropped Logs

Entity scope: HAProxy worker process
Units: logs/s
Dimensions: value

Source metric selectors (1)

haproxy_process_dropped_logs_total

Failed Resolutions

Entity scope: HAProxy worker process
Units: errors/s
Dimensions: value

Source metric selectors (1)

haproxy_process_failed_resolutions

Warnings

Entity scope: HAProxy worker process
Units: warnings/s
Dimensions: value

Source metric selectors (1)

haproxy_process_total_warnings

Health (1 chart)

Active Peers

Entity scope: HAProxy worker process
Units: peers
Dimensions: value

Source metric selectors (1)

haproxy_process_active_peers

Memory (4 charts)

Max Memory Bytes

Entity scope: HAProxy worker process
Units: bytes
Dimensions: value

Source metric selectors (1)

haproxy_process_max_memory_bytes

Pool Allocated Bytes

Entity scope: HAProxy worker process
Units: bytes
Dimensions: value

Source metric selectors (1)

haproxy_process_pool_allocated_bytes

Pool Failures

Entity scope: HAProxy worker process
Units: failures/s
Dimensions: value

Source metric selectors (1)

haproxy_process_pool_failures_total

Pool Used Bytes

Entity scope: HAProxy worker process
Units: bytes
Dimensions: value

Source metric selectors (1)

haproxy_process_pool_used_bytes

Queue (1 chart)

Current Run Queue

Entity scope: HAProxy worker process
Units: tasks
Dimensions: value

Source metric selectors (1)

haproxy_process_current_run_queue

SSL (13 charts)

Current Backend SSL Key Rate

Entity scope: HAProxy worker process
Units: keys/s
Dimensions: value

Source metric selectors (1)

haproxy_process_current_backend_ssl_key_rate

Current Frontend SSL Key Rate

Entity scope: HAProxy worker process
Units: keys/s
Dimensions: value

Source metric selectors (1)

haproxy_process_current_frontend_ssl_key_rate

Current SSL Connections

Entity scope: HAProxy worker process
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_process_current_ssl_connections

Current SSL Rate

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_current_ssl_rate

Frontend SSL Reuse

Entity scope: HAProxy worker process
Units: percentage
Dimensions: value

Source metric selectors (1)

haproxy_process_frontend_ssl_reuse

Limit SSL Rate

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_limit_ssl_rate

Max Backend SSL Key Rate

Entity scope: HAProxy worker process
Units: keys/s
Dimensions: value

Source metric selectors (1)

haproxy_process_max_backend_ssl_key_rate

Max Frontend SSL Key Rate

Entity scope: HAProxy worker process
Units: keys/s
Dimensions: value

Source metric selectors (1)

haproxy_process_max_frontend_ssl_key_rate

Max SSL Connections

Entity scope: HAProxy worker process
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_process_max_ssl_connections

Max SSL Rate

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_max_ssl_rate

SSL Cache Lookups

Entity scope: HAProxy worker process
Units: lookups/s
Dimensions: value

Source metric selectors (1)

haproxy_process_ssl_cache_lookups_total

SSL Cache Misses

Entity scope: HAProxy worker process
Units: events/s
Dimensions: value

Source metric selectors (1)

haproxy_process_ssl_cache_misses_total

SSL Connections

Entity scope: HAProxy worker process
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_process_ssl_connections_total

Scheduler (5 charts)

Connected Peers

Entity scope: HAProxy worker process
Units: peers
Dimensions: value

Source metric selectors (1)

haproxy_process_connected_peers

Current Tasks

Entity scope: HAProxy worker process
Units: tasks
Dimensions: value

Source metric selectors (1)

haproxy_process_current_tasks

Jobs

Entity scope: HAProxy worker process
Units: jobs
Dimensions: value

Source metric selectors (1)

haproxy_process_jobs

Listeners

Entity scope: HAProxy worker process
Units: listeners
Dimensions: value

Source metric selectors (1)

haproxy_process_listeners

Unstoppable Jobs

Entity scope: HAProxy worker process
Units: jobs
Dimensions: value

Source metric selectors (1)

haproxy_process_unstoppable_jobs

Sessions (3 charts)

Current Session Rate

Entity scope: HAProxy worker process
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_process_current_session_rate

Limit Session Rate

Entity scope: HAProxy worker process
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_process_limit_session_rate

Max Session Rate

Entity scope: HAProxy worker process
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_process_max_session_rate

Status (2 charts)

Busy Polling Enabled

Entity scope: HAProxy worker process
Units: {status}
Dimensions: value

Source metric selectors (1)

haproxy_process_busy_polling_enabled

Stopping

Entity scope: HAProxy worker process
Units: {status}
Dimensions: value

Source metric selectors (1)

haproxy_process_stopping

Timing (2 charts)

Idle Time Percent

Entity scope: HAProxy worker process
Units: percentage
Dimensions: value

Source metric selectors (1)

haproxy_process_idle_time_percent

Uptime Seconds

Entity scope: HAProxy worker process
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_process_uptime_seconds

Traffic (5 charts)

Bytes Out

Entity scope: HAProxy worker process
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_process_bytes_out_total

Bytes Out Rate

Entity scope: HAProxy worker process
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_process_bytes_out_rate

HTTP Compression Bytes In

Entity scope: HAProxy worker process
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_process_http_comp_bytes_in_total

HTTP Compression Bytes Out

Entity scope: HAProxy worker process
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_process_http_comp_bytes_out_total

Spliced Bytes Out

Entity scope: HAProxy worker process
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_process_spliced_bytes_out_total

Frontends (26 charts)

Compression (1 chart)

HTTP Compression Responses

Entity scope: HAProxy frontend
Units: responses/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_comp_responses_total

Connections (3 charts)

Connections

Entity scope: HAProxy frontend
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_connections_total

Connections Rate Max

Entity scope: HAProxy frontend
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_connections_rate_max

Denied Connections

Entity scope: HAProxy frontend
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_denied_connections_total

Errors (3 charts)

Errors

Entity scope: HAProxy frontend
Units: errors/s
Dimensions: request, header_rewriting, internal

Source metric selectors (3)

haproxy_frontend_request_errors_total
haproxy_frontend_failed_header_rewriting_total
haproxy_frontend_internal_errors_total

Requests Denied

Entity scope: HAProxy frontend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_requests_denied_total

Responses Denied

Entity scope: HAProxy frontend
Units: responses/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_responses_denied_total

HTTP (6 charts)

HTTP Cache Hits

Entity scope: HAProxy frontend
Units: hits/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_cache_hits_total

HTTP Cache Lookups

Entity scope: HAProxy frontend
Units: lookups/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_cache_lookups_total

HTTP Requests

Entity scope: HAProxy frontend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_requests_total

HTTP Requests Rate Max

Entity scope: HAProxy frontend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_requests_rate_max

HTTP Responses

Entity scope: HAProxy frontend
Units: responses/s
Dimensions: values of label code

Source metric selectors (1)

haproxy_frontend_http_responses_total

Intercepted Requests

Entity scope: HAProxy frontend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_intercepted_requests_total

Sessions (8 charts)

Current Session Rate

Entity scope: HAProxy frontend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_current_session_rate

Current Sessions

Entity scope: HAProxy frontend
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_frontend_current_sessions

Denied Sessions

Entity scope: HAProxy frontend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_denied_sessions_total

Limit Session Rate

Entity scope: HAProxy frontend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_limit_session_rate

Limit Sessions

Entity scope: HAProxy frontend
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_frontend_limit_sessions

Max Session Rate

Entity scope: HAProxy frontend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_max_session_rate

Max Sessions

Entity scope: HAProxy frontend
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_frontend_max_sessions

Sessions

Entity scope: HAProxy frontend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_sessions_total

Status (1 chart)

Status

Entity scope: HAProxy frontend
Units: {status}
Dimensions: values of label state

Source metric selectors (1)

haproxy_frontend_status

Traffic (4 charts)

HTTP Compression Bytes Bypassed

Entity scope: HAProxy frontend
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_comp_bytes_bypassed_total

HTTP Compression Bytes In

Entity scope: HAProxy frontend
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_comp_bytes_in_total

HTTP Compression Bytes Out

Entity scope: HAProxy frontend
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_frontend_http_comp_bytes_out_total

Traffic

Entity scope: HAProxy frontend
Units: bytes/s
Dimensions: in, out

Source metric selectors (2)

haproxy_frontend_bytes_in_total
haproxy_frontend_bytes_out_total

Listeners (12 charts)

Connections (2 charts)

Connections

Entity scope: HAProxy listener
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_listener_connections_total

Denied Connections

Entity scope: HAProxy listener
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_listener_denied_connections_total

Errors (3 charts)

Errors

Entity scope: HAProxy listener
Units: errors/s
Dimensions: request, header_rewriting, internal

Source metric selectors (3)

haproxy_listener_request_errors_total
haproxy_listener_failed_header_rewriting_total
haproxy_listener_internal_errors_total

Requests Denied

Entity scope: HAProxy listener
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_listener_requests_denied_total

Responses Denied

Entity scope: HAProxy listener
Units: responses/s
Dimensions: value

Source metric selectors (1)

haproxy_listener_responses_denied_total

Sessions (5 charts)

Current Sessions

Entity scope: HAProxy listener
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_listener_current_sessions

Denied Sessions

Entity scope: HAProxy listener
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_listener_denied_sessions_total

Limit Sessions

Entity scope: HAProxy listener
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_listener_limit_sessions

Max Sessions

Entity scope: HAProxy listener
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_listener_max_sessions

Sessions

Entity scope: HAProxy listener
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_listener_sessions_total

Status (1 chart)

Status

Entity scope: HAProxy listener
Units: {status}
Dimensions: values of label state

Source metric selectors (1)

haproxy_listener_status

Traffic (1 chart)

Traffic

Entity scope: HAProxy listener
Units: bytes/s
Dimensions: in, out

Source metric selectors (2)

haproxy_listener_bytes_in_total
haproxy_listener_bytes_out_total

Backends (43 charts)

Compression (1 chart)

HTTP Compression Responses

Entity scope: HAProxy backend
Units: responses/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_comp_responses_total

Connections (2 charts)

Connection Attempts

Entity scope: HAProxy backend
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_connection_attempts_total

Connection Reuses

Entity scope: HAProxy backend
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_connection_reuses_total

Errors (5 charts)

Aborts

Entity scope: HAProxy backend
Units: aborts/s
Dimensions: client, server

Source metric selectors (2)

haproxy_backend_client_aborts_total
haproxy_backend_server_aborts_total

Errors

Entity scope: HAProxy backend
Units: errors/s
Dimensions: response, connection, header_rewriting, internal

Source metric selectors (4)

haproxy_backend_response_errors_total
haproxy_backend_connection_errors_total
haproxy_backend_failed_header_rewriting_total
haproxy_backend_internal_errors_total

Requests Denied

Entity scope: HAProxy backend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_requests_denied_total

Responses Denied

Entity scope: HAProxy backend
Units: responses/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_responses_denied_total

Warnings

Entity scope: HAProxy backend
Units: warnings/s
Dimensions: retry, redispatch

Source metric selectors (2)

haproxy_backend_retry_warnings_total
haproxy_backend_redispatch_warnings_total

HTTP (4 charts)

HTTP Cache Hits

Entity scope: HAProxy backend
Units: hits/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_cache_hits_total

HTTP Cache Lookups

Entity scope: HAProxy backend
Units: lookups/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_cache_lookups_total

HTTP Requests

Entity scope: HAProxy backend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_requests_total

HTTP Responses

Entity scope: HAProxy backend
Units: responses/s
Dimensions: values of label code

Source metric selectors (1)

haproxy_backend_http_responses_total

Health (7 charts)

Available Servers

Entity scope: HAProxy backend
Units: servers
Dimensions: active, backup

Source metric selectors (2)

haproxy_backend_active_servers
haproxy_backend_backup_servers

Check Last Change Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_check_last_change_seconds

Downtime Seconds

Entity scope: HAProxy backend
Units: seconds/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_downtime_seconds_total

Failed Check State Transitions

Entity scope: HAProxy backend
Units: transitions/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_check_up_down_total

Load-Balanced Requests

Entity scope: HAProxy backend
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_loadbalanced_total

User Weight

Entity scope: HAProxy backend
Units: weight
Dimensions: value

Source metric selectors (1)

haproxy_backend_uweight

Weight

Entity scope: HAProxy backend
Units: weight
Dimensions: value

Source metric selectors (1)

haproxy_backend_weight

Queue (4 charts)

Current Queue

Entity scope: HAProxy backend
Units: requests
Dimensions: value

Source metric selectors (1)

haproxy_backend_current_queue

Max Queue

Entity scope: HAProxy backend
Units: requests
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_queue

Max Queue Time Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_queue_time_seconds

Queue Time Average Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_queue_time_average_seconds

Sessions (7 charts)

Current Session Rate

Entity scope: HAProxy backend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_current_session_rate

Current Sessions

Entity scope: HAProxy backend
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_backend_current_sessions

Last Session Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_last_session_seconds

Limit Sessions

Entity scope: HAProxy backend
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_backend_limit_sessions

Max Session Rate

Entity scope: HAProxy backend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_session_rate

Max Sessions

Entity scope: HAProxy backend
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_sessions

Sessions

Entity scope: HAProxy backend
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_sessions_total

Status (3 charts)

Aggregated Check Status

Entity scope: HAProxy backend
Units: servers
Dimensions: values of label state

Source metric selectors (1)

haproxy_backend_agg_check_status

Aggregated Server Status

Entity scope: HAProxy backend
Units: servers
Dimensions: values of label state

Source metric selectors (1)

haproxy_backend_agg_server_status

Status

Entity scope: HAProxy backend
Units: {status}
Dimensions: values of label state

Source metric selectors (1)

haproxy_backend_status

Timing (6 charts)

Average Total Time

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_total_time_average_seconds

Connect Time Average Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_connect_time_average_seconds

Max Connect Time Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_connect_time_seconds

Max Response Time Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_response_time_seconds

Maximum Total Time

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_max_total_time_seconds

Response Time Average Seconds

Entity scope: HAProxy backend
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_backend_response_time_average_seconds

Traffic (4 charts)

HTTP Compression Bytes Bypassed

Entity scope: HAProxy backend
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_comp_bytes_bypassed_total

HTTP Compression Bytes In

Entity scope: HAProxy backend
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_comp_bytes_in_total

HTTP Compression Bytes Out

Entity scope: HAProxy backend
Units: bytes/s
Dimensions: value

Source metric selectors (1)

haproxy_backend_http_comp_bytes_out_total

Traffic

Entity scope: HAProxy backend
Units: bytes/s
Dimensions: in, out

Source metric selectors (2)

haproxy_backend_bytes_in_total
haproxy_backend_bytes_out_total

Servers (48 charts)

Connections (7 charts)

Connection Attempts

Entity scope: HAProxy server
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_server_connection_attempts_total

Connection Reuses

Entity scope: HAProxy server
Units: connections/s
Dimensions: value

Source metric selectors (1)

haproxy_server_connection_reuses_total

Current Idle Connections

Entity scope: HAProxy server
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_server_idle_connections_current

Current Used Connections

Entity scope: HAProxy server
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_server_used_connections_current

Idle Connection Limit

Entity scope: HAProxy server
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_server_idle_connections_limit

Idle Connection Safety

Entity scope: HAProxy server
Units: connections
Dimensions: safe, unsafe

Source metric selectors (2)

haproxy_server_safe_idle_connections_current
haproxy_server_unsafe_idle_connections_current

Needed Connections

Entity scope: HAProxy server
Units: connections
Dimensions: value

Source metric selectors (1)

haproxy_server_need_connections_current

Errors (5 charts)

Aborts

Entity scope: HAProxy server
Units: aborts/s
Dimensions: client, server

Source metric selectors (2)

haproxy_server_client_aborts_total
haproxy_server_server_aborts_total

Check Failures

Entity scope: HAProxy server
Units: failures/s
Dimensions: value

Source metric selectors (1)

haproxy_server_check_failures_total

Errors

Entity scope: HAProxy server
Units: errors/s
Dimensions: response, connection, header_rewriting, internal

Source metric selectors (4)

haproxy_server_response_errors_total
haproxy_server_connection_errors_total
haproxy_server_failed_header_rewriting_total
haproxy_server_internal_errors_total

Responses Denied

Entity scope: HAProxy server
Units: responses/s
Dimensions: value

Source metric selectors (1)

haproxy_server_responses_denied_total

Warnings

Entity scope: HAProxy server
Units: warnings/s
Dimensions: retry, redispatch

Source metric selectors (2)

haproxy_server_retry_warnings_total
haproxy_server_redispatch_warnings_total

HTTP (2 charts)

HTTP Requests

Entity scope: HAProxy server
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_server_http_requests_total

HTTP Responses

Entity scope: HAProxy server
Units: responses/s
Dimensions: values of label code

Source metric selectors (1)

haproxy_server_http_responses_total

Health (12 charts)

Agent Code

Entity scope: HAProxy server
Units: code
Dimensions: value

Source metric selectors (1)

haproxy_server_agent_code

Agent Duration Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_agent_duration_seconds

Check Code

Entity scope: HAProxy server
Units: code
Dimensions: value

Source metric selectors (1)

haproxy_server_check_code

Check Duration Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_check_duration_seconds

Check Last Change Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_check_last_change_seconds

Current Throttle

Entity scope: HAProxy server
Units: percentage
Dimensions: value

Source metric selectors (1)

haproxy_server_current_throttle

Downtime Seconds

Entity scope: HAProxy server
Units: seconds/s
Dimensions: value

Source metric selectors (1)

haproxy_server_downtime_seconds_total

Failed Check State Transitions

Entity scope: HAProxy server
Units: transitions/s
Dimensions: value

Source metric selectors (1)

haproxy_server_check_up_down_total

Load-Balanced Requests

Entity scope: HAProxy server
Units: requests/s
Dimensions: value

Source metric selectors (1)

haproxy_server_loadbalanced_total

Server Role

Entity scope: HAProxy server
Units: servers
Dimensions: active, backup

Source metric selectors (2)

haproxy_server_active
haproxy_server_backup

User Weight

Entity scope: HAProxy server
Units: weight
Dimensions: value

Source metric selectors (1)

haproxy_server_uweight

Weight

Entity scope: HAProxy server
Units: weight
Dimensions: value

Source metric selectors (1)

haproxy_server_weight

Queue (5 charts)

Current Queue

Entity scope: HAProxy server
Units: requests
Dimensions: value

Source metric selectors (1)

haproxy_server_current_queue

Max Queue

Entity scope: HAProxy server
Units: requests
Dimensions: value

Source metric selectors (1)

haproxy_server_max_queue

Max Queue Time Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_max_queue_time_seconds

Queue Limit

Entity scope: HAProxy server
Units: requests
Dimensions: value

Source metric selectors (1)

haproxy_server_queue_limit

Queue Time Average Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_queue_time_average_seconds

Sessions (7 charts)

Current Session Rate

Entity scope: HAProxy server
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_server_current_session_rate

Current Sessions

Entity scope: HAProxy server
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_server_current_sessions

Last Session Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_last_session_seconds

Limit Sessions

Entity scope: HAProxy server
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_server_limit_sessions

Max Session Rate

Entity scope: HAProxy server
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_server_max_session_rate

Max Sessions

Entity scope: HAProxy server
Units: sessions
Dimensions: value

Source metric selectors (1)

haproxy_server_max_sessions

Sessions

Entity scope: HAProxy server
Units: sessions/s
Dimensions: value

Source metric selectors (1)

haproxy_server_sessions_total

Status (3 charts)

Agent Status

Entity scope: HAProxy server
Units: {status}
Dimensions: values of label state

Source metric selectors (1)

haproxy_server_agent_status

Check Status

Entity scope: HAProxy server
Units: {status}
Dimensions: values of label state

Source metric selectors (1)

haproxy_server_check_status

Status

Entity scope: HAProxy server
Units: {status}
Dimensions: values of label state

Source metric selectors (1)

haproxy_server_status

Timing (6 charts)

Average Total Time

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_total_time_average_seconds

Connect Time Average Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_connect_time_average_seconds

Max Connect Time Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_max_connect_time_seconds

Max Response Time Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_max_response_time_seconds

Maximum Total Time

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_max_total_time_seconds

Response Time Average Seconds

Entity scope: HAProxy server
Units: seconds
Dimensions: value

Source metric selectors (1)

haproxy_server_response_time_average_seconds

Traffic (1 chart)

Traffic

Entity scope: HAProxy server
Units: bytes/s
Dimensions: in, out

Source metric selectors (2)

haproxy_server_bytes_in_total
haproxy_server_bytes_out_total

Resolvers (15 charts)

DNS (15 charts)

Any Errors

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_any_err

CNAME

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_cname

CNAME Error

Entity scope: HAProxy nameserver
Units: errors/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_cname_error

Invalid

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_invalid

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_nx

Other

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_other

Outdated

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_outdated

Refused

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_refused

Send Error

Entity scope: HAProxy nameserver
Units: errors/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_send_error

Sent

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_sent

Timeout

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_timeout

Too Big

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_too_big

Truncated

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_truncated

Update

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_update

Valid

Entity scope: HAProxy nameserver
Units: queries/s
Dimensions: value

Source metric selectors (1)

haproxy_resolver_valid

Stick Tables (2 charts)

Entries (2 charts)

Size

Entity scope: HAProxy stick table
Units: entries
Dimensions: value

Source metric selectors (1)

haproxy_sticktable_size

Used

Entity scope: HAProxy stick table
Units: entries
Dimensions: value

Source metric selectors (1)

haproxy_sticktable_used

Troubleshooting

Debug Mode

Important: Debug mode is not supported for data collection jobs created via the UI using the Dyncfg feature.

To troubleshoot issues with the prometheus collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].
```
cd /usr/libexec/netdata/plugins.d/
```
Switch to the netdata user.
```
sudo -u netdata -s
```

Run the go.d.plugin to debug the collector:

./go.d.plugin -d -m prometheus

To debug a specific job:

./go.d.plugin -d -m prometheus -j jobName

Getting Logs

If you're encountering problems with the prometheus collector, follow these steps to retrieve logs and identify potential issues:

Run the command specific to your system (systemd, non-systemd, or Docker container).
Examine the output for any warnings or error messages that might indicate issues. These messages should provide clues about the root cause of the problem.

System with systemd

Use the following command to view logs generated since the last Netdata service restart:

journalctl _SYSTEMD_INVOCATION_ID="$(systemctl show --value --property=InvocationID netdata)" --namespace=netdata --grep prometheus

System without systemd

Locate the collector log file, typically at /var/log/netdata/collector.log, and use grep to filter for collector's name:

grep prometheus /var/log/netdata/collector.log

Note: This method shows logs from all restarts. Focus on the latest entries for troubleshooting current issues.

Docker Container

If your Netdata runs in a Docker container named "netdata" (replace if different), use this command:

docker logs netdata 2>&1 | grep prometheus

Disappearing or sparse metrics not clearing alerts

The Prometheus collector detects metrics that disappear from a successful scrape response. Generated charts and individual dimensions expire after their configured successful-cycle lifetime. An expired chart or dimension makes its alerts REMOVED; this is not a normal CLEAR transition and does not send a recovery notification. Export an explicit normal value (for example 0) whenever an alert needs a reliable recovery transition. A failed scrape does not advance the expiry lifetime; use the generic collector collection-failure alert to detect that separate condition.

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.

Overview​

Default Behavior​

Auto-Detection​

Limits​

Performance Impact​

Setup​

Prerequisites​

Enable the HAProxy Prometheus endpoint​

Configuration​

Options​

selector​

fallback_type​

relabeling​

profiles​

via UI​

via File​

Examples​

HAProxy Prometheus​

Alerts​

Metrics​

Troubleshooting​

Debug Mode​

Getting Logs​

System with systemd​

System without systemd​

Docker Container​

Disappearing or sparse metrics not clearing alerts​

Overview

Default Behavior

Auto-Detection

Limits

Performance Impact

Setup

Prerequisites

Enable the HAProxy Prometheus endpoint

Configuration

Options

selector

fallback_type

relabeling

profiles

via UI

via File

Examples

HAProxy Prometheus

Alerts

Metrics

Troubleshooting

Debug Mode

Getting Logs

System with systemd

System without systemd

Docker Container

Disappearing or sparse metrics not clearing alerts