Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

Collecte de métriques

1. Modifiez le fichier consul.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos métriques de performance Consul. Consultez le fichier d’exemple consul.d/conf.yaml pour découvrir toutes les options de configuration 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. Redémarrez l’Agent.

OpenMetrics

Vous avez également la possibilité d’activer l’option de configuration use_prometheus_endpoint pour obtenir des métriques supplémentaires à partir de l’endpoint Prometheus de Consul.

Remarque : utilisez DogStatsD ou Prometheus, mais n’activez pas les deux pour la même instance.

1. Configurez Consul de façon à exposer des métriques sur l’endpoint Prometheus. Définissez le paramètre prometheus_retention_time imbriqué sous la clé telemetry de premier niveau dans le fichier de configuration principal de Consul :

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

2. Modifiez le fichier consul.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à utiliser l’endpoint Prometheus.

   instances:
       - url: <EXAMPLE>
         use_prometheus_endpoint: true
   

3. Redémarrez l’Agent.

DogStatsD

Au lieu d’utiliser l’endpoint Prometheus, il est possible de configurer Consul de façon à envoyer les mêmes métriques supplémentaires à l’Agent par l’intermédiaire de DogStatsD.

1. Pour y parvenir, ajoutez votre dogstatsd_addr imbriqué sous la clé telemetry de premier niveau dans le fichier de configuration principal de Consul :

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

2. Pour veiller à ce que les métriques soient correctement taguées, modifiez le fichier de configuration principal de l’Agent Datadog datadog.yaml en y ajoutant les paramètres suivants :

   # 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. Redémarrez l’Agent.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml avec :

   logs_enabled: true
   

2. Modifiez ce bloc de configuration dans votre fichier consul.yaml pour recueillir vos logs Consul :

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

   Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement. Consultez le fichier d’exemple consul.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

3. Redémarrez l’Agent.

Environnement conteneurisé

Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.

Collecte de métriques

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs Kubernetes.