Utiliser les intégrations de la communauté
Présentation
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 incluses dans le package de l’Agent Datadog, mais elles peuvent être installées comme extensions.
Configuration
Les nouveaux utilisateurs doivent télécharger et installer la dernière version de l’Agent Datadog.
Installation
Choisissez votre version de l’Agent :
Pour l’Agent v7.21+/6.21+ :
Exécutez la commande suivante pour installer l’intégration de l’Agent :
datadog-agent integration install -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>
Configurez votre intégration comme une intégration de base.
Redémarrez l’Agent.
Remarque : si besoin, ajoutez sudo -u dd-agent
en tant que préfixe dans la commande d’installation.
Pour utiliser une intégration de la communauté provenant du référentiel integrations-extra avec l’Agent Docker, nous vous recommandons de générer une image de l’Agent avec l’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 gcr.io/datadoghq/agent:latest
RUN agent integration install -r -t datadog-<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 cette nouvelle image de l’Agent conjointement avec Autodiscovery pour activer l’intégration <NOM_INTÉGRATION>
.
Pour l’Agent < v7.21/v6.21 :
- Téléchargez les fichiers dans le dossier
<NOM_INTÉGRATION>/datadog_checks/<NOM_INTÉGRATION>/
depuis le référentiel integrations-extra. - Placez le fichier
<NOM_INTÉGRATION>.py
et tout autre fichier Python dans le répertoire checks.d
de l’Agent. - Créez un dossier
<NOM_INTÉGRATION>.d
dans le répertoire de configuration de votre Agent. - Placez le fichier
conf.yaml.example
situé dans le dossier <NOM_INTÉGRATION>/datadog_checks/<NOM_INTÉGRATION>/data/
dans le répertoire créé. - Renommez ce fichier
conf.yaml
. - Configurez votre intégration comme une intégration de base.
- Redémarrez l’Agent.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: