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.

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.

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 :gear: (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_

Metrics

The built-in Prometheus profiles on this page map Prometheus metrics into 204 curated Netdata charts across the primary and applicable supporting profiles. The tables are 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.

HAProxy Prometheus

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

Process

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_process_recv_logs_total`	Process / Activity — Received Logs	`value`	`logs/s`	HAProxy worker process
`haproxy_process_relative_process_id`	Process / Activity — Relative Process ID	`value`	`process id`	HAProxy worker process
`haproxy_process_requests_total`	Process / Activity — Requests	`value`	`requests/s`	HAProxy worker process
`haproxy_process_nbthread`	Process / Activity — Threads	`value`	`threads`	HAProxy worker process
`haproxy_process_nbproc`	Process / Activity — Worker Processes	`value`	`processes`	HAProxy worker process
`haproxy_process_current_zlib_memory`	Process / Compression — Current Zlib Memory	`value`	`bytes`	HAProxy worker process
`haproxy_process_limit_http_comp`	Process / Compression — HTTP Compression Limit	`value`	`bytes/s`	HAProxy worker process
`haproxy_process_max_zlib_memory`	Process / Compression — Max Zlib Memory	`value`	`bytes`	HAProxy worker process
`haproxy_process_connections_total`	Process / Connections — Connections	`value`	`connections/s`	HAProxy worker process
`haproxy_process_current_connection_rate`	Process / Connections — Current Connection Rate	`value`	`connections/s`	HAProxy worker process
`haproxy_process_current_connections`	Process / Connections — Current Connections	`value`	`connections`	HAProxy worker process
`haproxy_process_hard_max_connections`	Process / Connections — Hard Max Connections	`value`	`connections`	HAProxy worker process
`haproxy_process_limit_connection_rate`	Process / Connections — Limit Connection Rate	`value`	`connections/s`	HAProxy worker process
`haproxy_process_max_connection_rate`	Process / Connections — Max Connection Rate	`value`	`connections/s`	HAProxy worker process
`haproxy_process_max_connections`	Process / Connections — Max Connections	`value`	`connections`	HAProxy worker process
`haproxy_process_max_fds`	Process / Connections — Max FDs	`value`	`file descriptors`	HAProxy worker process
`haproxy_process_max_pipes`	Process / Connections — Max Pipes	`value`	`pipes`	HAProxy worker process
`haproxy_process_max_sockets`	Process / Connections — Max Sockets	`value`	`sockets`	HAProxy worker process
`haproxy_process_pipes_used_total`	Process / Connections — Pipes	`used`	`pipes`	HAProxy worker process
`haproxy_process_pipes_free_total`	Process / Connections — Pipes	`free`	`pipes`	HAProxy worker process
`haproxy_process_dropped_logs_total`	Process / Errors — Dropped Logs	`value`	`logs/s`	HAProxy worker process
`haproxy_process_failed_resolutions`	Process / Errors — Failed Resolutions	`value`	`errors/s`	HAProxy worker process
`haproxy_process_total_warnings`	Process / Errors — Warnings	`value`	`warnings/s`	HAProxy worker process
`haproxy_process_active_peers`	Process / Health — Active Peers	`value`	`peers`	HAProxy worker process
`haproxy_process_max_memory_bytes`	Process / Memory — Max Memory Bytes	`value`	`bytes`	HAProxy worker process
`haproxy_process_pool_allocated_bytes`	Process / Memory — Pool Allocated Bytes	`value`	`bytes`	HAProxy worker process
`haproxy_process_pool_failures_total`	Process / Memory — Pool Failures	`value`	`failures/s`	HAProxy worker process
`haproxy_process_pool_used_bytes`	Process / Memory — Pool Used Bytes	`value`	`bytes`	HAProxy worker process
`haproxy_process_current_run_queue`	Process / Queue — Current Run Queue	`value`	`tasks`	HAProxy worker process
`haproxy_process_current_backend_ssl_key_rate`	Process / SSL — Current Backend SSL Key Rate	`value`	`keys/s`	HAProxy worker process
`haproxy_process_current_frontend_ssl_key_rate`	Process / SSL — Current Frontend SSL Key Rate	`value`	`keys/s`	HAProxy worker process
`haproxy_process_current_ssl_connections`	Process / SSL — Current SSL Connections	`value`	`connections`	HAProxy worker process
`haproxy_process_current_ssl_rate`	Process / SSL — Current SSL Rate	`value`	`connections/s`	HAProxy worker process
`haproxy_process_frontend_ssl_reuse`	Process / SSL — Frontend SSL Reuse	`value`	`percentage`	HAProxy worker process
`haproxy_process_limit_ssl_rate`	Process / SSL — Limit SSL Rate	`value`	`connections/s`	HAProxy worker process
`haproxy_process_max_backend_ssl_key_rate`	Process / SSL — Max Backend SSL Key Rate	`value`	`keys/s`	HAProxy worker process
`haproxy_process_max_frontend_ssl_key_rate`	Process / SSL — Max Frontend SSL Key Rate	`value`	`keys/s`	HAProxy worker process
`haproxy_process_max_ssl_connections`	Process / SSL — Max SSL Connections	`value`	`connections`	HAProxy worker process
`haproxy_process_max_ssl_rate`	Process / SSL — Max SSL Rate	`value`	`connections/s`	HAProxy worker process
`haproxy_process_ssl_cache_lookups_total`	Process / SSL — SSL Cache Lookups	`value`	`lookups/s`	HAProxy worker process
`haproxy_process_ssl_cache_misses_total`	Process / SSL — SSL Cache Misses	`value`	`events/s`	HAProxy worker process
`haproxy_process_ssl_connections_total`	Process / SSL — SSL Connections	`value`	`connections/s`	HAProxy worker process
`haproxy_process_connected_peers`	Process / Scheduler — Connected Peers	`value`	`peers`	HAProxy worker process
`haproxy_process_current_tasks`	Process / Scheduler — Current Tasks	`value`	`tasks`	HAProxy worker process
`haproxy_process_jobs`	Process / Scheduler — Jobs	`value`	`jobs`	HAProxy worker process
`haproxy_process_listeners`	Process / Scheduler — Listeners	`value`	`listeners`	HAProxy worker process
`haproxy_process_unstoppable_jobs`	Process / Scheduler — Unstoppable Jobs	`value`	`jobs`	HAProxy worker process
`haproxy_process_current_session_rate`	Process / Sessions — Current Session Rate	`value`	`sessions/s`	HAProxy worker process
`haproxy_process_limit_session_rate`	Process / Sessions — Limit Session Rate	`value`	`sessions/s`	HAProxy worker process
`haproxy_process_max_session_rate`	Process / Sessions — Max Session Rate	`value`	`sessions/s`	HAProxy worker process
`haproxy_process_busy_polling_enabled`	Process / Status — Busy Polling Enabled	`value`	`{status}`	HAProxy worker process
`haproxy_process_stopping`	Process / Status — Stopping	`value`	`{status}`	HAProxy worker process
`haproxy_process_idle_time_percent`	Process / Timing — Idle Time Percent	`value`	`percentage`	HAProxy worker process
`haproxy_process_uptime_seconds`	Process / Timing — Uptime Seconds	`value`	`seconds`	HAProxy worker process
`haproxy_process_bytes_out_total`	Process / Traffic — Bytes Out	`value`	`bytes/s`	HAProxy worker process
`haproxy_process_bytes_out_rate`	Process / Traffic — Bytes Out Rate	`value`	`bytes/s`	HAProxy worker process
`haproxy_process_http_comp_bytes_in_total`	Process / Traffic — HTTP Compression Bytes In	`value`	`bytes/s`	HAProxy worker process
`haproxy_process_http_comp_bytes_out_total`	Process / Traffic — HTTP Compression Bytes Out	`value`	`bytes/s`	HAProxy worker process
`haproxy_process_spliced_bytes_out_total`	Process / Traffic — Spliced Bytes Out	`value`	`bytes/s`	HAProxy worker process

Frontends

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_frontend_http_comp_responses_total`	Frontends / Compression — HTTP Compression Responses	`value`	`responses/s`	HAProxy frontend
`haproxy_frontend_connections_total`	Frontends / Connections — Connections	`value`	`connections/s`	HAProxy frontend
`haproxy_frontend_connections_rate_max`	Frontends / Connections — Connections Rate Max	`value`	`connections/s`	HAProxy frontend
`haproxy_frontend_denied_connections_total`	Frontends / Connections — Denied Connections	`value`	`connections/s`	HAProxy frontend
`haproxy_frontend_request_errors_total`	Frontends / Errors — Errors	`request`	`errors/s`	HAProxy frontend
`haproxy_frontend_failed_header_rewriting_total`	Frontends / Errors — Errors	`header_rewriting`	`errors/s`	HAProxy frontend
`haproxy_frontend_internal_errors_total`	Frontends / Errors — Errors	`internal`	`errors/s`	HAProxy frontend
`haproxy_frontend_requests_denied_total`	Frontends / Errors — Requests Denied	`value`	`requests/s`	HAProxy frontend
`haproxy_frontend_responses_denied_total`	Frontends / Errors — Responses Denied	`value`	`responses/s`	HAProxy frontend
`haproxy_frontend_http_cache_hits_total`	Frontends / HTTP — HTTP Cache Hits	`value`	`hits/s`	HAProxy frontend
`haproxy_frontend_http_cache_lookups_total`	Frontends / HTTP — HTTP Cache Lookups	`value`	`lookups/s`	HAProxy frontend
`haproxy_frontend_http_requests_total`	Frontends / HTTP — HTTP Requests	`value`	`requests/s`	HAProxy frontend
`haproxy_frontend_http_requests_rate_max`	Frontends / HTTP — HTTP Requests Rate Max	`value`	`requests/s`	HAProxy frontend
`haproxy_frontend_http_responses_total`	Frontends / HTTP — HTTP Responses	`values of label code`	`responses/s`	HAProxy frontend
`haproxy_frontend_intercepted_requests_total`	Frontends / HTTP — Intercepted Requests	`value`	`requests/s`	HAProxy frontend
`haproxy_frontend_current_session_rate`	Frontends / Sessions — Current Session Rate	`value`	`sessions/s`	HAProxy frontend
`haproxy_frontend_current_sessions`	Frontends / Sessions — Current Sessions	`value`	`sessions`	HAProxy frontend
`haproxy_frontend_denied_sessions_total`	Frontends / Sessions — Denied Sessions	`value`	`sessions/s`	HAProxy frontend
`haproxy_frontend_limit_session_rate`	Frontends / Sessions — Limit Session Rate	`value`	`sessions/s`	HAProxy frontend
`haproxy_frontend_limit_sessions`	Frontends / Sessions — Limit Sessions	`value`	`sessions`	HAProxy frontend
`haproxy_frontend_max_session_rate`	Frontends / Sessions — Max Session Rate	`value`	`sessions/s`	HAProxy frontend
`haproxy_frontend_max_sessions`	Frontends / Sessions — Max Sessions	`value`	`sessions`	HAProxy frontend
`haproxy_frontend_sessions_total`	Frontends / Sessions — Sessions	`value`	`sessions/s`	HAProxy frontend
`haproxy_frontend_status`	Frontends / Status — Status	`values of label state`	`{status}`	HAProxy frontend
`haproxy_frontend_http_comp_bytes_bypassed_total`	Frontends / Traffic — HTTP Compression Bytes Bypassed	`value`	`bytes/s`	HAProxy frontend
`haproxy_frontend_http_comp_bytes_in_total`	Frontends / Traffic — HTTP Compression Bytes In	`value`	`bytes/s`	HAProxy frontend
`haproxy_frontend_http_comp_bytes_out_total`	Frontends / Traffic — HTTP Compression Bytes Out	`value`	`bytes/s`	HAProxy frontend
`haproxy_frontend_bytes_in_total`	Frontends / Traffic — Traffic	`in`	`bytes/s`	HAProxy frontend
`haproxy_frontend_bytes_out_total`	Frontends / Traffic — Traffic	`out`	`bytes/s`	HAProxy frontend

Listeners

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_listener_connections_total`	Listeners / Connections — Connections	`value`	`connections/s`	HAProxy listener
`haproxy_listener_denied_connections_total`	Listeners / Connections — Denied Connections	`value`	`connections/s`	HAProxy listener
`haproxy_listener_request_errors_total`	Listeners / Errors — Errors	`request`	`errors/s`	HAProxy listener
`haproxy_listener_failed_header_rewriting_total`	Listeners / Errors — Errors	`header_rewriting`	`errors/s`	HAProxy listener
`haproxy_listener_internal_errors_total`	Listeners / Errors — Errors	`internal`	`errors/s`	HAProxy listener
`haproxy_listener_requests_denied_total`	Listeners / Errors — Requests Denied	`value`	`requests/s`	HAProxy listener
`haproxy_listener_responses_denied_total`	Listeners / Errors — Responses Denied	`value`	`responses/s`	HAProxy listener
`haproxy_listener_current_sessions`	Listeners / Sessions — Current Sessions	`value`	`sessions`	HAProxy listener
`haproxy_listener_denied_sessions_total`	Listeners / Sessions — Denied Sessions	`value`	`sessions/s`	HAProxy listener
`haproxy_listener_limit_sessions`	Listeners / Sessions — Limit Sessions	`value`	`sessions`	HAProxy listener
`haproxy_listener_max_sessions`	Listeners / Sessions — Max Sessions	`value`	`sessions`	HAProxy listener
`haproxy_listener_sessions_total`	Listeners / Sessions — Sessions	`value`	`sessions/s`	HAProxy listener
`haproxy_listener_status`	Listeners / Status — Status	`values of label state`	`{status}`	HAProxy listener
`haproxy_listener_bytes_in_total`	Listeners / Traffic — Traffic	`in`	`bytes/s`	HAProxy listener
`haproxy_listener_bytes_out_total`	Listeners / Traffic — Traffic	`out`	`bytes/s`	HAProxy listener

Backends

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_backend_http_comp_responses_total`	Backends / Compression — HTTP Compression Responses	`value`	`responses/s`	HAProxy backend
`haproxy_backend_connection_attempts_total`	Backends / Connections — Connection Attempts	`value`	`connections/s`	HAProxy backend
`haproxy_backend_connection_reuses_total`	Backends / Connections — Connection Reuses	`value`	`connections/s`	HAProxy backend
`haproxy_backend_client_aborts_total`	Backends / Errors — Aborts	`client`	`aborts/s`	HAProxy backend
`haproxy_backend_server_aborts_total`	Backends / Errors — Aborts	`server`	`aborts/s`	HAProxy backend
`haproxy_backend_response_errors_total`	Backends / Errors — Errors	`response`	`errors/s`	HAProxy backend
`haproxy_backend_connection_errors_total`	Backends / Errors — Errors	`connection`	`errors/s`	HAProxy backend
`haproxy_backend_failed_header_rewriting_total`	Backends / Errors — Errors	`header_rewriting`	`errors/s`	HAProxy backend
`haproxy_backend_internal_errors_total`	Backends / Errors — Errors	`internal`	`errors/s`	HAProxy backend
`haproxy_backend_requests_denied_total`	Backends / Errors — Requests Denied	`value`	`requests/s`	HAProxy backend
`haproxy_backend_responses_denied_total`	Backends / Errors — Responses Denied	`value`	`responses/s`	HAProxy backend
`haproxy_backend_retry_warnings_total`	Backends / Errors — Warnings	`retry`	`warnings/s`	HAProxy backend
`haproxy_backend_redispatch_warnings_total`	Backends / Errors — Warnings	`redispatch`	`warnings/s`	HAProxy backend
`haproxy_backend_http_cache_hits_total`	Backends / HTTP — HTTP Cache Hits	`value`	`hits/s`	HAProxy backend
`haproxy_backend_http_cache_lookups_total`	Backends / HTTP — HTTP Cache Lookups	`value`	`lookups/s`	HAProxy backend
`haproxy_backend_http_requests_total`	Backends / HTTP — HTTP Requests	`value`	`requests/s`	HAProxy backend
`haproxy_backend_http_responses_total`	Backends / HTTP — HTTP Responses	`values of label code`	`responses/s`	HAProxy backend
`haproxy_backend_active_servers`	Backends / Health — Available Servers	`active`	`servers`	HAProxy backend
`haproxy_backend_backup_servers`	Backends / Health — Available Servers	`backup`	`servers`	HAProxy backend
`haproxy_backend_check_last_change_seconds`	Backends / Health — Check Last Change Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_downtime_seconds_total`	Backends / Health — Downtime Seconds	`value`	`seconds/s`	HAProxy backend
`haproxy_backend_check_up_down_total`	Backends / Health — Failed Check State Transitions	`value`	`transitions/s`	HAProxy backend
`haproxy_backend_loadbalanced_total`	Backends / Health — Load-Balanced Requests	`value`	`requests/s`	HAProxy backend
`haproxy_backend_uweight`	Backends / Health — User Weight	`value`	`weight`	HAProxy backend
`haproxy_backend_weight`	Backends / Health — Weight	`value`	`weight`	HAProxy backend
`haproxy_backend_current_queue`	Backends / Queue — Current Queue	`value`	`requests`	HAProxy backend
`haproxy_backend_max_queue`	Backends / Queue — Max Queue	`value`	`requests`	HAProxy backend
`haproxy_backend_max_queue_time_seconds`	Backends / Queue — Max Queue Time Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_queue_time_average_seconds`	Backends / Queue — Queue Time Average Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_current_session_rate`	Backends / Sessions — Current Session Rate	`value`	`sessions/s`	HAProxy backend
`haproxy_backend_current_sessions`	Backends / Sessions — Current Sessions	`value`	`sessions`	HAProxy backend
`haproxy_backend_last_session_seconds`	Backends / Sessions — Last Session Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_limit_sessions`	Backends / Sessions — Limit Sessions	`value`	`sessions`	HAProxy backend
`haproxy_backend_max_session_rate`	Backends / Sessions — Max Session Rate	`value`	`sessions/s`	HAProxy backend
`haproxy_backend_max_sessions`	Backends / Sessions — Max Sessions	`value`	`sessions`	HAProxy backend
`haproxy_backend_sessions_total`	Backends / Sessions — Sessions	`value`	`sessions/s`	HAProxy backend
`haproxy_backend_agg_check_status`	Backends / Status — Aggregated Check Status	`values of label state`	`servers`	HAProxy backend
`haproxy_backend_agg_server_status`	Backends / Status — Aggregated Server Status	`values of label state`	`servers`	HAProxy backend
`haproxy_backend_status`	Backends / Status — Status	`values of label state`	`{status}`	HAProxy backend
`haproxy_backend_total_time_average_seconds`	Backends / Timing — Average Total Time	`value`	`seconds`	HAProxy backend
`haproxy_backend_connect_time_average_seconds`	Backends / Timing — Connect Time Average Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_max_connect_time_seconds`	Backends / Timing — Max Connect Time Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_max_response_time_seconds`	Backends / Timing — Max Response Time Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_max_total_time_seconds`	Backends / Timing — Maximum Total Time	`value`	`seconds`	HAProxy backend
`haproxy_backend_response_time_average_seconds`	Backends / Timing — Response Time Average Seconds	`value`	`seconds`	HAProxy backend
`haproxy_backend_http_comp_bytes_bypassed_total`	Backends / Traffic — HTTP Compression Bytes Bypassed	`value`	`bytes/s`	HAProxy backend
`haproxy_backend_http_comp_bytes_in_total`	Backends / Traffic — HTTP Compression Bytes In	`value`	`bytes/s`	HAProxy backend
`haproxy_backend_http_comp_bytes_out_total`	Backends / Traffic — HTTP Compression Bytes Out	`value`	`bytes/s`	HAProxy backend
`haproxy_backend_bytes_in_total`	Backends / Traffic — Traffic	`in`	`bytes/s`	HAProxy backend
`haproxy_backend_bytes_out_total`	Backends / Traffic — Traffic	`out`	`bytes/s`	HAProxy backend

Servers

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_server_connection_attempts_total`	Servers / Connections — Connection Attempts	`value`	`connections/s`	HAProxy server
`haproxy_server_connection_reuses_total`	Servers / Connections — Connection Reuses	`value`	`connections/s`	HAProxy server
`haproxy_server_idle_connections_current`	Servers / Connections — Current Idle Connections	`value`	`connections`	HAProxy server
`haproxy_server_used_connections_current`	Servers / Connections — Current Used Connections	`value`	`connections`	HAProxy server
`haproxy_server_idle_connections_limit`	Servers / Connections — Idle Connection Limit	`value`	`connections`	HAProxy server
`haproxy_server_safe_idle_connections_current`	Servers / Connections — Idle Connection Safety	`safe`	`connections`	HAProxy server
`haproxy_server_unsafe_idle_connections_current`	Servers / Connections — Idle Connection Safety	`unsafe`	`connections`	HAProxy server
`haproxy_server_need_connections_current`	Servers / Connections — Needed Connections	`value`	`connections`	HAProxy server
`haproxy_server_client_aborts_total`	Servers / Errors — Aborts	`client`	`aborts/s`	HAProxy server
`haproxy_server_server_aborts_total`	Servers / Errors — Aborts	`server`	`aborts/s`	HAProxy server
`haproxy_server_check_failures_total`	Servers / Errors — Check Failures	`value`	`failures/s`	HAProxy server
`haproxy_server_response_errors_total`	Servers / Errors — Errors	`response`	`errors/s`	HAProxy server
`haproxy_server_connection_errors_total`	Servers / Errors — Errors	`connection`	`errors/s`	HAProxy server
`haproxy_server_failed_header_rewriting_total`	Servers / Errors — Errors	`header_rewriting`	`errors/s`	HAProxy server
`haproxy_server_internal_errors_total`	Servers / Errors — Errors	`internal`	`errors/s`	HAProxy server
`haproxy_server_responses_denied_total`	Servers / Errors — Responses Denied	`value`	`responses/s`	HAProxy server
`haproxy_server_retry_warnings_total`	Servers / Errors — Warnings	`retry`	`warnings/s`	HAProxy server
`haproxy_server_redispatch_warnings_total`	Servers / Errors — Warnings	`redispatch`	`warnings/s`	HAProxy server
`haproxy_server_http_requests_total`	Servers / HTTP — HTTP Requests	`value`	`requests/s`	HAProxy server
`haproxy_server_http_responses_total`	Servers / HTTP — HTTP Responses	`values of label code`	`responses/s`	HAProxy server
`haproxy_server_agent_code`	Servers / Health — Agent Code	`value`	`code`	HAProxy server
`haproxy_server_agent_duration_seconds`	Servers / Health — Agent Duration Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_check_code`	Servers / Health — Check Code	`value`	`code`	HAProxy server
`haproxy_server_check_duration_seconds`	Servers / Health — Check Duration Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_check_last_change_seconds`	Servers / Health — Check Last Change Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_current_throttle`	Servers / Health — Current Throttle	`value`	`percentage`	HAProxy server
`haproxy_server_downtime_seconds_total`	Servers / Health — Downtime Seconds	`value`	`seconds/s`	HAProxy server
`haproxy_server_check_up_down_total`	Servers / Health — Failed Check State Transitions	`value`	`transitions/s`	HAProxy server
`haproxy_server_loadbalanced_total`	Servers / Health — Load-Balanced Requests	`value`	`requests/s`	HAProxy server
`haproxy_server_active`	Servers / Health — Server Role	`active`	`servers`	HAProxy server
`haproxy_server_backup`	Servers / Health — Server Role	`backup`	`servers`	HAProxy server
`haproxy_server_uweight`	Servers / Health — User Weight	`value`	`weight`	HAProxy server
`haproxy_server_weight`	Servers / Health — Weight	`value`	`weight`	HAProxy server
`haproxy_server_current_queue`	Servers / Queue — Current Queue	`value`	`requests`	HAProxy server
`haproxy_server_max_queue`	Servers / Queue — Max Queue	`value`	`requests`	HAProxy server
`haproxy_server_max_queue_time_seconds`	Servers / Queue — Max Queue Time Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_queue_limit`	Servers / Queue — Queue Limit	`value`	`requests`	HAProxy server
`haproxy_server_queue_time_average_seconds`	Servers / Queue — Queue Time Average Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_current_session_rate`	Servers / Sessions — Current Session Rate	`value`	`sessions/s`	HAProxy server
`haproxy_server_current_sessions`	Servers / Sessions — Current Sessions	`value`	`sessions`	HAProxy server
`haproxy_server_last_session_seconds`	Servers / Sessions — Last Session Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_limit_sessions`	Servers / Sessions — Limit Sessions	`value`	`sessions`	HAProxy server
`haproxy_server_max_session_rate`	Servers / Sessions — Max Session Rate	`value`	`sessions/s`	HAProxy server
`haproxy_server_max_sessions`	Servers / Sessions — Max Sessions	`value`	`sessions`	HAProxy server
`haproxy_server_sessions_total`	Servers / Sessions — Sessions	`value`	`sessions/s`	HAProxy server
`haproxy_server_agent_status`	Servers / Status — Agent Status	`values of label state`	`{status}`	HAProxy server
`haproxy_server_check_status`	Servers / Status — Check Status	`values of label state`	`{status}`	HAProxy server
`haproxy_server_status`	Servers / Status — Status	`values of label state`	`{status}`	HAProxy server
`haproxy_server_total_time_average_seconds`	Servers / Timing — Average Total Time	`value`	`seconds`	HAProxy server
`haproxy_server_connect_time_average_seconds`	Servers / Timing — Connect Time Average Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_max_connect_time_seconds`	Servers / Timing — Max Connect Time Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_max_response_time_seconds`	Servers / Timing — Max Response Time Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_max_total_time_seconds`	Servers / Timing — Maximum Total Time	`value`	`seconds`	HAProxy server
`haproxy_server_response_time_average_seconds`	Servers / Timing — Response Time Average Seconds	`value`	`seconds`	HAProxy server
`haproxy_server_bytes_in_total`	Servers / Traffic — Traffic	`in`	`bytes/s`	HAProxy server
`haproxy_server_bytes_out_total`	Servers / Traffic — Traffic	`out`	`bytes/s`	HAProxy server

Resolvers

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_resolver_any_err`	Resolvers / DNS — Any Errors	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_cname`	Resolvers / DNS — CNAME	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_cname_error`	Resolvers / DNS — CNAME Error	`value`	`errors/s`	HAProxy nameserver
`haproxy_resolver_invalid`	Resolvers / DNS — Invalid	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_nx`	Resolvers / DNS — NX	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_other`	Resolvers / DNS — Other	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_outdated`	Resolvers / DNS — Outdated	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_refused`	Resolvers / DNS — Refused	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_send_error`	Resolvers / DNS — Send Error	`value`	`errors/s`	HAProxy nameserver
`haproxy_resolver_sent`	Resolvers / DNS — Sent	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_timeout`	Resolvers / DNS — Timeout	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_too_big`	Resolvers / DNS — Too Big	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_truncated`	Resolvers / DNS — Truncated	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_update`	Resolvers / DNS — Update	`value`	`queries/s`	HAProxy nameserver
`haproxy_resolver_valid`	Resolvers / DNS — Valid	`value`	`queries/s`	HAProxy nameserver

Stick Tables

Prometheus metric	Netdata chart	Dimension	Unit	Scope
`haproxy_sticktable_size`	Stick Tables / Entries — Size	`value`	`entries`	HAProxy stick table
`haproxy_sticktable_used`	Stick Tables / Entries — Used	`value`	`entries`	HAProxy stick table

Alerts

There are no alerts configured by default for this integration.

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.

HAProxy Prometheus

HAProxy Prometheus

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

Metrics

HAProxy Prometheus

Process

Frontends

Listeners

Backends

Servers

Resolvers

Stick Tables

Alerts

Troubleshooting

Debug Mode

Getting Logs

System with systemd

System without systemd

Docker Container

Disappearing or sparse metrics not clearing alerts

The observability platform companies need to succeed

Book Your Free Demo