Présentation des intégrations
Présentation
Ce guide décrit comment utiliser les intégrations. Si vous souhaitez découvrir comment créer une nouvelle intégration, consultez la page Créer une nouvelle intégration.
Au plus haut niveau, une intégration correspond à l’assemblage d’un système unifié à partir d’unités habituellement considérées séparément. Avec Datadog, vous pouvez utiliser des intégrations pour rassembler toutes les métriques et tous les logs de votre infrastructure afin d’analyser le système dans son ensemble. Chaque composant, ainsi que son impact sur les autres éléments de votre infrastructure, peuvent être étudiés en détail.
Remarque : nous vous conseillons de mettre en place la collecte de métriques sur vos projets le plus tôt possible dans le processus de développement, mais vous pouvez commencer à n’importe quelle étape.
Datadog propose trois grands types d’intégrations :
- Les intégrations basées sur l’Agent sont installées avec l’Agent Datadog et utilisent une méthode de classe Python appelée
check
pour définir les métriques à recueillir. - Les intégrations basées sur un système d’authentification (crawler) sont configurées dans l’application Datadog, où vous entrez des identifiants pour récupérer des métriques avec l’API. Il s’agit notamment d’intégrations populaires telles que Slack, AWS, Azure, et PagerDuty.
- Les intégrations de bibliothèque utilisent l’API Datadog pour vous permettre de surveiller des applications en fonction du langage dans lequel elles sont écrites, comme Node.js ou Python.
Vous pouvez aussi créer un check custom pour définir et envoyer des métriques à Datadog depuis un système interne unique.
Le package de l’Agent Datadog inclut les intégrations officiellement prises en charge par Datadog dans integrations-core. Pour utiliser ces intégrations, téléchargez l’Agent Datadog. Les intégrations développées par la communauté se trouvent dans integrations-extras. Pour en savoir plus sur l’installation ou la gestion de ces intégrations, consultez le guide de gestion des intégrations.
Autorisations
L’autorisation manage_integrations
est requise pour interagir avec un carré dʼintégration. Consultez la section relative aux rôles RBAC pour en savoir plus.
Clés d’API et d’application
Pour installer l’Agent Datadog, vous devez disposer d’une clé d’API. Si l’Agent est déjà téléchargé, veillez à configurer votre clé d’API dans le fichier datadog.yaml
. Pour utiliser la plupart des fonctionnalités Datadog et envoyer des métriques et des événements, vous devez disposer d’une clé d’application. Accédez à la page API Settings pour gérer vos clés d’API et d’application.
Installation
Si vous souhaitez connecter une intégration basée sur une bibliothèque ou un crawler, des instructions spécifiques à chaque fournisseur sont disponibles sur la page Intégrations. Pour les autres intégrations prises en charge, installez l’Agent Datadog. La plupart des intégrations sont prises en charge sur nos Agents conteneurisés : Docker et Kubernetes. Une fois l’Agent téléchargé, accédez à la page Intégrations pour consulter les instructions dédiées à votre intégration.
La plupart des paramètres de configuration sont spécifiques à chaque intégration. Configurez les intégrations de l’Agent en accédant au dossier conf.d
à la racine du répertoire de configuration de votre Agent. Chaque intégration dispose d’un dossier nommé <NOM_INTÉGRATION>.d
, contenant le fichier conf.yaml.example
. Cet exemple de fichier énumère toutes les options de configuration disponibles pour cette intégration spécifique.
Pour activer une intégration donnée :
- Renommez le fichier
conf.yaml.example
(dans le dossier <NOM_INTÉGRATION>.d
correspondant) en conf.yaml
. - Dans le nouveau fichier de configuration, modifiez les paramètres requis avec les valeurs correspondant à votre environnement.
- Redémarrez l’Agent Datadog.
Remarque : tous les fichiers de configuration respectent le format décrit sous la spécification @param.
Par exemple, voici le fichier de configuration conf.yaml
minimal nécessaire pour recueillir des métriques et des logs de l’intégration apache :
init_config:
service: apache
instances:
- apache_status_url: http://localhost/server-status?auto
logs:
- type: file
path: /var/log/apache2/access.log
source: apache
sourcecategory: http_web_access
- type: file
path: /var/log/apache2/error.log
source: apache
sourcecategory: http_web_access
Pour surveiller plusieurs instances Apache dans un même check d’Agent, ajoutez des instances supplémentaires à la section instances
:
init_config:
instances:
- apache_status_url: "http://localhost/server-status?auto"
service: local-apache
- apache_status_url: "http://<ENDPOINT_APACHE_DISTANT>/server-status?auto"
service: remote-apache
Intervalle de collecte
L’intervalle de collecte par défaut pour toutes les intégrations Datadog standard est de 15 secondes. Pour modifier l’intervalle de collecte, utilisez le paramètre min_collection_interval
. Pour en savoir plus, consultez la rubrique Modification de l’intervalle de collecte.
L’ajout de tags est essentiel pour être en mesure de filtrer et d’agréger les données envoyées à Datadog depuis plusieurs sources. Pour en savoir plus sur les tags, consultez la section Débuter avec les tags.
Si vous définissez des tags dans le fichier datadog.yaml
, ils sont appliqués aux données de toutes vos intégrations. Une fois votre tag défini dans datadog.yaml
, toutes les nouvelles intégrations en héritent.
Par exemple, il est conseillé d’utiliser service
pour la configuration de l’Agent lors de la surveillance de systèmes distincts et indépendants.
Pour mieux unifier votre environnement, il est également recommandé de configurer le tag env
dans l’Agent. Pour en savoir plus, consultez la section relative au tagging de service unifié.
Par défaut, les métriques transmises par les intégrations comprennent des tags découverts automatiquement dans l’environnement. Par exemple, les métriques transmises par un check Redis exécuté à l’intérieur d’un conteneur comprennent des tags associés au conteneur, tels que image_name
. Vous pouvez désactiver ce comportement en définissant le paramètre ignore_autodiscovery_tags
sur true
:
init_config:
ignore_autodiscovery_tags: true
# Insérer le reste de la configuration ici
Validation
Pour valider la configuration de votre Agent et de vos intégrations, lancez la sous-commande status
de l’Agent et cherchez votre nouvelle configuration dans la section Checks.
Installer plusieurs intégrations
L’installation de plusieurs intégrations revient nécessite d’ajouter les informations de configuration à un nouveau fichier conf.yaml
dans le dossier <INTEGRATIONS>.d
. Cherchez les paramètres obligatoires pour la nouvelle intégration dans le fichier conf.yaml.example
, ajoutez-les dans le nouveau fichier conf.yaml
, puis suivez les mêmes étapes pour valider votre configuration.
Intégrations détectées automatiquement
Si vous avez configuré la collecte de processus, Datadog détecte automatiquement les technologies qui s’exécutent sur vos hosts. Cette opération permet d’identifier les intégrations Datadog qui peuvent vous aider à surveiller ces technologies. Les intégrations détectées automatiquement s’affichent dans la recherche d’intégrations :
Chaque intégration possède l’un des trois statuts suivants :
- Detected : la technologie s’exécute sur un host, mais l’intégration n’a pas été installée ou configurée. Pour cette raison, seule une partie des métriques est recueillie. Configurez l’intégration pour en profiter pleinement. Pour obtenir la liste des hosts qui exécutent une technologie détectée automatiquement, ouvrez le carré de l’intégration, puis sélectionnez l’onglet Hosts.
- Installed : l’intégration est installée et configurée sur un host.
- Available : cette catégorie rassemble toutes les intégrations qui ne possèdent pas le statut Installed ni Detected.
Mesures de sécurité
Pour en savoir plus sur la manière dont Datadog traite vos données et sur d’autres aspects de la sécurité, consultez notre documentation dédiée.
Et ensuite ?
Maintenant que votre première intégration est configurée, explorez toutes les métriques envoyées par votre application à Datadog et utilisez ces métriques pour configurer des dashboards et des alertes afin de surveiller vos données.
Découvrez également les solutions Log Management, APM et surveillance Synthetic de Datadog.
Dépannage
Lorsque vous dépannez une intégration, il est nécessaire de commencer par vérifier la validité du YAML en utilisant un plug-in dans votre éditeur de code ou en faisant appel à l’un des nombreux outils en ligne dédiés. Ensuite, la procédure consiste à suivre toutes les étapes de la section Dépannage de l’Agent.
Si vos problèmes persistent, contactez l’assistance Datadog.
Termes clés
conf.yaml
- Le fichier
conf.yaml
doit être créé dans le dossier conf.d/<NOM_INTÉGRATION>.d
à la racine du répertoire de configuration de votre Agent. Utilisez ce fichier pour connecter des intégrations à votre système et pour configurer leurs paramètres. - Check custom
- Si vous utilisez un système privé que vous souhaitez surveiller, ou si vous voulez envoyer des métriques supplémentaires à partir d’une intégration, vous pouvez créer un check custom pour définir des métriques et les envoyer à Datadog. Toutefois, si vous cherchez à surveiller une application disponible librement, un service public ou un projet open source qui ne bénéficie d’aucune intégration, envisagez de créer une nouvelle intégration plutôt qu’un check custom.
datadog.yaml
- Il s’agit du fichier de configuration principal au sein duquel vous définissez la façon dont l’Agent dans son ensemble interagit avec ses propres intégrations et avec votre système. Utilisez ce fichier pour mettre à jour les clés d’API, les proxies, les tags de host et d’autres paramètres généraux.
- Événement
- Les événements sont des messages informatifs sur votre système. Ils sont transmis à l’Events Explorer pour vous permettre de créer des monitors en fonction de ces événements.
- Instance
- Chaque instance de ce que vous surveillez doit être définie et mappée dans le fichier
conf.yaml
. Par exemple, pour l’intégration http_check
, vous devez définir le nom associé à l’instance de l’endpoint HTTP dont vous surveillez l’uptime et le downtime. Vous pouvez surveiller plusieurs instances dans une même intégration en définissant toutes les instances dans le fichier conf.yaml
. <NOM_INTÉGRATION>.d
- Si votre configuration est complexe, vous pouvez la décomposer en plusieurs fichiers
YAML
, puis placer tous les fichiers dans le dossier <NOM_INTÉGRATION>.d
pour définir la configuration. L’Agent charge tous les fichiers YAML
valides dans le dossier <NOM_INTÉGRATION>.d
. - Logging
- Si le système que vous surveillez génère des logs, personnalisez les logs que vous envoyez à Datadog à l’aide de la solution Log Management.
metadata.csv
- Ce fichier énumère et stocke les métriques recueillies par chaque intégration.
- Métriques
- La liste des données recueillies à partir de votre système par chaque intégration. La liste des métriques de chaque intégration se trouve dans le fichier
metadata.csv
correspondant à cette intégration. Pour en savoir plus sur les métriques, consultez la page sur les métriques dédiée aux développeurs. Vous pouvez également configurer des métriques custom afin d’ajouter des métriques qui ne sont pas proposées par défaut avec l’intégration. - Paramètres
- Utilisez les paramètres dans le fichier
conf.yaml
pour contrôler les accès entre la source de données de votre intégration et l’Agent. Le fichier conf.yaml.example
de chaque intégration énumère l’ensemble des paramètres obligatoires et facultatifs. - Check de service
- Les checks de service sont un type de monitor utilisé pour surveiller le statut de disponibilité du service. Pour en savoir plus, consultez le guide sur les checks de service.
- Tags
- Les tags permettent de personnaliser les métriques pour les trier et les visualiser comme bon vous semble.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: