Cette page explique comment installer et configurer des intégrations pour votre infrastructure Docker en utilisant une fonctionnalité Datadog appelée Autodiscovery. Autodiscovery vous permet d’utiliser des variables comme %%host%% pour renseigner dynamiquement vos paramètres de configuration.

Pour obtenir une explication détaillée du fonctionnement d’Autodiscovery, consultez la section Débuter avec les conteneurs : Autodiscovery. Pour les options avancées d’Autodiscovery, telles que l’exclusion de certains conteneurs d’Autodiscovery ou la tolérance des pods non prêts, consultez la section Gestion de la découverte de conteneurs.

Si vous utilisez Kubernetes, consultez la section Kubernetes et intégrations.

Configurer votre intégration

Certaines intégrations nécessitent des étapes de configuration, telles que la création d’un token d’accès ou l’octroi d’une autorisation de lecture à l’Agent Datadog. Suivez les instructions de la section Configuration de la documentation de votre intégration.

Intégrations de la communauté

Pour utiliser une intégration qui n’est pas fournie avec l’Agent Datadog, vous devez créer une image personnalisée contenant l’intégration souhaitée. Consultez la section Utiliser des intégrations de la communauté pour obtenir des instructions.

Configuration

Certaines intégrations couramment utilisées sont fournies avec une configuration par défaut pour Autodiscovery. Consultez la section Configuration automatique d’Autodiscovery pour obtenir des détails, notamment une liste des intégrations configurées automatiquement et leurs fichiers de configuration par défaut correspondants. Si votre intégration figure dans cette liste et que la configuration par défaut est suffisante pour votre cas d’utilisation, aucune action supplémentaire n’est requise.

Sinon :

1. Choisissez une méthode de configuration (labels Docker, un fichier local ou un key-value store) adaptée à votre cas d’utilisation.
2. Référencez le format de modèle pour la méthode choisie. Chaque format contient des espaces réservés, tels que <CONTAINER_IMAGE>.
3. Fournissez des valeurs pour ces espaces réservés.

LABEL "com.datadoghq.ad.checks"='{"<INTEGRATION_NAME>": {"instances": [<INSTANCE_CONFIG>], "logs": [<LOGS_CONFIG>]}}'

LABEL "com.datadoghq.ad.check_names"='[<INTEGRATION_NAME>]'
LABEL "com.datadoghq.ad.init_configs"='[<INIT_CONFIG>]'
LABEL "com.datadoghq.ad.instances"='[<INSTANCE_CONFIG>]'
LABEL "com.datadoghq.ad.logs"='[<LOGS_CONFIG>]'

labels :
  com.datadoghq.ad.checks : '{"<INTEGRATION_NAME>" : {"instances" : [<INSTANCE_CONFIG>], "logs" : [<LOGS_CONFIG>]}}'

labels:
  com.datadoghq.ad.check_names: '[<INTEGRATION_NAME>]'
  com.datadoghq.ad.init_configs: '[<INIT_CONFIG>]'
  com.datadoghq.ad.instances: '[<INSTANCE_CONFIG>]'
  com.datadoghq.ad.logs: '[<LOGS_CONFIG>]'

docker run -l com.datadoghq.ad.checks="{\"<INTEGRATION_NAME>\": {\"instances\": [<INSTANCE_CONFIG>], \"logs\": [<LOGS_CONFIG>]}}"

docker run -l com.datadoghq.ad.check_names='[<INTEGRATION_NAME>]' -l com.datadoghq.ad.init_configs='[<INIT_CONFIG>]' -l com.datadoghq.ad.instances='[<INSTANCE_CONFIG>]' -l com.datadoghq.ad.logs='[<LOGS_CONFIG>]'

