This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/collector/components/contrib/haproxyreceiver.md.

HAProxy Receiver

OpenTelemetry Collector receiver · contrib distribution

The HAProxy receiver generates metrics by polling periodically the HAProxy process through a dedicated socket or HTTP URL.

  • Component ID: contrib-haproxyreceiver
  • Name: haproxyreceiver
  • Type: receiver
  • Distribution: contrib
  • Repository: opentelemetry-collector-contrib

Stability

LevelSignals
betametrics

Metrics

MetricTypeValue typeUnitStabilityEnabledAttributesDescription
haproxy.activegaugeint{server}betanoNumber of active servers (backend) or server is active (server). Corresponds to HAProxy's act metric.
haproxy.backupgaugeint{server}betanoNumber of backup servers (backend) or server is backup (server). Corresponds to HAProxy's bck metric.
haproxy.bytes.inputsum (monotonic)intBybetayesBytes in. Corresponds to HAProxy's bin metric.
haproxy.bytes.outputsum (monotonic)intBybetayesBytes out. Corresponds to HAProxy's bout metric.
haproxy.clients.canceledsum (monotonic)int{cancellation}betanoNumber of data transfers aborted by the client. Corresponds to HAProxy's cli_abrt metric
haproxy.compression.bypasssum (monotonic)intBybetanoNumber of bytes that bypassed the HTTP compressor (CPU/BW limit). Corresponds to HAProxy's comp_byp metric.
haproxy.compression.countsum (monotonic)int{response}betanoNumber of HTTP responses that were compressed. Corresponds to HAProxy's comp_rsp metric.
haproxy.compression.inputsum (monotonic)intBybetanoNumber of HTTP response bytes fed to the compressor. Corresponds to HAProxy's comp_in metric.
haproxy.compression.outputsum (monotonic)intBybetanoNumber of HTTP response bytes emitted by the compressor. Corresponds to HAProxy's comp_out metric.
haproxy.connections.average_timegaugedoublemsbetanoAverage connect time in ms over the 1024 last requests. Corresponds to HAProxy's ctime metric.
haproxy.connections.errorssum (monotonic)int{error}betayesNumber of requests that encountered an error trying to connect to a backend server. The backend stat is the sum of the stat. Corresponds to HAProxy's econ metric
haproxy.connections.rategaugeint{connection}betayesNumber of connections over the last elapsed second (frontend). Corresponds to HAProxy's conn_rate metric.
haproxy.connections.retriessum (monotonic)int{retry}betayesNumber of times a connection to a server was retried. Corresponds to HAProxy's wretr metric.
haproxy.connections.totalsum (monotonic)int{connection}betanoCumulative number of connections (frontend). Corresponds to HAProxy's conn_tot metric.
haproxy.downtimesum (monotonic)intsbetanoTotal downtime (in seconds). The value for the backend is the downtime for the whole backend, not the sum of the server downtime. Corresponds to HAProxy's downtime metric
haproxy.failed_checkssum (monotonic)int{check}betanoNumber of failed checks. (Only counts checks failed when the server is up). Corresponds to HAProxy's chkfail metric.
haproxy.requests.average_timegaugedoublemsbetanoAverage queue time in ms over the 1024 last requests. Corresponds to HAProxy's qtime metric.
haproxy.requests.deniedsum (monotonic)int{request}betayesRequests denied because of security concerns. Corresponds to HAProxy's dreq metric
haproxy.requests.errorssum (monotonic)int{error}betayesCumulative number of request errors. Corresponds to HAProxy's ereq metric.
haproxy.requests.queuedsum (monotonic)int{request}betayesCurrent queued requests. For the backend this reports the number queued without a server assigned. Corresponds to HAProxy's qcur metric.
haproxy.requests.rategaugedouble{request}betayesHTTP requests per second over last elapsed second. Corresponds to HAProxy's req_rate metric.
haproxy.requests.redispatchedsum (monotonic)int{request}betayesNumber of times a request was redispatched to another server. Corresponds to HAProxy's wredis metric.
haproxy.requests.totalsum (monotonic)int{request}betayesstatus_code (string)Total 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.responses.average_timegaugedoublemsbetanoAverage response time in ms over the 1024 last requests. Corresponds to HAProxy's rtime metric.
haproxy.responses.deniedsum (monotonic)int{response}betayesResponses denied because of security concerns. Corresponds to HAProxy's dresp metric
haproxy.responses.errorssum (monotonic)int{error}betayesCumulative number of response errors. Corresponds to HAProxy's eresp metric, srv_abrt will be counted here also.
haproxy.server_selected.totalsum (monotonic)int{selection}betayesNumber of times a server was selected, either for new sessions or when re-dispatching. Corresponds to HAProxy's lbtot metric.
haproxy.sessions.averagegaugedoublemsbetayesAverage total session time in ms over the last 1024 requests. Corresponds to HAProxy's ttime metric.
haproxy.sessions.countgaugeint{session}betayesCurrent sessions. Corresponds to HAProxy's scur metric.
haproxy.sessions.limitgaugeint{session}betanoConfigured session limit. Corresponds to HAProxy's slim metric.
haproxy.sessions.rategaugedouble{session}betayesNumber of sessions per second over last elapsed second. Corresponds to HAProxy's rate metric.
haproxy.sessions.totalsum (monotonic)int{session}betanoCumulative number of sessions. Corresponds to HAProxy's stot metric.
haproxy.weightgaugeint1betanoTotal effective weight (backend) or effective weight (server). Corresponds to HAProxy's weight metric.

Attributes

AttributeTypeDescription
status_codestringStatus code category, 1xx, 2xx, 3xx, 4xx, 5xx or other

Data

  • JSON (latest): /data/collector/components/contrib-haproxyreceiver/latest.json
  • JSON (pinned): /data/collector/components/contrib-haproxyreceiver/contrib-haproxyreceiver-2c69a019f6c7.json
  • Explore: /collector/components/contrib/haproxyreceiver