windows_exporter: instalar el MSI con recolectores habilitados y verificar /metrics en Windows

Objetivo

Instalar windows_exporter en un host con Windows Server con un conjunto conocido de recolectores (collectors) habilitados, comprobar que se ejecuta como servicio y verificar que las métricas son accesibles, todo ello mediante una invocación no interactiva del instalador.

Requisitos previos

Una sesión de PowerShell con permisos de administrador; el paquete .msi descargado de las releases del proyecto; un puerto de destino que no esté en uso (por defecto, 9182).

Pasos

1. Instala con recolectores explícitos y una excepción de firewall en una sola llamada no interactiva a msiexec. En PowerShell, el token de detención del análisis --% debe preceder a las propiedades del instalador: msiexec /i windows_exporter-<version>-amd64.msi --% ENABLED_COLLECTORS=cpu,memory,logical_disk,net,os,service,physical_disk,system ADDLOCAL=FirewallException /qn. El README documenta ENABLED_COLLECTORS como equivalente al flag --collectors.enabled, y ADDLOCAL=FirewallException como la opción que añade durante la instalación una regla correspondiente en el Firewall de Windows; /qn es el parámetro estándar de MSI para el modo silencioso en instalaciones desatendidas.
2. Para restringir qué direcciones pueden acceder al exporter a través de esa regla de firewall, añade REMOTE_ADDR=<prometheus-ip> a la misma invocación; el README documenta esta propiedad como la lista de direcciones permitidas, separadas por comas, para la excepción de firewall.
3. Para cambiar el puerto de escucha por defecto 9182, añade LISTEN_PORT=<port>. El README documenta el flag subyacente --web.listen-address (por defecto :9182) y --telemetry.path (por defecto /metrics), por si necesitas una ruta de métricas distinta de la predeterminada.
4. El instalador configura windows_exporter como servicio de Windows. PowerShell no espera a que msiexec termine (si lo usas en un script, canalízalo a Out-Null o usa Start-Process -Wait); después, confirma que el servicio está en ejecución: Get-Service windows_exporter | Select-Object Status,StartType.
5. Verifica las métricas en local: Invoke-WebRequest http://localhost:9182/metrics -UseBasicParsing | Select-Object -ExpandProperty Content | Select-String "^windows_cpu".
6. Si más adelante quieres cambiar el conjunto de recolectores, ten presente la regla del README: las propiedades del instalador siempre tienen prioridad sobre el archivo de configuración YAML que se instala junto al ejecutable (y los flags de línea de comandos sobre los valores de la configuración). Por tanto, si instalaste con ENABLED_COLLECTORS, editar collectors.enabled en el archivo YAML no tiene ningún efecto. Puedes reinstalar con un nuevo valor de ENABLED_COLLECTORS, o bien instalar sin esas propiedades y gestionar los recolectores en el archivo de configuración, y después ejecutar Restart-Service windows_exporter.

Resultado esperado

Get-Service windows_exporter indica Running; el endpoint /metrics devuelve texto en formato Prometheus que incluye métricas de cada recolector indicado en ENABLED_COLLECTORS; y el Firewall de Windows muestra la regla de excepción si se usó ADDLOCAL=FirewallException.

Límites y base de verificación

Se basa en el README de prometheus-community/windows_exporter, que documenta las propiedades del instalador MSI y los flags de línea de comandos usados arriba. Para revertir la instalación, desinstala desde "Apps & Features" (Aplicaciones y características) o con msiexec /x sobre el mismo producto, lo que también elimina la excepción de firewall creada por el instalador. Si REMOTE_ADDR no se define, la excepción de firewall permite cualquier dirección remota; defínelo de forma explícita en un host accesible desde fuera de la red de monitorización.