Ce guide décrit comment utiliser les intégrations Datadog. 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 :
check pour définir les métriques à recueillir.Vous pouvez aussi créer un check custom pour définir et envoyer des métriques à Datadog depuis un système interne unique.
Le paquet 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 et nécessitent de télécharger le kit de développement logiciel pour être utilisées. Pour en savoir plus sur l’installation ou la gestion de ces intégrations, consultez le guide de gestion des intégrations.
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.
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 :
conf.yaml.example (dans le dossier <NOM_INTÉGRATION>.d correspondant) en conf.yaml.Remarque : tous les fichiers de configuration respectent le format décrit dans la documentation des paramètres.
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 créer plusieurs instances dans un même check d’Agent et surveiller deux services Apache, créez une nouvelle instance avec un - dans la section instances :
init_config:
instances:
- apache_stats_url: "http://localhost/server-status?auto"
service: local-apache
- apache_status_url: "http://<ENDPOINT_APACHE_DISTANT>/server-status?auto"
service: remote-apache
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 documentation dédiée aux développeurs.
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, nous vous recommandons également de configurer le tag env dans l’Agent. Pour en savoir plus sur le tagging de service unifié, consultez la section dédiée.
Pour valider la configuration de votre Agent et de vos intégrations, lancez la sous-commande status de l’Agent et cherchez une nouvelle configuration dans la section Checks.
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.
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 deux types de statuts suivants :
Les hosts qui exécutent l’intégration, mais sur lesquels l’intégration n’est pas activée, se trouvent dans l’onglet Hosts du carré de l’intégration.
Pour en savoir plus sur la manière dont Datadog traite vos données et sur d’autres questions de sécurité, consultez notre documentation dédiée.
Maintenant que vos premières intégrations sont configurées, vous pouvez commencer à explorer toutes les métriques envoyées par votre application à Datadog et à utiliser ces métriques pour configurer des dashboards et des alertes afin de surveiller vos données.
Découvrez également nos solutions Log Management, APM et Synthetic Monitoring.
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 les problèmes persistent, contactez notre formidable équipe d’assistance.
| Terme | Description |
|---|---|
| conf.yaml | Le fichier conf.yaml doit être créé dans le dossier conf.d/<NOM_INTÉGRATION> à 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 souhaitez étendre la liste des métriques déjà envoyées par une intégration, vous pouvez créer un check custom pour définir des métriques et les envoyer à Datadog. Toutefois, si vous souhaitez surveiller une application disponible librement, un service public ou un projet open source qui ne bénéficie d’aucune intégration dédiée, nous vous conseillons de créer une nouvelle intégration plutôt qu’un check custom. |
| datadog.yaml | Il s’agit du fichier de configuration principal où vous définissez comment 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 proxys, 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 recueillis dans le flux d’événements pour vous permettre de créer des monitors en fonction de ces derniers. |
| 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 la 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 répertoire <NOM_INTÉGRATION>.d. |
| journalisation | Si le système que vous surveillez génère des logs, vous pouvez personnaliser les logs que vous envoyez à Datadog et utiliser notre solution Log Management pour les gérer et les analyser. |
| 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. |
| tagging | Les tags permettent de personnaliser les métriques pour les trier et les visualiser comme bon vous semble. |
Documentation, liens et articles supplémentaires utiles:
