Aperçu
Cette page décrit les fonctionnalités de base de l’Agent Datadog pour les environnements Linux. Consultez la documentation Plateformes prises en charge pour la liste complète des distributions et versions Linux prises en charge.
Installer l’Agent
Pour installer l’Agent sur Linux, suivez les instructions in-app dans Fleet Automation 6 et exécutez le script généré sur vos hôtes.
Le fichier de configuration de l’Agent Datadog se trouve dans /etc/datadog-agent/datadog.yaml. Ce fichier YAML contient les détails de connexion à l’échelle de l’hôte utilisés pour envoyer des données à Datadog, y compris :
api_key : La clé API Datadog de votre organisationsite : Région cible de Datadog (par exemple datadoghq.com, datadoghq.eu, ddog-gov.com, us2.ddog-gov.com)proxy : Points de terminaison de proxy HTTP/HTTPS pour le trafic sortant (voir Configuration du proxy de l’Agent Datadog)- Tags par défaut, niveau de journalisation et configurations Datadog
Un fichier de référence entièrement commenté, situé dans /etc/datadog-agent/datadog.yaml.example, répertorie chaque option disponible pour comparaison ou pour copier et coller. Alternativement, consultez le fichier d’exemple config_template.yaml pour toutes les options de configuration disponibles.
Fichiers d’intégration
Les fichiers de configuration pour les intégrations se trouvent dans /etc/datadog-agent/conf.d/. Chaque intégration a son propre sous-répertoire, <INTEGRATION>.d/, qui contient :
conf.yaml : La configuration active contrôlant la manière dont l’intégration collecte les métriques et les journauxconf.yaml.example : Un exemple illustrant les clés et les valeurs par défaut prises en charge
Commandes
| Description | Commande |
|---|
| Démarrer l’Agent en tant que service | sudo systemctl start datadog-agent |
| Arrêter l’Agent fonctionnant en tant que service | sudo systemctl stop datadog-agent |
| Redémarrer l’Agent fonctionnant en tant que service | sudo systemctl restart datadog-agent |
| État du service Agent | sudo systemctl status datadog-agent |
| Page d’état de l’Agent en cours d’exécution | sudo datadog-agent status |
| Envoyer un flare | sudo datadog-agent flare |
| Afficher l’utilisation de la commande | sudo datadog-agent --help |
| Exécuter un contrôle | sudo -u dd-agent -- datadog-agent check <CHECK_NAME> |
Remarque : Pour les systèmes basés sur upstart, tels que CentOS/RHEL 6 ou SUSE 11, remplacez systemctl <action> par <action>. Par exemple, lors du démarrage d’un Agent en tant que service sur un système SUSE 11, utilisez sudo start datadog-agent.
Désinstaller l’Agent
Pour désinstaller l’Agent, exécutez la commande pour l’environnement Linux approprié :
Pour CentOS, Rocky, AlmaLinux, Amazon Linux, Oracle Linux et Red Hat
sudo yum remove datadog-agent
Pour Debian, Ubuntu
sudo apt-get remove datadog-agent -y
Pour SUSE
sudo zypper remove datadog-agent
Les commandes ci-dessus suppriment l’Agent, mais ne suppriment pas :
- Le fichier de configuration
datadog.yaml - Fichiers créés par l’utilisateur dans le dossier de configuration
/etc/datadog-agent - Fichiers créés par l’utilisateur dans le dossier
/opt/datadog-agent - L’utilisateur
dd-agent - Fichiers journaux Datadog
Pour supprimer ces éléments, exécutez cette commande après avoir supprimé l’Agent :
sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/datadog-agent/ \
&& sudo rm -rf /var/log/datadog/
Pour désinstaller les artefacts restants de l’Agent pour Debian et Ubuntu, exécutez :
sudo apt-get remove --purge datadog-agent -y
Désinstaller Single Step APM Instrumentation
Si vous avez installé l’Agent avec Single Step APM Instrumentation et souhaitez le désinstaller, vous devez exécuter des commandes supplémentaires pour supprimer APM Instrumentation. Suivez les étapes pour votre environnement spécifique.
Dépannage
Pour des étapes détaillées, voir Dépannage de l’Agent.
Travailler avec l’Agent intégré
L’Agent contient un environnement Python intégré à /opt/datadog-agent/embedded/. Des binaires courants tels que python et pip sont contenus dans /opt/datadog-agent/embedded/bin/.
Pour en savoir plus, consultez les instructions relatives à l’ajout de paquets à l’Agent intégré.
Lectures complémentaires
Documentation, liens et articles supplémentaires utiles: