Installation d'une intégration de la communauté
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

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. Installez le kit de développement logiciel.
  2. Clonez le dépôt integrations-extras :

    git clone https://github.com/DataDog/integrations-extras.git.
  3. Mettez à jour votre configuration ddev avec le chemin integrations-extras/ :

    ddev config set extras ./integrations-extras
  4. Pour créer le paquet <NOM_INTÉGRATION>, exécutez :

    ddev -e release build <INTEGRATION_NAME>
  5. Téléchargez et lancez l’Agent Datadog.

  6. Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :

    datadog-agent integration install -w <PATH_OF_INTEGRATION_NAME_PACKAGE>/<ARTIFACT_NAME>.whl
  7. Configurez votre intégration comme n’importe quelle autre intégration du paquet.

  8. Redémarrez l’Agent.

Le meilleur moyen d’utiliser une intégration provenant du dépôt 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 python:3.8 AS wheel_builder
WORKDIR /wheels
RUN pip install "datadog-checks-dev[cli]"
RUN git clone https://github.com/DataDog/integrations-extras.git
RUN ddev config set extras ./integrations-extras
RUN ddev -e release build <NOM_INTÉGRATION>

FROM datadog/agent:latest
COPY --from=wheel_builder /wheels/integrations-extras/<NOM_INTÉGRATION>/dist/ /dist
RUN agent -c /etc/datadog-agent/datadog-docker.yaml integration install -r -w /dist/*.whl

Utilisez ensuite la nouvelle image de l’Agent en combinaison 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 paquet.
  9. Redémarrez l’Agent.

Pour aller plus loin