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 Datadog
DD_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.

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.

É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.