mirrored-prometheus-windows-exporter 镜像文档

镜像概述和主要用途

mirrored-prometheus-windows-exporter 是 Prometheus 官方 Windows Exporter 的镜像版本，专为在 Windows 环境中运行设计。其核心用途是收集 Windows 系统的硬件和操作系统指标（如 CPU、内存、磁盘、网络等），并通过 HTTP 接口暴露指标数据，供 Prometheus 监控系统抓取、存储和分析，实现对 Windows 环境的全面监控。

核心功能和特性

• 多维度指标收集：支持收集 CPU 使用率、内存占用、磁盘空间/IO、网络流量、进程状态、Windows 服务健康等多类系统指标；
• 灵活配置能力：可通过命令行参数或配置文件自定义指标收集范围，按需启用/禁用特定收集器；
• 轻量级运行：资源占用低，适合在各类 Windows 环境（物理机、虚拟机、容器）中部署；
• Prometheus 原生兼容：输出符合 Prometheus 指标格式的数据，无缝集成 Prometheus 监控生态；
• 版本化管理：提供不同标签版本，适配不同 Windows 系统版本及功能需求。

使用场景和适用范围

• Windows 服务器监控：适用于对 Windows Server 系列服务器（如 2016、2019、2022）的系统健康状态监控；
• 容器化 Windows 环境：在容器化部署的 Windows 应用集群中，标准化监控代理配置；
• 混合架构监控：在包含 Windows 和 Linux 的混合 IT 环境中，统一使用 Prometheus 生态进行跨平台监控；
• DevOps 流程集成：作为 CI/CD 管道的一部分，监控 Windows 构建/测试节点的资源使用情况。

详细使用方法和配置说明

基本部署（docker run）

在 Windows 容器环境中运行镜像，默认配置下暴露指标：

docker run -d -p 9182:9182 --name windows-exporter mirrored-prometheus-windows-exporter

参数说明：

• -p 9182:9182：将容器内默认监听端口（9182）映射到主机端口，供 Prometheus 抓取指标；
• --name windows-exporter：指定容器名称，便于管理。

自定义指标收集范围

通过命令行参数 --collectors.enabled 可指定启用的收集器，例如仅收集 CPU 和内存指标：

docker run -d -p 9182:9182 mirrored-prometheus-windows-exporter --collectors.enabled "cpu,memory"

常用收集器列表：

• cpu：CPU 使用率、核心数等指标
• memory：内存总量、可用内存、使用率等
• disk：磁盘分区、空间使用、IO 性能
• network：网络接口流量、连接数、吞吐量
• service：Windows 服务运行状态（如是否启动、启动类型）
• process：进程 ID、CPU/内存占用、启动时间

修改监听配置

通过环境变量或命令行参数修改监听地址和端口，例如修改端口为 9183：

docker run -d -p 9183:9183 -e LISTEN_ADDR=":9183" mirrored-prometheus-windows-exporter

常用配置参数：

• LISTEN_ADDR：监听地址和端口，默认 :9182
• METRICS_PATH：指标暴露路径，默认 /metrics（通过 --metrics.path 参数设置）

验证指标暴露

容器启动后，通过浏览器或 curl 访问 http://<主机IP>:9182/metrics，可查看暴露的指标数据，示例输出：

windows_cpu_time_total{cpu="0",mode="idle"} 12345.6
windows_memory_available_bytes 4294967296

Prometheus 抓取配置

在 Prometheus 配置文件（prometheus.yml）中添加如下 scrape_configs，配置指标抓取：

scrape_configs:
  - job_name: 'windows_nodes'
    static_configs:
      - targets: ['windows-server-ip:9182']  # 替换为实际运行 exporter 的主机IP和端口

注意事项

• 运行环境要求：需在启用 Windows 容器功能的主机上运行（通过 Enable-WindowsOptionalFeature -Online -FeatureName Containers 启用）；
• 权限配置：容器需以足够权限运行，以确保能访问 Windows 性能计数器等系统资源；
• 版本兼容性：选择与目标 Windows 系统版本匹配的镜像标签（如 v0.23.0），避免兼容性问题。