Host

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

Recopilación de métricas

1. Edita el archivo consul.d/conf.yaml en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent para empezar a recopilar tus métricas de Consul. Para ver todas las opciones disponibles de configuración, consulta el ejemplo consul.d/conf.yaml.

   init_config:
   
   instances:
     ## @param url - string - required
     ## Where your Consul HTTP server lives,
     ## point the URL at the leader to get metrics about your Consul cluster.
     ## Use HTTPS instead of HTTP if your Consul setup is configured to do so.
     #
     - url: http://localhost:8500
   

2. Reinicia el Agent.

OpenMetrics

Opcionalmente, puedes habilitar la opción de configuración use_prometheus_endpoint para obtener un conjunto adicional de métricas del endpoint de Prometheus para Consul.

Nota: Utiliza el método DogStatsD o Prometheus; no habilites ambos para la misma instancia.

1. Configura Consul para exponer métricas al endpoint de Prometheus. Establece prometheus_retention_time anidado bajo la clave telemetry de nivel superior del archivo de configuración principal de Consul:

   {
     ...
     "telemetry": {
       "prometheus_retention_time": "360h"
     },
     ...
   }
   

2. Edita el archivo consul.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para empezar a usar el endpoint de Prometheus.

   instances:
       - url: <EXAMPLE>
         use_prometheus_endpoint: true
   

3. Reinicia el Agent.

DogStatsD

En lugar de utilizar el endpoint de Prometheus, puedes configurar Consul para enviar el mismo conjunto de métricas adicionales al Agent a través de DogStatsD.

1. Configura Consul para enviar métricas de DogStatsD añadiendo dogstatsd_addr anidado bajo la clave telemetry de nivel superior en el archivo de configuración principal de Consul:

   {
     ...
     "telemetry": {
       "dogstatsd_addr": "127.0.0.1:8125"
     },
     ...
   }
   

2. Actualiza el archivo de configuración principal del Datadog Agent datadog.yaml añadiendo las siguientes configuraciones para garantizar que las métricas estén etiquetadas correctamente:

   # dogstatsd_mapper_cache_size: 1000  # default to 1000
   dogstatsd_mapper_profiles:
     - name: consul
       prefix: "consul."
       mappings:
         - match: 'consul\.http\.([a-zA-Z]+)\.(.*)'
           match_type: "regex"
           name: "consul.http.request"
           tags:
             method: "$1"
             path: "$2"
         - match: 'consul\.raft\.replication\.appendEntries\.logs\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.appendEntries.logs"
           tags:
             peer_id: "$1"
         - match: 'consul\.raft\.replication\.appendEntries\.rpc\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.appendEntries.rpc"
           tags:
             peer_id: "$1"
         - match: 'consul\.raft\.replication\.heartbeat\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.heartbeat"
           tags:
             peer_id: "$1"
   

3. Reinicia el Agent.

Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

1. La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Habilítala en tu archivo datadog.yaml con:

   logs_enabled: true
   

2. Edita este bloque de configuración en tu archivo consul.yaml para recopilar logs de Consul:

   logs:
     - type: file
       path: /var/log/consul_server.log
       source: consul
       service: myservice
   

   Cambia los valores de los parámetros path y service y configúralos para tu entorno. Para conocer todas las opciones de configuración disponibles, consulta el consul.d/conf.yaml de ejemplo.

3. Reinicia el Agent.

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

Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta Recopilación de logs de Kubernetes.