Referência de métricas do HAProxy OTel

Esta página fornece uma referência completa para todas as métricas do HAProxy coletadas via OpenTelemetry, incluindo os caminhos do haproxyreceiver e do receptor Prometheus.

Visão geral

A integração do HAProxy OpenTelemetry coleta métricas do endpoint de estatísticas CSV do HAProxy por meio do haproxyreceiver. As métricas são organizadas em dois níveis:

Métricas padrão (17): coletadas automaticamente com a configuração padrão — suficientes para a maioria dos casos de uso de monitoramento
Métricas opcionais (16): desativadas por padrão, ativadas individualmente na seção metrics do receiver — úteis para depuração detalhada e planejamento de capacidade

Ao usar a instalação guiada do NRDOT, você pode escolher entre duas configurações:

Otimizado (menor ingestão): 17 métricas padrão, intervalo de coleta de 60s, processadores de otimização aplicados
Abrangente (detalhes completos): 27 métricas (17 padrão + 10 opcionais), intervalo de coleta de 15s

Dica

Para habilitar métricas opcionais, adicione-as à seção metrics da configuração do seu receiver haproxy com enabled: true. Consulte Monitore o HAProxy auto-hospedado com OpenTelemetry para detalhes de configuração.

Métrica padrão

Estas 17 métricas são coletadas com a configuração padrão (nenhuma seção metrics é necessária).

Nome da métrica	Descrição	Tipo	Unidade
`haproxy.bytes.input`	Total de bytes recebidos pelo proxy (coletados por frontend, backend e servidor)	Soma (cumulativa)	Por
`haproxy.bytes.output`	Total de bytes enviados pelo proxy (coletados por frontend, backend e servidor)	Soma (cumulativa)	Por
`haproxy.connections.errors`	Número total de erros de conexão (apenas backend e servidor)	Soma (cumulativa)	{errors}
`haproxy.connections.rate`	Número de conexões por segundo no último segundo decorrido (apenas frontend)	Medidor	{connections}/s
`haproxy.connections.retries`	Número total de novas tentativas de conexão (apenas backend e servidor)	Soma (cumulativa)	{retries}
`haproxy.requests.denied`	Número total de requests negados (frontend e backend)	Soma (cumulativa)	{requests}
`haproxy.requests.errors`	Número total de erros de request (apenas frontend)	Soma (cumulativa)	{errors}
`haproxy.requests.queued`	Número atual de requests na fila (apenas backend e servidor)	Medidor	{requests}
`haproxy.requests.rate`	Número de requests HTTP por segundo durante o último segundo decorrido (apenas frontend)	Medidor	{requests}/s
`haproxy.requests.redispatched`	Número total de redespachos de requests (apenas backend e servidor)	Soma (cumulativa)	{requests}
`haproxy.requests.total`	Número total de requests HTTP recebidos (frontend e backend)	Soma (cumulativa)	{requests}
`haproxy.responses.denied`	Número total de respostas negadas (frontend, backend e servidor)	Soma (cumulativa)	{responses}
`haproxy.responses.errors`	Número total de erros de resposta (apenas backend e servidor)	Soma (cumulativa)	{errors}
`haproxy.server_selected.total`	Número total de vezes que um servidor foi selecionado para balanceamento de carga (backend e servidor)	Soma (cumulativa)	{selections}
`haproxy.sessions.average`	Tempo médio total de sessão sobre os últimos 1.024 requests, em segundos (backend e servidor)	Medidor	s
`haproxy.sessions.count`	Número atual de sessões ativas (frontend, backend e servidor)	Medidor	{sessions}
`haproxy.sessions.rate`	Número de sessões por segundo durante o último segundo decorrido (frontend, backend e servidor)	Medidor	{sessions}/s

Métricas opcionais

Estas 16 métricas estão desativadas por padrão. Ative-as individualmente na configuração do seu coletor definindo enabled: true na seção metrics do receiver.

A configuração abrangente do NRDOT habilita os primeiros 10 destes (marcados com [C]).

