Cette page décrit les fonctionnalités de base de l’Agent Datadog pour Windows. Si vous n’avez pas encore installé l’Agent, consultez les instructions d’installation ci-dessous ou suivez les instructions dans l’application.
Installer avec l’interface graphique de l’Agent Manager
L'emplacement d'installation par défaut pour l'Agent est %ProgramFiles%\Datadog\Datadog Agent. Si vous choisissez d'utiliser un emplacement d'installation personnalisé, assurez-vous de spécifier un sous-répertoire Datadog pour les fichiers Datadog.
Exécutez le programme d’installation en ouvrant datadog-agent-7-latest.amd64.msi. Lorsque vous y êtes invité, entrez vos identifiants d’administrateur.
Suivez les instructions, acceptez le contrat de licence et entrez votre clé API Datadog.
Une fois l’installation terminée, vous avez la possibilité de lancer Datadog Agent Manager.
Options de configuration à l’installation
Chacune des options de configuration suivantes peut être ajoutée en tant que propriété dans la ligne de commande lors de l’installation de l’Agent sur Windows. Pour des options de configuration supplémentaires de l’Agent, voir plus d’options de configuration de l’Agent.
Variable
Type
Description
APIKEY
Chaîne
Ajoute la clé API Datadog au fichier de configuration.
SITE
Chaîne
Définit le site d’admission Datadog, par exemple : SITE=datadoghq.com
TAGS
Chaîne
Liste de tags séparés par des virgules à attribuer dans le fichier de configuration. Exemple : TAGS="key_1:val_1,key_2:val_2"
HOSTNAME
Chaîne
Configure le nom d’hôte rapporté par l’Agent à Datadog (remplace tout nom d’hôte calculé à l’exécution).
Remplace le mot de passe cryptographiquement sécurisé généré pour le ddagentuser utilisateur lors de l’installation de l’Agent (v6.11.0+). Doit être fourni pour les installations sur des serveurs de domaine. En savoir plus sur l’Agent Windows Datadog.
APPLICATIONDATADIRECTORY
Chemin
Remplace le répertoire à utiliser pour l’arborescence du fichier de configuration. Ne peut être fourni que lors de l’installation initiale ; non valide pour les mises à niveau. Par défaut : C:\ProgramData\Datadog. (v6.11.0+)
PROJECTLOCATION
Chemin
Remplace le répertoire à utiliser pour l’arborescence du fichier binaire. Ne peut être fourni que lors de l’installation initiale ; non valide pour les mises à niveau. Par défaut : %ProgramFiles%\Datadog\Datadog Agent. (v6.11.0+)
Si vous choisissez de remplacer le répertoire par défaut, assurez-vous de spécifier un Datadog sous-répertoire pour les fichiers Datadog.
Notes
L’/qn option exécute une installation silencieuse. Pour voir les invites de l’interface graphique, retirez-le.
Certaines versions de l’Agent peuvent provoquer un redémarrage forcé. Pour éviter cela, ajoutez le paramètre : REBOOT=ReallySuppress.
Certains composants de l’Agent nécessitent un pilote de noyau pour collecter des données. Pour savoir si un pilote de noyau est requis pour votre composant, consultez sa page de documentation ou recherchez kernel driver dans les fichiers de configuration de l’Agent associés.
Si un datadog.yaml valide est trouvé, ce fichier prend le pas sur toutes les options de ligne de commande spécifiées.
Autres options de configuration de l’Agent
Chacune des options de configuration suivantes peut être ajoutée en tant que propriété dans la ligne de commande lors de l’installation de l’Agent sur Windows.
Note : Si un datadog.yaml valide est trouvé, ce fichier prend le pas sur toutes les options de ligne de commande spécifiées.
Variable
Type
Description
LOGS_ENABLED
Chaîne
Activez ("true") ou désactivez ("false") la fonctionnalité de collecte de journaux dans le fichier de configuration. Les journaux sont désactivés par défaut.
APM_ENABLED
Chaîne
Activez ("true") ou désactivez ("false") l’Agent APM dans le fichier de configuration. L’APM est activé par défaut.
PROCESS_ENABLED
Chaîne
Activez ("true") ou désactivez ("false") l’Agent de Processus dans le fichier de configuration. L’Agent de Processus est désactivé par défaut.
HOSTNAME_FQDN_ENABLED
Chaîne
Activez ("true") ou désactivez ("false") l’utilisation de FQDN pour le nom d’hôte de l’Agent. Cela équivaut à définir hostname_fqdn dans le fichier de configuration de l’Agent. L’utilisation de FQDN pour le nom d’hôte est désactivée par défaut. (v6.20.0+)
CMD_PORT
Nombre
Un numéro de port valide entre 0 et 65534. L’Agent Datadog expose une API de commande sur le port 5001. Si ce port est déjà utilisé par un autre programme, la valeur par défaut peut être remplacée ici.
(Si vous utilisez un proxy) définit votre mot de passe proxy. Pour l’Agent de processus/conteneur, cette variable est requise pour passer un mot de passe d’authentification et ne peut pas être renommée. En savoir plus sur l’utilisation d’un proxy avec l’Agent Datadog.
EC2_USE_WINDOWS_PREFIX_DETECTION
Booléen
Utilisez l’identifiant d’instance EC2 pour les hôtes Windows sur EC2. (v7.28.0+)
Fichiers journaux d’installation
Définissez l’option /log <FILENAME> msiexec pour configurer un fichier journal d’installation. Si cette option n’est pas définie, msiexec écrit le journal par défaut dans %TEMP%\MSI*.LOG.
Configuration
Le fichier de configuration principal de l’Agent est situé à
C:\ProgramData\Datadog\datadog.yaml. Ce fichier est utilisé pour les paramètres globaux tels que la clé API, le site Datadog sélectionné, les paramètres du proxy, les balises d’hôte et le niveau de journalisation.
Il y a aussi un fichier datadog.yaml.example dans le même répertoire, qui est une référence entièrement commentée avec toutes les options de configuration disponibles, utile pour référence et pour copier des paramètres spécifiques.
Les fichiers de configuration pour les intégrations se trouvent dans :
C:\ProgramData\Datadog\conf.d\ Il peut également y avoir un emplacement alternatif hérité : C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\.
Chaque intégration a un sous-répertoire <INTEGRATION>.d\ qui contient :
conf.yaml : Les paramètres actifs pour l’intégration
conf.yaml.example : Un fichier d’exemple montrant quelles clés de configuration sont prises en charge
Lors de la modification des configurations, assurez-vous de redémarrer l’Agent pour garantir que les modifications prennent effet.
L’exécution de l’Agent est contrôlée par le gestionnaire de contrôle des services Windows.
Le nom de l’exécutable principal est agent.exe.
L’interface de configuration est une application basée sur un navigateur (pour Windows 64 bits uniquement).
Les commandes peuvent être exécutées à partir de la ligne de commande élevée (exécuter en tant qu’administrateur) en utilisant la syntaxe <PATH_TO_AGENT.EXE> <COMMAND>.
Vous trouverez ci-dessous la liste des options disponibles depuis l’interface de ligne de commande :
Commande
Description
check
Exécute la vérification spécifiée.
diagnose
Exécute un diagnostic de connectivité sur votre système.
flare
Collecte un flare et l’envoie à Datadog.
help
Obtient de l’aide sur n’importe quelle commande.
hostname
Affiche le nom d’hôte utilisé par l’Agent.
import
Importe et convertit les fichiers de configuration des versions précédentes de l’Agent.
launch-gui
Démarre le gestionnaire d’Agent Datadog.
restart-service
Redémarre l’Agent dans le gestionnaire de contrôle des services.
run
Démarre l’Agent.
start
Démarre l’Agent. (En cours de dépréciation, mais accepté. Utilisez run comme alternative.)
start-service
Démarre l’Agent dans le gestionnaire de contrôle des services.
status
Affiche le statut actuel.
stopservice
Arrête l’Agent dans le gestionnaire de contrôle des services.
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" launch-gui
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" flare
Désinstaller l’Agent
Il existe deux méthodes différentes pour désinstaller l’Agent sur Windows. Les deux méthodes suppriment l’Agent, mais ne suppriment pas le dossier de configuration C:\ProgramData\Datadog sur l’hôte.
Ajouter ou supprimer des programmes
Appuyez sur CTRL et Esc ou utilisez la touche Windows pour exécuter la recherche Windows.
Recherchez add et cliquez sur Ajouter ou supprimer des programmes.
Recherchez Datadog Agent et cliquez sur Désinstaller.
PowerShell
Remarque : Activez WinRM pour utiliser les commandes ci-dessous.
Utilisez la commande PowerShell suivante pour désinstaller l’Agent sans redémarrage :
Pour vérifier que l’Agent fonctionne, vérifiez si le service DatadogAgent dans le panneau des Services est répertorié comme Démarré. Un processus appelé Agent de métriques Datadog (agent.exe) devrait également exister dans le Gestionnaire des tâches.
Pour obtenir davantage d’informations sur l’état de l’agent, démarrez Datadog Agent Manager :
Cliquez avec le bouton droit sur l’icône de la barre d’état système de l’Agent Datadog -> Configurer, ou
Exécutez launch-gui la commande depuis une invite de commande élevée (exécuter en tant qu’Admin)
PowerShell : & "<PATH_TO_AGENT.EXE>" launch-gui
cmd : "<PATH_TO_AGENT.EXE>" launch-gui
Ensuite, ouvrez la page d’état en allant à État -> Général.
Obtenez plus d’informations sur l’exécution des vérifications dans Statut -> Collecteur et Vérifications -> Résumé.
La commande status est disponible pour PowerShell :
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
Emplacement des journaux
Les journaux de l’Agent se trouvent dans C:\ProgramData\Datadog\logs\agent.log.
Remarque : ProgramData est un dossier caché.
Cas d’utilisation
Surveillance d’un service Windows
Sur votre hôte cible, lancez le Gestionnaire d’Agent Datadog et sélectionnez l’intégration “Service Windows” dans la liste. Il existe un exemple prêt à l’emploi ; cependant, cet exemple utilise DHCP.
Pour obtenir le nom du service, ouvrez services.msc et localisez votre service cible. En utilisant DHCP comme cible, vous pouvez voir le nom du service en haut de la fenêtre des propriétés du service :
Lorsque vous ajoutez vos propres services, assurez-vous de suivre le format exactement comme indiqué. Si le format n’est pas correct, l’intégration échoue. Remarque : Les caractères spéciaux dans un nom de service doivent être échappés. Par exemple, le nom MSSQL$BILLING peut être ajouté avec MSSQL\$BILLING.
De plus, chaque fois que vous modifiez une intégration, le service Datadog doit être redémarré. Vous pouvez le faire depuis services.msc ou depuis la barre latérale de l’interface utilisateur.
Pour les Services, Datadog ne suit pas les métriques—seulement leur disponibilité. (Pour les métriques, utilisez l’intégration Processus ou WMI). Pour configurer un Moniteur, sélectionnez le type de moniteur d’intégration puis recherchez Service Windows. Depuis Statut d’intégration -> Choisir la portée de surveillance, choisissez le service que vous souhaitez surveiller.
Surveiller la charge système sous Windows
L’Agent Datadog collecte par défaut un grand nombre de métriques système. Les métriques système les plus couramment utilisées sont system.load.* mais ces métriques sont spécifiques à Unix.
Bien que Windows n’offre pas les system.load.* métriques, une option équivalente disponible par défaut est system.proc.queue.length. Cette métrique montre le nombre de threads observés comme retardés dans la file d’attente prête du processeur qui attendent d’être exécutés.
