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 de tu directorio de configuración del Agent para comenzar a recopilar tus métricas de Consul. Consulta el consul.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

   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 de nivel superior telemetry 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 utilizar 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 que envíe 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 los siguientes ajustes para garantizar que las métricas se etiquetan 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 las versiones 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. Consulta el consul.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

3. 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

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

La recopilación de logs está desactivada por defecto en el Datadog Agent. Para activarla, consulta recopilación de logs de Kubernetes.