L’Agent est un logiciel léger installé sur vos hosts. Il transmet les métriques et les événements issus de votre host à Datadog via les intégrations, DogStatsD ou l'API. L’Agent peut également être configuré pour transmettre des live processes, des logs et des 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. Vous devez indiquer votre clé d’API Datadog, qui est utilisée pour associer les données de votre Agent à votre organisation, ainsi que le site Datadog (). 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 Agent Metrics.
| 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 | Nombre ayant pour valeur 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 | System | 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é :
