Overview

OpenTelemetry HAProxy metrics in an HAProxy dashboard

The HAProxy receiver allows for collection of HAProxy metrics and access to the out of the box HAProxy Dashboard, HAProxy Overview. Please configure the receiver according to the specifications of the latest version of the haproxyreceiver.

For more information, see the OpenTelemetry project documentation for the HAProxy receiver.

Setup

To collect HAProxy metrics with OpenTelemetry for use with Datadog:

  1. Configure the HAProxy receiver in your OpenTelemetry Collector configuration.
  2. Ensure the OpenTelemetry Collector is configured to export to Datadog.

Refer to the HAProxy receiver documentation for detailed configuration options and requirements.

Data collected

OTELDATADOGDESCRIPTIONFILTER
haproxy.bytes.inputhaproxy.backend.bytes.in.countBytes in. Corresponds to HAProxy’s bin metric.haproxy.service_name: BACKEND
haproxy.bytes.inputhaproxy.frontend.bytes.in.countBytes in. Corresponds to HAProxy’s bin metric.haproxy.service_name: FRONTEND
haproxy.bytes.outputhaproxy.backend.bytes.out.countBytes out. Corresponds to HAProxy’s bout metric.haproxy.service_name: BACKEND
haproxy.bytes.outputhaproxy.frontend.bytes.out.countBytes out. Corresponds to HAProxy’s bout metric.haproxy.service_name: FRONTEND
haproxy.clients.canceledhaproxy.backend.client.aborts.countNumber of data transfers aborted by the client. Corresponds to HAProxy’s cli_abrt metric
haproxy.compression.bypasshaproxy.backend.http.comp.bytes.bypassed.countNumber of bytes that bypassed the HTTP compressor (CPU/BW limit). Corresponds to HAProxy’s comp_byp metric.
haproxy.compression.counthaproxy.backend.http.comp.responses.countNumber of HTTP responses that were compressed. Corresponds to HAProxy’s comp_rsp metric.
haproxy.compression.inputhaproxy.backend.http.comp.bytes.in.countNumber of HTTP response bytes fed to the compressor. Corresponds to HAProxy’s comp_in metric.
haproxy.compression.outputhaproxy.backend.http.comp.bytes.out.countNumber of HTTP response bytes emitted by the compressor. Corresponds to HAProxy’s comp_out metric.
haproxy.connections.totalhaproxy.frontend.connections.countCumulative number of connections (frontend). Corresponds to HAProxy’s conn_tot metric.
haproxy.failed_checkshaproxy.server.check.failures.countNumber of failed checks. (Only counts checks failed when the server is up). Corresponds to HAProxy’s chkfail metric.
haproxy.requests.deniedhaproxy.backend.requests.denied.countRequests denied because of security concerns. Corresponds to HAProxy’s dreq metrichaproxy.service_name: BACKEND
haproxy.requests.deniedhaproxy.frontend.requests.denied.countRequests denied because of security concerns. Corresponds to HAProxy’s dreq metrichaproxy.service_name: FRONTEND
haproxy.requests.errorshaproxy.frontend.request.errors.countCumulative number of request errors. Corresponds to HAProxy’s ereq metric.haproxy.service_name: FRONTEND
haproxy.requests.totalhaproxy.backend.http.requests.countTotal number of HTTP requests received. Corresponds to HAProxy’s req_tot, hrsp_1xx, hrsp_2xx, hrsp_3xx, hrsp_4xx, hrsp_5xx and hrsp_other metrics.haproxy.service_name: BACKEND
haproxy.requests.totalhaproxy.frontend.http.requests.countTotal number of HTTP requests received. Corresponds to HAProxy’s req_tot, hrsp_1xx, hrsp_2xx, hrsp_3xx, hrsp_4xx, hrsp_5xx and hrsp_other metrics.haproxy.service_name: FRONTEND
haproxy.responses.deniedhaproxy.frontend.responses.denied.countResponses denied because of security concerns. Corresponds to HAProxy’s dresp metrichaproxy.service_name: FRONTEND
haproxy.responses.deniedhaproxy.backend.responses.denied.countResponses denied because of security concerns. Corresponds to HAProxy’s dresp metrichaproxy.service_name: BACKEND
haproxy.responses.errorshaproxy.backend.response.errors.countCumulative number of response errors. Corresponds to HAProxy’s eresp metric, srv_abrt will be counted here also.haproxy.service_name: BACKEND
haproxy.server_selected.totalhaproxy.server.loadbalanced.countNumber of times a server was selected, either for new sessions or when re-dispatching. Corresponds to HAProxy’s lbtot metric.
haproxy.sessions.counthaproxy.server.sessions.countCurrent sessions. Corresponds to HAProxy’s scur metric.
haproxy.sessions.totalhaproxy.frontend.sessions.countCumulative number of sessions. Corresponds to HAProxy’s stot metric.haproxy.service_name: FRONTEND
haproxy.sessions.totalhaproxy.backend.sessions.countCumulative number of sessions. Corresponds to HAProxy’s stot metric.haproxy.service_name: BACKEND

See OpenTelemetry Metrics Mapping for more information.

Further reading

Additional helpful documentation, links, and articles:

PREVIEWING: brett.blue/add-otel-integrations