Nouvelles annonces sur les technologies sans serveur et réseau ainsi que sur le RUM (Real-User Monitoring) dévoilées à la conférence Dash ! Nouvelles annonces dévoilées à la conférence Dash !

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

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. 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. Les paramètres requis sont votre clé d’API Datadog qui est utilisé pour associer les données de votre Agent à votre organisation et le site de Datadog (datadoghq.eu). 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 :

  • DD_API_KEY pour la clé d’API Datadog
  • DD_SITE pour le site de Datadog

Validation

Exécutez la commande status de l’Agent pour vérifier l’installation.

Commandes

Consultez la page relative aux 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 Métriques de l’Agent.

MétriqueDescription
datadog.agent.python.versionAffiche une valeur de 1 si l’Agent transmet actuellement des données à Datadog. Le tag python_version est ajouté à la métrique.
datadog.agent.runningAffiche une valeur de 1 si l’Agent transmet actuellement des données à Datadog.
datadog.agent.startedUn nombre d’une valeur de 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.

CheckMétriquesPlateformes
CPUSystèmeToutes
DiskDisqueToutes
DockerDockerDocker
File HandleSystèmeToutes sauf Mac
IOSystèmeToutes
LoadSystèmeToutes sauf Windows
MemorySystèmeToutes
NetworkRéseauToutes
NTPNTPToutes
UptimeSystèmeToutes
WinprocSystèmeWindows

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 CRITICAL si l’Agent n’est pas capable de se connecter à Datadog. Si ce n’est pas le cas, renvoie OK.

datadog.agent.check_status : Renvoie CRITICAL si un check de l’Agent n’est pas capable d’envoyer des métriques à Datadog. Si ce n’est pas le cas, renvoie OK.

Dépannage

Pour obtenir de l’aide pour le dépannage de l’Agent :

Pour aller plus loin

Étapes suivantes