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{servers}developmentnoNumber of active servers (backend) or server is active (server). Corresponds to HAProxy's act metric.
haproxy.backupgaugeint{servers}developmentnoNumber of backup servers (backend) or server is backup (server). Corresponds to HAProxy's bck metric.
haproxy.bytes.inputsum (monotonic)intBydevelopmentyesBytes in. Corresponds to HAProxy's bin metric.
haproxy.bytes.outputsum (monotonic)intBydevelopmentyesBytes out. Corresponds to HAProxy's bout metric.
haproxy.clients.canceledsum (monotonic)int{cancellations}developmentnoNumber of data transfers aborted by the client. Corresponds to HAProxy's cli_abrt metric
haproxy.compression.bypasssum (monotonic)intBydevelopmentnoNumber of bytes that bypassed the HTTP compressor (CPU/BW limit). Corresponds to HAProxy's comp_byp metric.
haproxy.compression.countsum (monotonic)int{responses}developmentnoNumber of HTTP responses that were compressed. Corresponds to HAProxy's comp_rsp metric.
haproxy.compression.inputsum (monotonic)intBydevelopmentnoNumber of HTTP response bytes fed to the compressor. Corresponds to HAProxy's comp_in metric.
haproxy.compression.outputsum (monotonic)intBydevelopmentnoNumber of HTTP response bytes emitted by the compressor. Corresponds to HAProxy's comp_out metric.
haproxy.connections.average_timegaugedoublemsdevelopmentnoAverage connect time in ms over the 1024 last requests. Corresponds to HAProxy's ctime metric.
haproxy.connections.errorssum (monotonic)int{errors}developmentyesNumber 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{connections}developmentyesNumber of connections over the last elapsed second (frontend). Corresponds to HAProxy's conn_rate metric.
haproxy.connections.retriessum (monotonic)int{retries}developmentyesNumber of times a connection to a server was retried. Corresponds to HAProxy's wretr metric.
haproxy.connections.totalsum (monotonic)int{connections}developmentnoCumulative number of connections (frontend). Corresponds to HAProxy's conn_tot metric.
haproxy.downtimesum (monotonic)intsdevelopmentnoTotal 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{checks}developmentnoNumber of failed checks. (Only counts checks failed when the server is up). Corresponds to HAProxy's chkfail metric.
haproxy.requests.average_timegaugedoublemsdevelopmentnoAverage queue time in ms over the 1024 last requests. Corresponds to HAProxy's qtime metric.
haproxy.requests.deniedsum (monotonic)int{requests}developmentyesRequests denied because of security concerns. Corresponds to HAProxy's dreq metric
haproxy.requests.errorssum (monotonic)int{errors}developmentyesCumulative number of request errors. Corresponds to HAProxy's ereq metric.
haproxy.requests.queuedsum (monotonic)int{requests}developmentyesCurrent queued requests. For the backend this reports the number queued without a server assigned. Corresponds to HAProxy's qcur metric.
haproxy.requests.rategaugedouble{requests}developmentyesHTTP requests per second over last elapsed second. Corresponds to HAProxy's req_rate metric.
haproxy.requests.redispatchedsum (monotonic)int{requests}developmentyesNumber of times a request was redispatched to another server. Corresponds to HAProxy's wredis metric.
haproxy.requests.totalsum (monotonic)int{requests}developmentyesstatus_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_timegaugedoublemsdevelopmentnoAverage response time in ms over the 1024 last requests. Corresponds to HAProxy's rtime metric.
haproxy.responses.deniedsum (monotonic)int{responses}developmentyesResponses denied because of security concerns. Corresponds to HAProxy's dresp metric
haproxy.responses.errorssum (monotonic)int{errors}developmentyesCumulative number of response errors. Corresponds to HAProxy's eresp metric, srv_abrt will be counted here also.
haproxy.server_selected.totalsum (monotonic)int{selections}developmentyesNumber of times a server was selected, either for new sessions or when re-dispatching. Corresponds to HAProxy's lbtot metric.
haproxy.sessions.averagegaugedoublemsdevelopmentyesAverage total session time in ms over the last 1024 requests. Corresponds to HAProxy's ttime metric.
haproxy.sessions.countgaugeint{sessions}developmentyesCurrent sessions. Corresponds to HAProxy's scur metric.
haproxy.sessions.limitgaugeint{sessions}developmentnoConfigured session limit. Corresponds to HAProxy's slim metric.
haproxy.sessions.rategaugedouble{sessions}developmentyesNumber of sessions per second over last elapsed second. Corresponds to HAProxy's rate metric.
haproxy.sessions.totalsum (monotonic)int{sessions}developmentnoCumulative number of sessions. Corresponds to HAProxy's stot metric.
haproxy.weightgaugeint1developmentnoTotal 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-cad95608641d.json
  • Explore: /collector/components/contrib/haproxyreceiver