Aperçu
L’Agent Datadog est un logiciel qui s’exécute sur vos hôtes. Il collecte des événements et des métriques des hôtes et les envoie à Datadog, où vous pouvez analyser vos données de surveillance et de performance. L’Agent Datadog est open source et son code source est disponible sur GitHub à DataDog/datadog-agent.
Pour commencer à utiliser l'Agent, sélectionnez votre plateforme.
Datadog recommande de mettre à jour l'Agent Datadog à chaque version mineure et de correctif, ou, au minimum, mensuellement.
La mise à niveau vers une version majeure de l'Agent Datadog et le maintien à jour est le seul moyen pris en charge pour obtenir les dernières fonctionnalités et corrections de l'Agent.
Il est recommandé d'installer complètement l'Agent. Cependant, un package DogStatsD autonome est disponible pour Amazon Linux, CentOS, Debian, Fedora, Red Hat, SUSE et Ubuntu. Ce package est utilisé dans des environnements conteneurisés où DogStatsD fonctionne comme un sidecar ou dans des environnements exécutant un serveur DogStatsD sans la fonctionnalité complète de l'Agent.
Gestion de l’Agent
Gestion de l’Agent avec l’Automatisation de Flotte (recommandé)
Automatisation de Flotte est le flux de travail principal dans l’application pour installer, mettre à niveau, configurer et dépanner l’Agent Datadog à grande échelle.
- View configuration & history : Voir chaque Agent dans votre flotte, sa version, les produits activés, les fichiers de configuration et les modifications historiques depuis une seule page.
- Mettre à niveau les Agents obsolètes : Déclenchez des mises à niveau à distance pour vos Agents afin de maintenir votre flotte à jour en quelques clics.
- Envoyer un signal de détresse pour obtenir de l’aide : Depuis l’onglet Support d’un hôte, générez un signal et attachez-le à un cas de support existant ou nouveau sans avoir à utiliser la ligne de commande.
- Auditer l’utilisation de la clé API : Identifiez quels Agents utilisent une clé API spécifique et faites tourner les clés en toute sécurité.
Interface graphique du gestionnaire d’Agents Datadog
L'interface graphique de l'Agent n'est pas prise en charge sur les plateformes Windows 32 bits.
L’interface graphique Datadog Agent Manager vous permet d’accomplir ce qui suit :
- Voir les informations de statut pour votre Agent
- Voir tous les contrôles en cours d’exécution
- Voir le journal de l’Agent
- Modifier le fichier de configuration de l’Agent (
datadog.yaml) - Ajouter ou modifier les contrôles de l’Agent
- Envoyer des flares
L’interface graphique du gestionnaire d’Agents Datadog est activée par défaut sur Windows et macOS, et fonctionne sur le port 5002. Utilisez la commande datadog-agent launch-gui pour ouvrir l’interface graphique dans votre navigateur web par défaut.
Vous pouvez changer le port par défaut de l’interface graphique dans votre fichier de configuration datadog.yaml. Pour désactiver l’interface graphique, définissez la valeur du port à -1. Sur Linux, l’interface graphique est désactivée par défaut.
Prérequis de l’interface graphique :
- Les cookies doivent être activés dans votre navigateur. L’interface graphique génère et enregistre un jeton dans votre navigateur, qui est utilisé pour authentifier toutes les communications avec le serveur de l’interface graphique.
- Pour démarrer l’interface graphique, l’utilisateur doit avoir les autorisations requises. Si vous pouvez ouvrir
datadog.yaml, vous pouvez utiliser l’interface graphique. - Pour des raisons de sécurité, l’interface graphique ne peut être accédée que depuis l’interface réseau locale (
localhost/127.0.0.1), vous devez donc être sur l’hôte où l’Agent est en cours d’exécution. Vous ne pouvez pas exécuter l’Agent sur une machine virtuelle ou un conteneur et y accéder depuis la machine hôte.
Interface de ligne de commande
À partir de l’Agent 6 et des versions ultérieures, l’interface de ligne de commande de l’Agent est basée sur des sous-commandes. Pour une liste complète des sous-commandes de l’Agent, voir Commandes de l’Agent.
Aller plus loin avec l’Agent Datadog
Mettre à jour l’Agent
Pour mettre à jour manuellement les composants principaux de l’Agent Datadog depuis et vers une version mineure sur un host donné, exécutez la commande d’installation correspondant à votre plateforme.
Remarque : Si vous souhaitez mettre à jour manuellement une intégration spécifique de l’Agent, consultez le guide de gestion des intégrations.
Fichiers de configuration
Consultez la documentation relative aux fichiers de configuration de l’Agent.
Site Datadog
Modifiez le fichier de configuration principal de l’Agent, datadog.yaml, pour définir le site paramètre (par défaut datadoghq.com).
Remarque : Consultez la documentation de démarrage avec les sites Datadog pour plus de détails sur le site paramètre.
Emplacement des journaux
Consultez la section Fichiers de log de l’Agent.
Surcharge de l’Agent
Un exemple de la consommation de ressources de l’Agent Datadog est ci-dessous. Des tests ont été effectués sur une instance de machine Amazon EC2 c5.xlarge (4 VCPU/ 8 Go de RAM) et des performances comparables ont été observées pour les instances basées sur ARM64 avec des ressources similaires. La version vanilla datadog-agent fonctionnait avec un contrôle de processus pour surveiller l’Agent lui-même. Activer plus d’intégrations peut augmenter la consommation de ressources de l’Agent.
Activer les vérifications JMX oblige l’Agent à utiliser plus de mémoire en fonction du nombre de beans exposés par les JVM surveillées. Activer les Agents de trace et de processus augmente également la consommation de ressources.
- Version de l’agent Test : 7.34.0
- CPU : ~ 0,08 % du CPU utilisé en moyenne
- Mémoire : ~ 130 Mo de RAM utilisée (mémoire RSS)
- Bande passante réseau : ~ 140 B/s ▼ | 800 B/s ▲
- Disque :
- Linux 830 Mo à 880 Mo selon la distribution
- Windows : 870 Mo
Collecte de journaux :
Les résultats ci-dessous sont obtenus à partir d’une collecte de 110 Ko de journaux par seconde d’un fichier avec le transmetteur HTTP activé. Cela montre l’évolution de l’utilisation des ressources pour les différents niveaux de compression disponibles.
- Version de l’agent Test : 6.15.0
- CPU : ~ 1,5 % du CPU utilisé en moyenne
- Mémoire : ~ 95 Mo de RAM utilisée.
- Bande passante réseau : ~ 14 Ko/s ▲
- Version de l’agent Test : 6.15.0
- CPU : ~ 1 % du CPU utilisé en moyenne
- Mémoire : ~ 95 Mo de RAM utilisée.
- Bande passante réseau : ~ 20 Ko/s ▲
- Version de l’agent Test : 6.15.0
- CPU : ~ 0,7 % du CPU utilisé en moyenne
- Mémoire : ~ 90 Mo de RAM utilisée (mémoire RSS)
- Bande passante réseau : ~ 200 Ko/s ▲
Ressources supplémentaires
Cette section comprend les thèmes suivants :
Lectures complémentaires
Documentation, liens et articles supplémentaires utiles: