Installation d'une intégration de la communauté

Installation d'une intégration de la communauté

Les intégrations développées par la communauté pour l’Agent Datadog sont stockées dans le référentiel Github Integrations-extra. Elles ne sont pas ajoutées au paquet ni intégrées à l’Agent Datadog, mais elles peuvent être installées comme extensions en suivant ces instructions :

Pour installer le check <NOM_INTÉGRATION> sur votre host :

  1. Téléchargez et lancez l’Agent Datadog.

  2. Exécutez la commande suivante pour installer les intégrations à l’aide de l’Agent :

    datadog-agent integration install -t <INTEGRATION_NAME>==<INTEGRATION_VERSION>
    
  3. Configurez votre intégration comme n’importe quelle autre intégration du package.

  4. Redémarrez l’Agent.

Le meilleur moyen d’utiliser une intégration provenant du référentiel integrations-extra avec l’Agent Docker est de générer une image de l’Agent avec cette intégration installée. Utilisez le Dockerfile suivant pour créer une version mise à jour de l’Agent comprenant l’intégration <NOM_INTÉGRATION> issue de integrations-extras.

FROM datadog/agent:latest
RUN agent integration install -r -t <NOM_INTÉGRATION>==<VERSION_INTÉGRATION>

La commande agent integration install exécutée au sein de Docker génère l’avertissement suivant : Error loading config: Config File "datadog" Not Found in "[/etc/datadog-agent]": warn. Vous pouvez l’ignorer.

Utilisez ensuite la nouvelle image de l’Agent conjointement avec Autodiscovery pour activer le check <NOM_INTÉGRATION>.

Pour installer le check <NOM_INTÉGRATION> sur votre host :

  1. Téléchargez l’Agent Datadog sur votre host.
  2. Téléchargez le fichier <NOM_INTÉGRATION>.py dans le répertoire <NOM_INTÉGRATION>/datadog_checks/<NOM_INTÉGRATION>/ du référentiel integrations-extra.
  3. Placez-le dans le répertoire checks.d de l’Agent.
  4. Téléchargez le fichier conf.yaml.example dans le répertoire <NOM_INTÉGRATION>/datadog_checks/<NOM_INTÉGRATION>/data/ du référentiel integrations-extra
  5. Renommez ce fichier conf.yaml.
  6. Créez un dossier <NOM_INTÉGRATION>.d dans le répertoire de configuration de votre Agent.
  7. Placez le fichier conf.yaml dans le répertoire créé à l’étape 6.
  8. Configurez votre intégration comme n’importe quelle autre intégration du package.
  9. Redémarrez l’Agent.

Pour aller plus loin