Présentation

Cette page présente les fonctionnalités de base de l’Agent Datadog pour macOS. Consultez la documentation sur les plateformes prises en charge pour voir la liste complète des distributions et versions de macOS prises en charge.

Installer l’Agent 

Pour installer l’Agent sur macOS, suivez les instructions intégrées dans Fleet Automation, puis exécutez le script généré sur vos hosts.

Commandes

Le gestionnaire de services launchctl contrôle le cycle de vie de l’Agent. Vous pouvez aussi exécuter certaines commandes via le binaire de l’Agent, l’application dans la barre de menus ou l’interface web.

Configuration

Le fichier de configuration de l’Agent Datadog, situé dans /etc/datadog-agent/datadog.yaml, contient les paramètres de connexion généraux utilisés pour transmettre les données à Datadog, notamment :

• api_key : la clé API Datadog de votre organisation
• site : région Datadog ciblée (par exemple datadoghq.com, datadoghq.eu, ddog-gov.com)
• proxy : endpoints proxy HTTP/HTTPS pour le trafic sortant (consultez la section Configuration du proxy pour l’Agent Datadog)
• Tags par défaut, niveaux de journalisation et configurations propres à Datadog.

Un fichier de référence entièrement commenté, disponible à l’emplacement /etc/datadog-agent/datadog.yaml.example, présente l’ensemble des options configurables pour consultation ou copie. Vous pouvez également consulter le fichier config_template.yaml d’exemple pour retrouver toutes les options de configuration disponibles.

Fichiers d’intégration

Les fichiers de configuration des intégrations se trouvent dans /etc/datadog-agent/conf.d/. Chaque intégration possède son propre sous-répertoire, <INTEGRATION>.d/, qui contient :

• conf.yaml : configuration active définissant comment l’intégration collecte les métriques et les logs 
• conf.yaml.example : un exemple illustrant les clés prises en charge et les valeurs par défaut

Désinstaller l’Agent

Pour désinstaller l’Agent, exécutez la commande suivante :

Installation pour un seul utilisateur

Pour supprimer l’Agent et tous ses fichiers de configuration :

1. Arrêtez et fermez l’Agent Datadog en cliquant sur l’icône en forme d’os dans la barre des menus.
2. Faites glisser l’application Datadog depuis le dossier Applications vers la corbeille.
3. Exécutez les commandes suivantes :

   sudo rm -rf /opt/datadog-agent
   sudo rm -rf /usr/local/bin/datadog-agent
   sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
   launchctl remove com.datadoghq.agent
   sudo rm -rf /var/log/datadog
   

4. Redémarrez votre machine pour que les modifications soient appliquées.

Désinstaller l’Agent

Pour supprimer l’Agent et tous ses fichiers de configuration :

1. Faites glisser l’application Datadog depuis le dossier Applications vers la corbeille.
2. Pour supprimer les fichiers restants, exécutez les commandes suivantes :

   sudo rm -rf /opt/datadog-agent
   sudo rm -rf /usr/local/bin/datadog-agent
   sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
   sudo launchctl disable system/com.datadoghq.agent && sudo launchctl bootout system/com.datadoghq.agent
   sudo launchctl unload /Library/LaunchDaemons/com.datadoghq.agent.plist
   sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist
   sudo rm -rf /var/log/datadog
   

3. Redémarrez votre machine pour que les modifications soient appliquées.

Dépannage

Consultez la documentation relative au dépannage de l’Agent pour accéder aux instructions de dépannage.

Utilisation de l’Agent intégré

L’Agent intègre un environnement Python dans /opt/datadog-agent/embedded/. Les binaires courants comme python et pip se trouvent dans /opt/datadog-agent/embedded/bin/.

Pour en savoir plus, consultez les instructions relatives à l’ajout de paquets à l’Agent intégré.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Recueillir vos logsDOCUMENTATION Recueillir vos processusDOCUMENTATION Recueillir vos tracesDOCUMENTATION En savoir plus sur l'architecture de l'AgentDOCUMENTATION Configurer les ports entrantsDOCUMENTATION