Linux

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.

Étapes d'installation in-app pour l'Agent Datadog sur un hôte Linux.

Configurer l’Agent

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 organisation
  • site : 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 journaux
  • conf.yaml.example : Un exemple illustrant les clés et les valeurs par défaut prises en charge

Commandes

DescriptionCommande
Démarrer l’Agent en tant que servicesudo systemctl start datadog-agent
Arrêter l’Agent fonctionnant en tant que servicesudo systemctl stop datadog-agent
Redémarrer l’Agent fonctionnant en tant que servicesudo systemctl restart datadog-agent
État du service Agentsudo systemctl status datadog-agent
Page d’état de l’Agent en cours d’exécutionsudo datadog-agent status
Envoyer un flaresudo datadog-agent flare
Afficher l’utilisation de la commandesudo datadog-agent --help
Exécuter un contrôlesudo -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