Débuter avec l'Agent
Présentation
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 à l’aide d’intégrations, de DogStatsD ou de l’API. L’Agent peut également être configuré pour transmettre des live processes, des logs et des traces.
Implémentation
Si vous ne l’avez pas encore fait, créez un compte Datadog.
Installation
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 :
Configuration
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 Datadog
Validation
Lancez la commande status de l’Agent pour vérifier que l’installation s’est bien déroulée.
Commandes
Consultez les commandes de l’Agent pour démarrer, arrêter ou redémarrer votre Agent.
Données collectées
Métriques
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 la valeur 1 si l’Agent transmet des données à Datadog. Le tag python_version est ajouté à la métrique. |
datadog.agent.running | Affiche la valeur 1 si l’Agent transmet 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). |
Checks
En fonction de votre plateforme, l’Agent présente plusieurs checks de base activés par défaut qui recueillent des métriques.
Pour recueillir des métriques provenant d’autres technologies, consultez la page relative aux intégrations.
Événements
L’Agent envoie des événements à Datadog lorsqu’un Agent est démarré ou redémarré.
Checks de service
datadog.agent.up:
Renvoie OK
si l’Agent parvient à se connecter à Datadog.
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
.
Dépannage
Pour dépanner plus facilement l’Agent :
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
Étapes suivantes
Une fois que l'Agent est installé :