docker run -l "com.datadoghq.ad.checks="{\"apache\": {\"instances\": [{\"apache_status_url\":\"http://%%host%%/server-status?auto2\"}]}}"

version: "1.0"
services:
...
  project:
    image: '<IMAGE_NAME>'
    labels:
      com.datadoghq.ad.checks: '{"<INTEGRATION_NAME>": {"instances": [<INSTANCE_CONFIG>], "logs": [<LOGS_CONFIG>]}}'

version: "1.0"
services:
...
  project:
    image: '<IMAGE_NAME>'
    labels:
      com.datadoghq.ad.check_names: '[<INTEGRATION_NAME>]'
      com.datadoghq.ad.init_configs: '[<INIT_CONFIG>]'
      com.datadoghq.ad.instances: '[<INSTANCE_CONFIG>]'
      com.datadoghq.ad.logs: '[<LOGS_CONFIG>]'

config_providers:
  - name: etcd
    polling: true
    template_dir: /datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    username:
    password:

  - name: consul
    polling: true
    template_dir: datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    ca_file:
    ca_path:
    cert_file:
    key_file:
    username:
    password:
    token:

  - name: zookeeper
    polling: true
    template_dir: /datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    username:
    password:

/datadog/
  check_configs/
    <CONTAINER_IMAGE>/
      - check_names: ["<INTEGRATION_NAME>"]
      - init_configs: ["<INIT_CONFIG>"]
      - instances: ["<INSTANCES_CONFIG>"]
      - logs: ["<LOGS_CONFIG>"]
    ...

Valeurs des espaces réservés

Fournir les valeurs des espaces réservés comme suit :

<INTEGRATION_NAME>

Nom de votre intégration Datadog, tel que etcd ou redisdb.

<CONTAINER_IMAGE>

Identifiant à mettre en correspondance avec l’image de conteneur.

Par exemple : si vous fournissez redis comme identifiant de conteneur, votre modèle Autodiscovery est appliqué à tous les conteneurs dont les noms d’image correspondent à redis. Si vous avez un conteneur exécutant foo/redis:latest et bar/redis:v2, votre modèle Autodiscovery est appliqué aux deux conteneurs.

Le paramètre ad_identifiers prend une liste, vous pouvez donc fournir plusieurs identifiants de conteneur. Vous pouvez également utiliser des identifiants personnalisés. Consultez la section Identifiants Autodiscovery personnalisés.

<INIT_CONFIG>

Paramètres de configuration répertoriés sous init_config dans le fichier <INTEGRATION_NAME>.d/conf.yaml.example de votre intégration. La section init_config est généralement vide.

<INSTANCES_CONFIG>

Paramètres de configuration répertoriés sous instances dans le fichier <INTEGRATION_NAME>.d/conf.yaml.example de votre intégration.

<LOGS_CONFIG>

Paramètres de configuration répertoriés sous logs dans le fichier <INTEGRATION_NAME>.d/conf.yaml.example de votre intégration.

Exemples

Intégration Redis

Redis est l’une des technologies pour lesquelles la configuration automatique d’Autodiscovery est disponible. Les exemples suivants montrent comment remplacer cette configuration de base par une configuration personnalisée qui fournit un paramètre password.

Stockez votre mot de passe en tant que variable d’environnement nommée REDIS_PASSWORD, puis :

labels:
  com.datadoghq.ad.checks: '{"redisdb": {"instances": [{"host": "%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}], "logs": [{"type": "file", "path": "/var/log/redis_6379.log", "source": "redis", "service": "redis_service"}]}}'

labels:
  com.datadoghq.ad.check_names: '["redisdb"]'
  com.datadoghq.ad.init_configs: '[{}]'
  com.datadoghq.ad.instances: '[{"host": "%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}]'
  com.datadoghq.ad.logs: '[{"type": "file", "path": "/var/log/redis_6379.log", "source": "redis", "service": "redis_service"}]'

etcdctl mkdir /datadog/check_configs/redis
etcdctl set /datadog/check_configs/redis/check_names '["redisdb"]'
etcdctl set /datadog/check_configs/redis/init_configs '[{}]'
etcdctl set /datadog/check_configs/redis/instances '[{"host": "%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}]'

Tous ces exemples utilisent des variables de modèle Autodiscovery :

• %%host%% récupère dynamiquement l’adresse IP du conteneur.
• %%env_REDIS_PASSWORD%% se réfère à la variable d’environnement REDIS_PASSWORD détectée par le processus de l’Agent.

Pour plus d’exemples, notamment sur la façon de configurer plusieurs checks pour plusieurs ensembles de conteneurs, consultez la section Autodiscovery : scénarios et exemples.