L’Agent est un logiciel léger installé sur vos hosts. Il transmet les métriques et les événements à partir de votre host à Datadog via les intégrations, DogStatsD ou l’API. Avec une configuration supplémentaire, l’Agent peut transmettre des live processes, logs et traces.
Si vous ne l’avez pas encore fait, créez un compte Datadog.
L’Agent peut être installé sur de nombreuses plateformes différentes, directement sur le host ou en tant que version conteneurisée. La plupart des systèmes possèdent une options d’installation en ligne.
Choisissez votre plateforme pour voir les instructions d'installation :
Le fichier de configuration principal de l’Agent est datadog.yaml. L’unique paramètre requis est votre clé d’API Datadog qui est utilisé pour associer les données de votre Agent à votre organisation. Consultez le fichier d’exemple config_template.yaml pour découvrir toutes les options de configuration disponibles.
Pour l’Agent conteneur, les options de configuration de datadog.yaml sont transmises avec les variables d’environnement. Par exemple, la variable d’environnement de la clé d’API Datadog est DD_API_KEY.
Le fichier de configuration principal de l’Agent est datadog.yaml. Vous devez indiquer votre clé d’API Datadog, qui est utilisée pour associer les données de votre Agent à votre organisation et au site Datadog (datadoghq.eu). Consultez le fichier d’exemple config_template.yaml pour découvrir toutes les options de configuration disponibles.
Pour l’Agent de conteneur, les options de configuration de datadog.yaml sont transmises à l’aide de variables d’environnement, par exemple :
DD_API_KEY pour la clé d’API DatadogDD_SITE pour le site DatadogLancez la commande status de l’Agent pour vérifier que l’installation s’est bien déroulée.
Consultez la page relative aux commandes de l’Agent pour démarrer, arrêter ou redémarrer votre Agent.
Les métriques ci-dessous sont disponibles pour la version 6 de l’Agent. Si vous disposez de la version 5, consultez l’intégration Métriques de l’Agent.
| Métrique | Description |
|---|---|
| datadog.agent.python.version | Affiche une valeur de 1 si l’Agent transmet actuellement des données à Datadog. Le tag python_version est ajouté à la métrique. |
| datadog.agent.running | Affiche une valeur de 1 si l’Agent transmet actuellement des données à Datadog. |
| datadog.agent.started | Un nombre d’une valeur de 1 envoyé lorsque l’Agent se lance (disponible pour les versions 6.12 et ultérieures). |
En fonction de votre plateforme, l’Agent présente plusieurs checks de base activés par défaut qui recueillent des métriques.
| Check | Métriques | Plateformes |
|---|---|---|
| CPU | Système | Toutes |
| Disk | Disque | Toutes |
| Docker | Docker | Docker |
| File Handle | Système | Toutes sauf Mac |
| IO | Système | Toutes |
| Load | Système | Toutes sauf Windows |
| Memory | Système | Toutes |
| Network | Réseau | Toutes |
| NTP | NTP | Toutes |
| Uptime | Système | Toutes |
| Winproc | Système | Windows |
Pour recueillir des métriques provenant d’autres technologies, consultez la page relative aux intégrations.
L’Agent envoie des événements à Datadog lorsqu’un Agent est démarré ou redémarré.
datadog.agent.up :
Renvoie CRITICAL si l’Agent ne parvient pas à se connecter à Datadog. Si ce n’est pas le cas, renvoie OK.
datadog.agent.check_status :
Renvoie CRITICAL si un check de l’Agent ne parvient pas à envoyer des métriques à Datadog. Si ce n’est pas le cas, renvoie OK.
Pour dépanner plus facilement l’Agent :
Documentation, liens et articles supplémentaires utiles:
Une fois que l'Agent est installé :
Sur cette page
