host

Recopilación de métricas

Para configurar este check para un Agent que se ejecuta en un host:

1. Edita el archivo HAProxy.d/conf.yaml en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para comenzar a recopilar tus métricas de HAProxy. Consulta el ejemplo haproxy.d/conf.yaml para conocer todas las opciones de configuración disponibles.

   instances:
   
     ## @param use_openmetrics - boolean - optional - default: false
     ## Enable to preview the new version of the check which supports HAProxy version 2 or later
     ## or environments using the HAProxy exporter.
     ##
     ## OpenMetrics-related options take effect only when this is set to `true`. 
     ##
     ## Uses the latest OpenMetrics V2 implementation for more features and better performance.
     ## Note: To see the configuration options for the OpenMetrics V1 implementation (Agent v7.33 or earlier),
     ## https://github.com/DataDog/integrations-core/blob/7.33.x/haproxy/datadog_checks/haproxy/data/conf.yaml.example
     #
   - use_openmetrics: true  # Enables OpenMetrics V2
   
     ## @param openmetrics_endpoint - string - optional
     ## The URL exposing metrics in the OpenMetrics format.
     #
     openmetrics_endpoint: http://localhost:<PORT>/metrics
   

   Para ver las opciones de configuración de la implementación heredada, consulta el archivo ejemplo haproxy.d/conf.yaml para el Agent v7.34 o anterior.

2. Reinicia el Agent.

En contenedores

Para entornos en contenedores, consulta las Plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.

Recopilación de métricas

Ejemplo de despliegue de Kubernetes

Añade anotaciones de pod en .spec.template.metadata para un despliegue:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: haproxy
spec:
  template:
    metadata:
      labels:
        name: haproxy
      annotations:
        ad.datadoghq.com/haproxy.check_names: '["haproxy"]'
        ad.datadoghq.com/haproxy.init_configs: '[{}]'
        ad.datadoghq.com/haproxy.instances: |
          [
            {
              "openmetrics_endpoint": "http://%%host%%:<PORT>/metrics", "use_openmetrics": "true"
            }
          ]
    spec:
      containers:
        - name: haproxy

host

Para configurar este check para un Agent que se ejecuta en un host:

Edita el archivo HAProxy.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para comenzar a recopilar tus métricas y logs de HAProxy. Consulta el ejemplo haproxy.d/conf.yaml para conocer todas las opciones de configuración disponibles.

Recopilación de métricas

1. Añade este bloque de configuración a tu archivo haproxy.d/conf.yaml para empezar a recopilar tus métricas de HAProxy:

   init_config:
   
   instances:
     ## @param url - string - required
     ## Haproxy URL to connect to gather metrics.
     ## Set the according <USERNAME> and <PASSWORD> or use directly a unix stats
     ## or admin socket: unix:///var/run/haproxy.sock
     #
     - url: http://localhost/admin?stats
   

2. Reinicia el Agent.

Recopilación de logs

Por defecto, Haproxy envía logs sobre UDP al puerto 514. El Agent puede escuchar estos logs en este puerto, pero la vinculación a un número de puerto por debajo de 1024 requiere permisos elevados. Sigue las siguientes instrucciones para configurarlo. También puedes utilizar un puerto diferente y omitir el paso 3.

1. La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent, actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

2. Añade este bloque de configuración a tu archivo haproxy.d/conf.yaml para empezar a recopilar tus logs de Haproxy:

   logs:
     - type: udp
       port: 514
       service: <SERVICE_NAME>
       source: haproxy
   

   Cambia el valor del parámetro service y configúralo para tu entorno. Consulta el ejemplo haproxy.d/conf.yaml para conocer todas las opciones de configuración disponibles.

3. Concede acceso al puerto 514 utilizando el comando setcap:

   sudo setcap CAP_NET_BIND_SERVICE=+ep /opt/datadog-agent/bin/agent/agent
   

   Comprueba que la configuración sea correcta ejecutando el comando getcap:

   sudo getcap /opt/datadog-agent/bin/agent/agent
   

   Con el resultado esperado:

   /opt/datadog-agent/bin/agent/agent = cap_net_bind_service+ep
   

   Nota: Vuelve a ejecutar este comando setcap cada vez que actualices el Agent.

4. Reinicia el Agent.

Docker

Para configurar este check para un Agent que se ejecuta en un contenedor:

Recopilación de métricas

Configura Plantillas de integraciones de Autodiscovery como etiquetas de Docker en tu contenedor de aplicaciones:

LABEL "com.datadoghq.ad.check_names"='["haproxy"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"url": "https://%%host%%/admin?stats"}]'

Recopilación de logs

La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent . Para activarla, consulta Recopilación de logs de Docker.

A continuación, configura Integraciones de logs como etiquetas de Docker:

LABEL "com.datadoghq.ad.logs"='[{"source":"haproxy","service":"<SERVICE_NAME>"}]'

Kubernetes

Para configurar este check para un Agent que se ejecuta en Kubernetes:

Recopilación de métricas

Configura Plantillas de integraciones de Autodiscovery como anotaciones de pod en tu contenedor de aplicaciones. Aparte de esto, las plantillas también se pueden configurar con un archivo, un mapa de configuración o un almacén de valores clave.

Anotaciones v1 (para el Datadog Agent v7.36 o anterior)

apiVersion: v1
kind: Pod
metadata:
  name: haproxy
  annotations:
    ad.datadoghq.com/haproxy.check_names: '["haproxy"]'
    ad.datadoghq.com/haproxy.init_configs: '[{}]'
    ad.datadoghq.com/haproxy.instances: |
      [
        {
          "url": "https://%%host%%/admin?stats"
        }
      ]
spec:
  containers:
    - name: haproxy

Anotaciones v2 (para el Datadog Agent v7.36 o posterior)

apiVersion: v1
kind: Pod
metadata:
  name: haproxy
  annotations:
    ad.datadoghq.com/haproxy.checks: |
      {
        "haproxy": {
          "init_config": {},
          "instances": [
            {
              "url": "https://%%host%%/admin?stats"
            }
          ]
        }
      }
spec:
  containers:
    - name: haproxy

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent. Para activarla, consulta Recopilación de logs de Kubernetes.

A continuación, configura Integraciones de logs como anotaciones del pod. Esto también se puede configurar con un archivo, un mapa de configuración o un almacén de valores clave.

Anotaciones v1/v2

apiVersion: v1
kind: Pod
metadata:
  name: haproxy
  annotations:
    ad.datadoghq.com/haproxy.logs: '[{"source":"haproxy","service":"<SERVICE_NAME>"}]'
spec:
  containers:
    - name: haproxy

ECS

Para configurar este check para un Agent que se ejecuta en ECS:

Recopilación de métricas

Configura Plantillas de integraciones de Autodiscovery como etiquetas de Docker en tu contenedor de aplicaciones:

{
  "containerDefinitions": [{
    "name": "haproxy",
    "image": "haproxy:latest",
    "dockerLabels": {
      "com.datadoghq.ad.check_names": "[\"haproxy\"]",
      "com.datadoghq.ad.init_configs": "[{}]",
      "com.datadoghq.ad.instances": "[{\"url\": \"https://%%host%%/admin?stats\"}]"
    }
  }]
}

Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent. Para activarla, consulta Recopilación de logs de ECS.

A continuación, configura Integraciones de logs como etiquetas de Docker:

{
  "containerDefinitions": [{
    "name": "haproxy",
    "image": "haproxy:latest",
    "dockerLabels": {
      "com.datadoghq.ad.logs": "[{\"source\":\"haproxy\",\"service\":\"<SERVICE_NAME>\"}]"
    }
  }]
}