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

Pour une explication détaillée du fonctionnement d’Autodiscovery, consultez Prise en main des conteneurs : Autodiscovery. Pour des options avancées d’Autodiscovery, telles que l’exclusion de certains conteneurs d’Autodiscovery ou la tolérance des pods non prêts, consultez Container Discovery Management.

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

Configurez votre intégration

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

Intégrations communautaires

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 Utiliser des intégrations communautaires pour les instructions.

Configuration

Certaines intégrations couramment utilisées sont livrées avec une configuration par défaut pour Autodiscovery. Consultez Autodiscovery auto-configuration pour plus de détails, y compris une liste des intégrations auto-configurées 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 (étiquettes Docker, un fichier local ou un magasin clé-valeur) qui convient à votre cas d’utilisation.
2. Référez-vous au 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 de remplacement

Fournissez les valeurs de remplacement comme suit :

<INTEGRATION_NAME>

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

<CONTAINER_IMAGE>

Un identifiant à faire correspondre avec l’image du 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. Voir Custom Autodiscovery Identifiers.

<INIT_CONFIG>

Les paramètres de configuration énuméré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>

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

<LOGS_CONFIG>

Les paramètres de configuration énuméré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 Autodiscovery auto-configuration est disponible. Les exemples suivants dé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 Autodiscovery template variables :

• %%host%% est peuplé dynamiquement avec l’IP du conteneur.
• %%env_REDIS_PASSWORD%% fait référence à une variable d’environnement nommée REDIS_PASSWORD telle que vue par le processus Agent.

Pour plus d’exemples, y compris comment configurer plusieurs vérifications pour plusieurs ensembles de conteneurs, voir Autodiscovery : Scénarios et Exemples.