Nome da métrica	Descrição	Tipo	Unidade
`haproxy.connections.average_time` [C]	Tempo médio de conexão em segundos (monitoramento de latência)	Medidor	s
`haproxy.requests.average_time` [C]	Tempo médio de fila para requests em segundos	Medidor	s
`haproxy.responses.average_time` [C]	Tempo médio de resposta em segundos	Medidor	s
`haproxy.active` [C]	Número de servidores ativos em um backend	Medidor	{servers}
`haproxy.backup` [C]	Número de servidores de backup em um backend	Medidor	{servers}
`haproxy.downtime` [C]	Período de inatividade total em segundos	Soma (cumulativa)	s
`haproxy.failed_checks` [C]	Número total de verificações de integridade com falha	Soma (cumulativa)	{checks}
`haproxy.weight` [C]	Peso do servidor (usado em decisões de balanceamento de carga)	Medidor	{weight}
`haproxy.sessions.total` [C]	Número total acumulado de sessões	Soma (cumulativa)	{sessions}
`haproxy.connections.total` [C]	Número total acumulado de conexões	Soma (cumulativa)	{connections}
`haproxy.compression.input`	Número total de bytes enviados ao compressor	Soma (cumulativa)	Por
`haproxy.compression.output`	Número total de bytes emitidos pelo compressor	Soma (cumulativa)	Por
`haproxy.compression.bypass`	Número total de bytes que desviaram da compactação	Soma (cumulativa)	Por
`haproxy.compression.responses`	Número total de respostas HTTP que foram compactadas	Soma (cumulativa)	{responses}
`haproxy.clients.canceled`	Número total de transferências de dados abortadas pelo cliente	Soma (cumulativa)	{cancellations}
`haproxy.sessions.limit`	Limite de sessão configurado para o proxy	Medidor	{sessions}

Atributos de recurso

Os seguintes atributos de recurso são anexados a todas as métricas do HAProxy, fornecendo contexto para filtragem e agrupamento.

Atributo	Descrição	Valor de exemplo
`haproxy.proxy_name`	Nome do proxy HAProxy (do nome da seção frontend/backend/listen no haproxy.cfg)	`http_front` , `flask_backends` , `stats`
`haproxy.service_name`	Identificador de tipo ou nome do servidor: `FRONTEND` para agregações de frontend, `BACKEND` para agregações de backend ou o nome específico do servidor para métricas por servidor	`FRONTEND` , `BACKEND` , `backend-app-a` , `backend-app-b`
`haproxy.addr`	A URL do endpoint de estatísticas que foi coletada (usada como parte do identificador de entidade)	`http://localhost:8404/stats`
`host.id`	Identificador exclusivo do host (de `/etc/machine-id` no Linux)	`ec23da5ead46571f2c3a9771b093658b`
`host.name`	Nome do host da máquina que executa o coletor	`ip-172-31-7-195.ap-southeast-2.compute.internal`
`os.type`	Tipo de sistema operacional	`linux`

