Utiliser les intégrations de la communauté et du Marketplace
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
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>
Remarque : si besoin, ajoutez sudo -u dd-agent en tant que préfixe dans la commande d’installation.
La version de l’intégration est indiquée dans le changelog correspondant sur le référentiel Github de l’intégration.
Configurez votre intégration comme une intégration de base.
Redémarrez l’Agent.
Pour utiliser une intégration de la communauté ou du Marketplace dans un environnement conteneurisé, vous devez créer une image personnalisée qui inclut l’intégration souhaitée.
Utilisez le fichier Docker suivant pour concevoir une version personnalisée de l’Agent qui inclut la valeur <INTEGRATION_NAME> provenant de integrations-extras. Si vous installez une intégration du Marketplace, la valeur <INTEGRATION_NAME> est fournie dans les instructions de configuration.
FROM gcr.io/datadoghq/agent:latest
RUN agent integration install -r -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>
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.
Si vous utilisez Kubernetes, mettez à jour votre chart Helm ou la configuration de l’Operator Datadog afin d’obtenir votre image personnalisée.
Utilisez Autodiscovery pour activer et configurer l’intégration.
Pour l’Agent < v7.21/v6.21 :
- Téléchargez les fichiers dans le dossier
<INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/ depuis le référentiel integrations-extra. - Placez le fichier
<INTEGRATION_NAME>.py et tout autre fichier Python dans le répertoire checks.d de l’Agent. - Créez un dossier
<INTEGRATION_NAME>.d dans le répertoire de configuration de votre Agent. - Placez le fichier
conf.yaml.example situé dans le dossier <INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/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.
Si votre site restreint l’accès au réseau, assurez-vous d’avoir ajouté tous les ip-ranges à votre liste d’inclusion, ou téléchargez l’intégration manuellement.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
