windows_exporter: MSI mit aktivierten Collectors installieren und /metrics unter Windows prüfen

Ziel

windows_exporter auf einem Windows-Server-Host mit einem definierten Satz aktivierter Collectors installieren, den Betrieb als Dienst bestätigen und die Erreichbarkeit der Metriken prüfen, und zwar vollständig über einen nicht interaktiven Installeraufruf.

Voraussetzungen

Eine PowerShell-Sitzung mit Administratorrechten; das .msi-Paket aus den Releases des Projekts; ein Ziel-Port, der noch nicht belegt ist (Standard: 9182).

Schritte

1. Installation mit expliziten Collectors und Firewall-Ausnahme in einem einzigen nicht interaktiven msiexec-Aufruf. In PowerShell muss das Stop-Parsing-Token --% vor den Installer-Properties stehen: msiexec /i windows_exporter-<version>-amd64.msi --% ENABLED_COLLECTORS=cpu,memory,logical_disk,net,os,service,physical_disk,system ADDLOCAL=FirewallException /qn. Laut README entspricht ENABLED_COLLECTORS dem Flag --collectors.enabled, und ADDLOCAL=FirewallException legt während der Installation eine passende Windows-Firewall-Regel an; /qn ist der übliche MSI-Schalter für den Quiet-Modus bei unbeaufsichtigten Installationen.
2. Um einzuschränken, welche Adressen den Exporter über diese Firewall-Regel erreichen dürfen, REMOTE_ADDR=<prometheus-ip> zum selben Aufruf hinzufügen; das README beschreibt diese Property als kommagetrennte Allowlist für die Firewall-Ausnahme.
3. Um den Listen-Port vom Standard 9182 zu ändern, LISTEN_PORT=<port> hinzufügen. Das README dokumentiert als zugrunde liegende Flags --web.listen-address (Standard :9182) und --telemetry.path (Standard /metrics), falls stattdessen ein abweichender Metrikpfad nötig ist.
4. Der Installer richtet windows_exporter als Windows-Dienst ein. PowerShell wartet nicht auf das Ende von msiexec (in Skripten die Ausgabe an Out-Null weiterleiten oder Start-Process -Wait verwenden); anschliessend prüfen, ob der Dienst läuft: Get-Service windows_exporter | Select-Object Status,StartType.
5. Metriken lokal prüfen: Invoke-WebRequest http://localhost:9182/metrics -UseBasicParsing | Select-Object -ExpandProperty Content | Select-String "^windows_cpu".
6. Soll der Collector-Satz später geändert werden, ist die Regel aus dem README zu beachten: Installer-Properties haben immer Vorrang vor der YAML-Konfigurationsdatei, die neben der ausführbaren Datei installiert wird (und CLI-Flags vor Konfigurationswerten). Wurde mit ENABLED_COLLECTORS installiert, bleibt eine Änderung von collectors.enabled in der YAML-Datei wirkungslos. Entweder mit neuem ENABLED_COLLECTORS-Wert neu installieren, oder ohne diese Properties installieren und die Collectors in der Konfigurationsdatei verwalten und danach Restart-Service windows_exporter ausführen.

Erwartetes Ergebnis

Get-Service windows_exporter meldet Running; der Endpunkt /metrics liefert Text im Prometheus-Format, der Metriken jedes in ENABLED_COLLECTORS genannten Collectors enthält; die Windows-Firewall zeigt die Ausnahmeregel, sofern ADDLOCAL=FirewallException verwendet wurde.

Grenzen und Prüfbasis

Basiert auf dem README von prometheus-community/windows_exporter, das die oben verwendeten MSI-Installer-Properties und Kommandozeilen-Flags dokumentiert. Zum Rückgängigmachen über «Apps & Features» deinstallieren oder msiexec /x mit demselben Produkt verwenden; dabei wird auch die vom Installer angelegte Firewall-Ausnahme entfernt. Bleibt REMOTE_ADDR ungesetzt, erlaubt die Firewall-Ausnahme jede Remote-Adresse; auf einem Host, der von ausserhalb des Monitoring-Netzes erreichbar ist, sollte die Property deshalb explizit gesetzt werden.