Pour l’installation et la configuration avec le site européen de Datadog, utilisez le paramètre SITE=. Consultez le tableau de variables de configuration ci-dessous.
Depuis la version 6.11.0 de l’Agent Windows, les composants de base ainsi que ceux de l’APM et du système de tracing s’exécutent sous le compte ddagentuser créé au moment de l’installation à la place du compte LOCAL_SYSTEM. Lorsqu’il est activé, le composant Live Process s’exécute sous le compte LOCAL_SYSTEM. En savoir plus sur l’utilisateur de l’Agent Windows Datadog.
Chaque élément de configuration est ajouté en tant que propriété dans la ligne de commande. Les options de configuration en ligne de commande suivantes sont disponibles à l’installation de l’Agent sur Windows :
Variable
Type
Description
APIKEY
Chaîne
Ajoute la clé d’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 hostname transmis par l’Agent à Datadog (remplace le hostname calculé lors de l’exécution).
LOGS_ENABLED
Chaîne
Active ("true") ou désactive ("false") la fonction de collecte de logs dans le fichier de configuration. Les logs sont désactivés par défaut.
APM_ENABLED
Chaîne
Active ("true") ou désactive ("false") l’Agent APM dans le fichier de configuration. L’APM est désactivé par défaut.
PROCESS_ENABLED
Chaîne
Active ("true") ou désactive ("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
Active ("true") ou désactive ("false") l’utilisation de FQDN pour le hostname de l’Agent. Cela revient à définir hostname_fqdn dans le fichier de configuration de l’Agent. L’utilisation de FQDN pour le hostname est désactivée par défaut. (v6.20.0+)
CMD_PORT
Nombre
Un numéro de port valide compris 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.
En cas d’utilisation d’un proxy, définit le mot de passe de votre proxy. Pour l’Agent de processus/conteneur, cette variable est requise pour la transmission d’un mot de passe d’authentification. Elle ne peut pas être renommée. En savoir plus sur l’utilisation d’un proxy avec l’Agent Datadog.
Remplace le mot de passe chiffré généré pour l’utilisateur ddagentuser lors de l’installation de l’Agent (version 6.11.0+). Doit être spécifié pour les installations sur les serveurs DNS. En savoir plus sur l’utilisateur de l’Agent Windows Datadog.
APPLICATIONDATADIRECTORY
Chemin
Remplace le répertoire à utiliser pour l’arborescence du fichier de configuration. Peut uniquement être spécifié à l’installation initiale, pas lors des mises à jour. Valeur par défaut : C:\ProgramData\Datadog. (version 6.11.0+)
PROJECTLOCATION
Chemin
Remplace le répertoire à utiliser pour l’arborescence du binaire. Peut uniquement être spécifié à l’installation initiale, pas lors des mises à jour. Valeur par défaut : %PROGRAMFILES%\Datadog\Datadog Agent. (v6.11.0+)
ADDLOCAL
Chaîne
Active le composant d’Agent supplémentaire. La valeur "MainApplication,NPM" entraîne l’installation du composant de pilote pour la solution Network Performance Monitoring.
EC2_USE_WINDOWS_PREFIX_DETECTION
Booléen
Utilise l’ID de l’instance EC2 pour les hosts Windows sur EC2 (v7.28.0+).
Remarque : si un fichier datadog.yaml valide est trouvé et qu’une clé d’API y est configurée, ce fichier est prioritaire sur toutes les options de ligne de commande spécifiées.
L’Agent 7 prend uniquement en charge Python 3. Avant d’effectuer une mise à niveau, vérifiez que vos checks custom sont compatibles avec Python 3. Consultez le guide Migration de checks custom vers Python 3 pour en savoir plus. Si vous n’utilisez pas de checks custom ou avez déjà vérifié leur compatibilité, effectuez la mise à niveau à l’aide des instructions prévues pour l’[interface graphique](?tab=Interface graphique) ou la [ligne de commande](?tab=Ligne de commande).
Si vous utilisez une version < 5.12.0 de l’Agent Datadog, procédez d’abord à la mise à niveau vers une version plus récente de l’Agent 5 (>= 5.12.0, mais < 6.0.0) à l’aide du fichier d’installation EXE, puis effectuez la mise à niveau vers une version >= 6 de l’Agent Datadog.
Le nom du fichier exécutable principal est agent.exe. Son emplacement varie en fonction de la version de l ‘Agent :
Versions de l’Agent <= 6.11 : "C:\Program Files\Datadog\Datadog Agent\embedded\agent.exe"
Versions de l’Agent >= 6.12 : "C:\Program Files\Datadog\Datadog Agent\bin\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 depuis une ligne de commande avec élévation des privilèges (exécutée en tant qu’administrateur) (Powershell ou Invite de commandes) à l’aide de la syntaxe <CHEMIN_VERS_AGENT.EXE> <COMMANDE>.
Vous trouverez ci-dessous la liste des options disponibles depuis la ligne de commande :
Commande
Description
check
Exécute le check spécifié.
diagnose
Exécute un diagnostic de connectivité sur votre système.
flare
Recueille et envoie un flare à Datadog.
help
Affiche des informations d’aide pour n’importe quelle commande.
hostname
Affiche le hostname utilisé par l’Agent.
import
Importe et convertit les fichiers de configuration des versions précédentes de l’Agent.
installservice
Installe l’Agent dans le gestionnaire de contrôle des services.
launch-gui
Démarre Datadog Agent Manager.
regimport
Importe les paramètres de registre dans datadog.yaml.
remove-service
Supprime l’Agent du gestionnaire de contrôle des services.
restart-service
Redémarre l’Agent dans le gestionnaire de contrôle des services.
run
Démarre l’Agent.
start
Démarre l’Agent. (Obsolète, mais accepté. Utilisez plutôt run.)
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.
Le fichier de configuration principal de l’Agent se situe à l’emplacement suivant :
C:\ProgramData\Datadog\datadog.yaml
Le fichier principal de l’Agent se situe à l’emplacement suivant :
C:\ProgramData\Datadog\datadog.conf
Les fichiers de configuration pour les intégrations se situent à l’emplacement suivant :
C:\ProgramData\Datadog\conf.d\ OU
C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\
Pour vous assurer que l’Agent est bien lancé, vérifiez si l’état du service DatadogAgent indique En cours d’exécution dans la liste des services Windows. Un processus appelé Datadog Metrics Agent (agent.exe) doit également être présent dans le gestionnaire des tâches.
Pour obtenir davantage d’informations sur l’état de l’agent, démarrez Datadog Agent Manager :
Dans la barre d’état système, faites un clic droit sur l’icône de l’Agent Datadog -> Configure, ou
Exécutez la commande launch-gui depuis une ligne de commande avec élévation des droits (exécutée en tant qu’administrateur) :
Ouvrez ensuite la page d’état en accédant à Status -> General.
Obtenez davantage d’informations sur les checks en cours d’exécution dans Status -> Collector et Checks -> Summary.
La commande status est disponible pour Powershell :
"%PROGRAMFILES%\Datadog\Datadog Agent\bin\agent.exe" status
Pour vous assurer que l’Agent est bien lancé, vérifiez si l’état du service indique En cours d’exécution dans la liste des services Windows. Un processus appelé ddagent.exe doit également être présent dans le gestionnaire des tâches.
Pour obtenir plus d’informations sur l’état de l’Agent pour les versions 5.2+, accédez à Datadog Agent Manager -> Settings -> Agent Status :
Pour connaître le statut des versions 3.9.1 à 5.1 de l’Agent, accédez à http://localhost:17125/status.
La sortie de la commande flare vous indique où l’archive flare compressée est enregistrée. Si l’envoi du fichier à Datadog échoue, vous pouvez le récupérer dans ce dossier et l’ajouter manuellement comme pièce jointe à un e-mail. Les fichiers flare sont généralement stockés aux emplacements suivants :
Pour les versions antérieures de l’Agent sous Windows, vous pouvez trouver l’emplacement de ce fichier en exécutant la commande suivante dans l’invite de commandes Python de l’Agent :
Étape 1 :
Version 5.12+ de l’Agent :
"%PROGRAMFILES%\Datadog\Datadog Agent\dist\shell.exe" since
Versions antérieures de l’Agent :
"%PROGRAMFILES%\Datadog\Datadog Agent\files\shell.exe"
Sur votre host cible, lancez Datadog Agent Manager et sélectionnez l’intégration « Windows Service » dans la liste. Un exemple prêt à l’emploi est inclus ; il repose toutefois sur DHCP.
Pour obtenir le nom du service, ouvrez services.msc et repérez 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 :
Lors de l’ajout de vos propres services, veillez à suivre précisément le format indiqué. En cas d’erreur de format, l’intégration ne fonctionnera pas. Remarque : les caractères spéciaux doivent être échappés dans le nom des services. Par exemple, pour indiquer le nom MSSQL$BILLING, utilisez MSSQL\$BILLING.
De plus, lorsque 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.
Datadog ne surveille pas les métriques des services : il vérifie uniquement leur disponibilité. Pour surveiller les métriques, utilisez l’intégration Processus ou WMI). Pour configurer un monitor, sélectionnez le type de monitor d’intégration puis recherchez Windows Service. Dans Integration Status -> Pick Monitor Scope, choisissez le service que vous souhaitez surveiller.
L’Agent Datadog recueille par défaut un grand nombre de métriques système. Les métriques système les plus souvent utilisées sont les métriques system.load.*. Toutefois, celles-ci sont réservées aux environnements Unix.
Bien que Windows ne propose pas de métriques system.load.*, une option équivalente est disponible par défaut : system.proc.queue.length. Cette métrique affiche le nombre de threads présents dans la file d’attente du processeur et en attente d’exécution.
