Referencia de métricas de OTel de HAProxy

Esta página proporciona una referencia completa de todas las métricas de HAProxy recopiladas a través de OpenTelemetry, incluidas las rutas de haproxyreceiver y del receptor Prometheus.

Descripción general

La integración de OpenTelemetry de HAProxy recopila métricas del extremo de estadísticas CSV de HAProxy a través del haproxyreceiver. Las métricas están organizadas en dos niveles:

Métricas predeterminadas (17): recopiladas automáticamente con la configuración predeterminada — suficientes para la mayoría de los casos de uso de monitoreo
Métricas opcionales (16): deshabilitadas de forma predeterminada, habilitadas individualmente en la sección del receptor metrics — útiles para la depuración detallada y la planificación de capacidad

Al usar la instalación guiada de NRDOT, puede elegir entre dos configuraciones:

Optimizado (menor ingesta): 17 métricas predeterminadas, intervalo de recopilación de 60 s, procesadores de optimización aplicados
Completo (detalle completo): 27 métricas (17 predeterminadas + 10 opcionales), intervalo de recopilación de 15 s

Sugerencia

Para habilitar métricas opcionales, agréguelas a la sección metrics de la configuración de su receptor haproxy con enabled: true. Consulte Monitoree HAProxy autohospedado con OpenTelemetry para obtener detalles de configuración.

Métrica predeterminada

Estas 17 métricas se recopilan con la configuración predeterminada (no se necesita la sección metrics).

Nombre de la métrica	Descripción	Tipo	Unidad
`haproxy.bytes.input`	Total de bytes recibidos por el proxy (recopilados por frontend, backend y servidor)	Suma (acumulativa)	Por
`haproxy.bytes.output`	Total de bytes enviados por el proxy (recopilados por frontend, backend y servidor)	Suma (acumulativa)	Por
`haproxy.connections.errors`	Número total de errores de conexión (solo backend y servidor)	Suma (acumulativa)	{errors}
`haproxy.connections.rate`	Número de conexiones por segundo durante el último segundo transcurrido (solo frontend)	Medidor	{connections}/s
`haproxy.connections.retries`	Número total de reintentos de conexión (solo backend y servidor)	Suma (acumulativa)	{retries}
`haproxy.requests.denied`	Número total de requests denegadas (frontend y backend)	Suma (acumulativa)	{requests}
`haproxy.requests.errors`	Número total de errores de solicitud (solo frontend)	Suma (acumulativa)	{errors}
`haproxy.requests.queued`	Número actual de requests en cola (solo backend y servidor)	Medidor	{requests}
`haproxy.requests.rate`	Número de requests HTTP por segundo durante el último segundo transcurrido (solo frontend)	Medidor	{requests}/s
`haproxy.requests.redispatched`	Número total de reenvíos de requests (solo backend y servidor)	Suma (acumulativa)	{requests}
`haproxy.requests.total`	Número total de requests HTTP recibidos (frontend y backend)	Suma (acumulativa)	{requests}
`haproxy.responses.denied`	Número total de respuestas denegadas (frontend, backend y servidor)	Suma (acumulativa)	{responses}
`haproxy.responses.errors`	Número total de errores de respuesta (solo backend y servidor)	Suma (acumulativa)	{errors}
`haproxy.server_selected.total`	Número total de veces que se seleccionó un servidor para el balanceo de carga (backend y servidor)	Suma (acumulativa)	{selections}
`haproxy.sessions.average`	Tiempo total de sesión promedio sobre las 1024 últimas requests, en segundos (backend y servidor)	Medidor	s
`haproxy.sessions.count`	Número actual de sesiones activas (frontend, backend y servidor)	Medidor	{sessions}
`haproxy.sessions.rate`	Número de sesiones por segundo durante el último segundo transcurrido (frontend, backend y servidor)	Medidor	{sessions}/s

Métricas opcionales

Estas 16 métricas están deshabilitadas de forma predeterminada. Habilítelas individualmente en la configuración de su recolector estableciendo enabled: true en la sección metrics del receptor.

La configuración integral de NRDOT habilita los primeros 10 de estos (marcados con [C]).

