windows_exporter : installer le MSI avec des collecteurs activés et vérifier /metrics sous Windows

Objectif

Installer windows_exporter sur un hôte Windows Server avec un ensemble de collecteurs défini, vérifier qu'il s'exécute comme service et que les métriques sont accessibles, en n'utilisant qu'un appel non interactif de l'installeur.

Prérequis

Une session PowerShell avec droits d'administrateur ; le paquet .msi téléchargé depuis les releases du projet ; un port cible non utilisé (par défaut 9182).

Étapes

1. Installer avec des collecteurs explicites et une exception de pare-feu, en un seul appel msiexec non interactif. Sous PowerShell, le jeton d'arrêt de l'analyse --% doit précéder les propriétés de l'installeur : msiexec /i windows_exporter-<version>-amd64.msi --% ENABLED_COLLECTORS=cpu,memory,logical_disk,net,os,service,physical_disk,system ADDLOCAL=FirewallException /qn. Le README indique que ENABLED_COLLECTORS équivaut à l'option --collectors.enabled, et que ADDLOCAL=FirewallException ajoute pendant l'installation une règle correspondante au pare-feu Windows ; /qn est l'option standard du mode silencieux de MSI pour les installations sans surveillance.
2. Pour limiter les adresses autorisées à joindre l'exporter via cette règle de pare-feu, ajouter REMOTE_ADDR=<prometheus-ip> au même appel ; le README décrit cette propriété comme la liste d'adresses autorisées, séparées par des virgules, pour l'exception de pare-feu.
3. Pour modifier le port d'écoute par défaut 9182, ajouter LISTEN_PORT=<port>. Le README documente l'option sous-jacente --web.listen-address (par défaut :9182) ainsi que --telemetry.path (par défaut /metrics) si l'on a besoin d'un chemin de métriques différent.
4. L'installeur configure windows_exporter comme service Windows. PowerShell n'attend pas la fin de msiexec (le rediriger vers Out-Null ou utiliser Start-Process -Wait dans un script) ; vérifier ensuite que le service fonctionne : Get-Service windows_exporter | Select-Object Status,StartType.
5. Vérifier les métriques en local : Invoke-WebRequest http://localhost:9182/metrics -UseBasicParsing | Select-Object -ExpandProperty Content | Select-String "^windows_cpu".
6. Pour modifier ensuite l'ensemble des collecteurs, tenir compte de la règle du README : les propriétés de l'installeur l'emportent toujours sur le fichier de configuration YAML installé à côté de l'exécutable (et les options de ligne de commande sur les valeurs de configuration). Après une installation avec ENABLED_COLLECTORS, modifier collectors.enabled dans le fichier YAML n'a donc aucun effet. Il faut soit réinstaller avec une nouvelle valeur de ENABLED_COLLECTORS, soit installer sans ces propriétés et gérer les collecteurs dans le fichier de configuration, puis exécuter Restart-Service windows_exporter.

Résultat attendu

Get-Service windows_exporter indique Running ; le point de terminaison /metrics renvoie du texte au format Prometheus incluant les métriques de chaque collecteur nommé dans ENABLED_COLLECTORS ; le pare-feu Windows affiche la règle d'exception si ADDLOCAL=FirewallException a été utilisé.

Limites et base de vérification

Basé sur le README de prometheus-community/windows_exporter, qui documente les propriétés de l'installeur MSI et les options de ligne de commande utilisées ci-dessus. Pour annuler, désinstaller via « Applications et fonctionnalités » ("Apps & Features") ou msiexec /x avec le même produit, ce qui supprime aussi l'exception de pare-feu créée par l'installeur. Si REMOTE_ADDR n'est pas défini, l'exception de pare-feu autorise toute adresse distante ; il faut le définir explicitement sur un hôte accessible depuis l'extérieur du réseau de supervision.