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 du Gestionnaire d’Agent
L'emplacement d'installation par défaut de l'Agent est %ProgramFiles%\Datadog\Datadog AgentSi vous choisissez d'utiliser un emplacement d'installation personnalisé, assurez-vous de spécifier un Datadog sous-répertoire pour les fichiers Datadog.
Exécutez le programme d’installation en ouvrant datadog-agent-7-latest.amd64.msi. Lorsque vous y êtes invité, saisissez vos identifiants d’administrateur.
Suivez les instructions, acceptez le contrat de licence et saisissez votre clé API Datadog.
Une fois l’installation terminée, vous avez la possibilité de lancer Datadog Agent Manager.
Options de configuration d’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, consultez 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’entrée 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’utilisateur de l’Agent Datadog pour Windows.
APPLICATIONDATADIRECTORY
Chemin
Remplacer le répertoire à utiliser pour l’arborescence du répertoire 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
Remplacer le répertoire à utiliser pour l’arborescence du répertoire 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’option /qn 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 prévaut sur toutes les options de ligne de commande spécifiées.
Plus d’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.
Remarque : Si un datadog.yaml valide est trouvé, ce fichier prévaut 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. 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. Il est équivalent à 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
Numéro
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 de l’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 se trouve à
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 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 graphique de configuration est une application de configuration basée sur un navigateur (pour Windows 64 bits uniquement).
Les commandes peuvent être exécutées depuis la ligne de commande élevée (exécuter en tant qu’Admin) en utilisant la syntaxe <PATH_TO_AGENT.EXE> <COMMAND>.
Les options de ligne de commande sont ci-dessous :
Commande
Description
check
Exécute la vérification spécifiée.
diagnostiquer
Exécute un diagnostic de connectivité sur votre système.
flare
Collecte un flare et l’envoie à Datadog.
aide
Obtient de l’aide sur n’importe quelle commande.
nom d’hôte
Affiche le nom d’hôte utilisé par l’Agent.
importer
Importe et convertit les fichiers de configuration des versions précédentes de l’Agent.
lancer-gui
Démarre le Datadog Agent Manager.
redémarrer-service
Redémarre l’Agent dans le gestionnaire de contrôle des services.
exécuter
Démarre l’Agent.
démarrer
Démarre l’Agent. (En cours de dépréciation, mais accepté. Utilisez run comme alternative.)
démarrer-service
Démarre l’Agent dans le gestionnaire de contrôle des services.
statut
Affiche le statut actuel.
arrêter-service
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 Add or remove programs.
Recherchez Datadog Agent et cliquez sur Uninstall.
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 listé comme Démarré. Un processus appelé Datadog Metrics Agent (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 du Datadog Agent > Configure, 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 de statut en allant à Status > General.
Obtenez plus d’informations sur l’exécution des vérifications dans Status > Collector et Checks > Summary.
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 de l’Agent Datadog et sélectionnez l’intégration Windows Service 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 Process ou WMI). Pour configurer un Moniteur, sélectionnez le type de moniteur d’intégration puis recherchez Windows Service. Depuis Integration Status > Pick Monitor Scope, choisissez le service que vous souhaitez surveiller.
Surveillance de la charge système pour Windows
Le Datadog Agent 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 Unix spécifiques.
Bien que Windows n’offre pas les métriques system.load.*, 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.