Identificador de entidade: A entidade do HAProxy no New Relic é sintetizada a partir de host.id + haproxy.addr (por exemplo, ec23da5ead46571f2c3a9771b093658b:http://localhost:8404/stats).

Mapeamento de métrica do Prometheus

Se você estiver usando o caminho do receiver do Prometheus, a tabela a seguir mostra como os nomes de métrica do HAProxy Prometheus são mapeados para os equivalentes do haproxyreceiver do OTel. Cada métrica do OTel pode ter várias fontes do Prometheus (uma por nível: frontend, backend, servidor).

OTel métrica	Frontend do Prometheus	Backend do Prometheus	Servidor Prometheus
`haproxy.bytes.input`	`haproxy_frontend_bytes_in_total`	`haproxy_backend_bytes_in_total`	`haproxy_server_bytes_in_total`
`haproxy.bytes.output`	`haproxy_frontend_bytes_out_total`	`haproxy_backend_bytes_out_total`	`haproxy_server_bytes_out_total`
`haproxy.connections.errors`	—	`haproxy_backend_connection_errors_total`	`haproxy_server_connection_errors_total`
`haproxy.connections.rate`	`haproxy_frontend_connections_rate_max`	—	—
`haproxy.connections.retries`	—	`haproxy_backend_retry_warnings_total`	`haproxy_server_retry_warnings_total`
`haproxy.requests.denied`	`haproxy_frontend_requests_denied_total`	`haproxy_backend_requests_denied_total`	—
`haproxy.requests.errors`	`haproxy_frontend_request_errors_total`	—	—
`haproxy.requests.queued`	—	`haproxy_backend_current_queue`	`haproxy_server_current_queue`
`haproxy.requests.rate`	`haproxy_frontend_http_requests_rate_max`	—	—
`haproxy.requests.redispatched`	—	`haproxy_backend_redispatch_warnings_total`	`haproxy_server_redispatch_warnings_total`
`haproxy.requests.total`	`haproxy_frontend_http_requests_total`	`haproxy_backend_http_requests_total`	—
`haproxy.responses.denied`	`haproxy_frontend_responses_denied_total`	`haproxy_backend_responses_denied_total`	`haproxy_server_responses_denied_total`
`haproxy.responses.errors`	—	`haproxy_backend_response_errors_total`	`haproxy_server_response_errors_total`
`haproxy.server_selected.total`	—	`haproxy_backend_loadbalanced_total`	`haproxy_server_loadbalanced_total`
`haproxy.sessions.average`	—	`haproxy_backend_total_time_average_seconds`	`haproxy_server_total_time_average_seconds`
`haproxy.sessions.count`	`haproxy_frontend_current_sessions`	`haproxy_backend_current_sessions`	`haproxy_server_current_sessions`
`haproxy.sessions.rate`	`haproxy_frontend_max_session_rate`	`haproxy_backend_max_session_rate`	`haproxy_server_max_session_rate`

Importante

Limitações conhecidas do caminho do Prometheus:

Sem FACET por código de status: o haproxyreceiver analisa hrsp_* campos CSV em um atributo status_code em haproxy.requests.total. O caminho do Prometheus não suporta isso — a divisão do código de resposta HTTP está disponível apenas como métricas separadas (haproxy_frontend_http_responses_total{code="2xx"}) não incluídas na configuração de transformação.
As métricas de taxa são máximos vitalícios: haproxy.connections.rate mapeia para haproxy_frontend_connections_rate_max e haproxy.requests.rate mapeia para haproxy_frontend_http_requests_rate_max. Esses são valores máximos vitalícios, não taxas instantâneas. Para taxas atuais reais, use a função NRQL rate() em métricas de contador cumulativo.
-136 métricas do Prometheus não têm equivalente no OTel: o endpoint do Prometheus do HAProxy expõe -204 métricas. Apenas 36 são mapeadas para as 17 métricas padrão do OTel (nos níveis de frontend/backend/servidor). O restante (detalhes internos do processo, detalhes de verificação de integridade, estatísticas do resolvedor DNS) não tem equivalente no haproxyreceiver.

Consultas NRQL de exemplo

Use estas consultas para explorar suas métricas do HAProxy na New Relic:

-- Current sessions across all frontends
FROM Metric SELECT latest(haproxy.sessions.count)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'FRONTEND'

-- Request rate per frontend over time
FROM Metric SELECT average(haproxy.requests.rate)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'FRONTEND'
TIMESERIES

-- Backend error rate (responses.errors as rate)
FROM Metric SELECT rate(sum(haproxy.responses.errors), 1 second)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'
TIMESERIES

-- Bytes throughput per backend
FROM Metric SELECT rate(sum(haproxy.bytes.input), 1 minute) AS 'Bytes In/min',
  rate(sum(haproxy.bytes.output), 1 minute) AS 'Bytes Out/min'
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'

-- Average session time per backend (latency indicator)
FROM Metric SELECT average(haproxy.sessions.average)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'

-- Per-server session count (individual backend servers)
FROM Metric SELECT latest(haproxy.sessions.count)
FACET haproxy.proxy_name, haproxy.service_name
WHERE haproxy.service_name NOT IN ('FRONTEND', 'BACKEND')

-- Queued requests (indicates backend saturation)
FROM Metric SELECT max(haproxy.requests.queued)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'
TIMESERIES

Próximos passos

Encontre e consulte seus dados do HAProxy — dashboards, consultas NRQL e navegação de dados
Monitorar HAProxy auto-hospedado — configuração para VMs Linux ou bare metal
Monitorar HAProxy no Kubernetes — descoberta automática de pod para ambientes conteinerizados
Criar condições de alerta NRQL — configure alertas com base em suas métricas do HAProxy

Esta tradução de máquina é fornecida para sua comodidade.