Nombre de la métrica	Descripción	Tipo	Unidad
`haproxy.connections.average_time` [C]	Tiempo de conexión promedio en segundos (monitoreo de latencia)	Medidor	s
`haproxy.requests.average_time` [C]	Tiempo de espera en cola promedio para requests en segundos	Medidor	s
`haproxy.responses.average_time` [C]	Tiempo de respuesta promedio en segundos	Medidor	s
`haproxy.active` [C]	Número de servidores activos en un backend	Medidor	{servers}
`haproxy.backup` [C]	Número de servidores de respaldo en un backend	Medidor	{servers}
`haproxy.downtime` [C]	Tiempo de inactividad total en segundos	Suma (acumulativa)	s
`haproxy.failed_checks` [C]	Número total de comprobaciones de estado fallidas	Suma (acumulativa)	{checks}
`haproxy.weight` [C]	Peso del servidor (utilizado en las decisiones de balanceo de carga)	Medidor	{weight}
`haproxy.sessions.total` [C]	Número total acumulado de sesiones	Suma (acumulativa)	{sessions}
`haproxy.connections.total` [C]	Número total acumulado de conexiones	Suma (acumulativa)	{connections}
`haproxy.compression.input`	Número total de bytes enviados al compresor	Suma (acumulativa)	Por
`haproxy.compression.output`	Número total de bytes emitidos por el compresor	Suma (acumulativa)	Por
`haproxy.compression.bypass`	Número total de bytes que omitieron la compresión	Suma (acumulativa)	Por
`haproxy.compression.responses`	Número total de respuestas HTTP que fueron comprimidas	Suma (acumulativa)	{responses}
`haproxy.clients.canceled`	Número total de transferencias de datos abortadas por el cliente	Suma (acumulativa)	{cancellations}
`haproxy.sessions.limit`	Límite de sesiones configurado para el proxy	Medidor	{sessions}

Atributos de recursos

Los siguientes atributos de recursos se adjuntan a todas las métricas de HAProxy, lo que proporciona contexto para filtrar y agrupar.

Atributo	Descripción	Valor de ejemplo
`haproxy.proxy_name`	Nombre del proxy HAProxy (del nombre de la sección frontend/backend/listen en haproxy.cfg)	`http_front` , `flask_backends` , `stats`
`haproxy.service_name`	Identificador de tipo o nombre del servidor: `FRONTEND` para agregados de frontend, `BACKEND` para agregados de backend o el nombre del servidor específico para métricas por servidor	`FRONTEND` , `BACKEND` , `backend-app-a` , `backend-app-b`
`haproxy.addr`	La URL del extremo de estadísticas que se extrajo (utilizada como parte del identificador de entidad)	`http://localhost:8404/stats`
`host.id`	Identificador único del host (de `/etc/machine-id` en Linux)	`ec23da5ead46571f2c3a9771b093658b`
`host.name`	Nombre de host de la máquina que ejecuta el recolector	`ip-172-31-7-195.ap-southeast-2.compute.internal`
`os.type`	Tipo de sistema operativo	`linux`

Identificador de entidad: la entidad de HAProxy en New Relic se sintetiza a partir de host.id + haproxy.addr (por ejemplo, ec23da5ead46571f2c3a9771b093658b:http://localhost:8404/stats).

Mapeo de métrica de Prometheus

Si utiliza la ruta del receptor de Prometheus, la siguiente tabla muestra cómo los nombres de las métricas de HAProxy Prometheus se asignan a los equivalentes de haproxyreceiver de OTel. Cada métrica de OTel puede tener múltiples fuentes de Prometheus (una por nivel: frontend, backend, servidor).

OTel métrica	Frontend de Prometheus	Backend de 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

Limitaciones conocidas de la ruta de Prometheus:

Sin FACET por código de estado: el haproxyreceiver analiza hrsp_* campos CSV en un atributo status_code en haproxy.requests.total. La ruta de Prometheus no admite esto — el desglose del código de respuesta HTTP está disponible solo como métricas separadas (haproxy_frontend_http_responses_total{code="2xx"}) no incluidas en la configuración de transformación.
Las métricas de tasa son máximos de por vida: haproxy.connections.rate se asigna a haproxy_frontend_connections_rate_max y haproxy.requests.rate se asigna a haproxy_frontend_http_requests_rate_max. Estos son valores máximos de por vida, no tasas instantáneas. Para obtener tasas actuales reales, use la función NRQL rate() en métricas de contador acumulativo.
-136 métricas de Prometheus no tienen equivalente en OTel: el extremo de Prometheus de HAProxy expone -204 métricas. Solo 36 se asignan a las 17 métricas predeterminadas de OTel (en los niveles de frontend/backend/servidor). El resto (aspectos internos del proceso, detalles de la comprobación de estado, estadísticas de resolución de DNS) no tienen equivalente en haproxyreceiver.

Consultas NRQL de muestra

Utilice estas consultas para explorar sus métricas de HAProxy en 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 pasos

Encuentra y consulta tus datos de HAProxy — dashboards, consultas NRQL y navegación de datos
Monitorear HAProxy autohospedado — configuración para máquinas virtuales (VM) de Linux o bare metal
Monitorear HAProxy en Kubernetes — descubrimiento automático de pods para entornos en contenedores
Crear condiciones de alerta NRQL — configure alertas basadas en sus métricas de HAProxy

Te ofrecemos esta traducción automática para facilitar la lectura.