服务器部署Prometheus windows_exporter后如何接入Prometheus并验证Windows指标
Prometheus 不会自动发现 Windows 主机上的指标。首次接入时,需要在目标 Windows 服务器安装并启动 windows_exporter,让它通过 HTTP 暴露指标;再在 Prometheus 配置中添加该服务器的抓取目标,最后分别检查 exporter 接口和 Prometheus 查询结果。

以下步骤适用于一台 Windows 服务器接入一套已运行的 Prometheus。示例使用默认监听端口 9182 和 Prometheus 常见端口 9090;执行前请确认 Prometheus 服务端能够访问 Windows 服务器的 9182/TCP。默认指标接口不应直接暴露到公网,建议限制为 Prometheus 服务端或受控监控网段访问。
A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,覆盖常规建站、业务后台、数据库、接口服务与多任务运行场景。不同地区配备多样化的CPU、内存、SSD或NVMe存储及网络线路,可为部署Windows服务器、接入Prometheus并持续采集主机运行指标提供稳定的硬件与网络基础。
准备条件
开始前确认以下事项:
- Windows 服务器可登录,并有管理员权限。
- 已有运行中的 Prometheus,能够修改其
prometheus.yml并重载或重启服务。 - 已确认 Windows 服务器的内网 IP 或 DNS 名称,例如
10.0.10.25。 - 已确认 Prometheus 服务端的源 IP,例如
10.0.1.10,以便按需限制入站访问。 - Windows 服务器和 Prometheus 服务端之间的网络路由、防火墙策略允许访问
9182/TCP。 - 已从可信发布渠道取得与 Windows 系统架构相符的
windows_exporterMSI 安装包。
部署前建议复制一份 Prometheus 配置文件作为备份。以下示例以 C:\Prometheus\prometheus.yml 为路径;如果实际安装目录不同,请替换为真实路径。
Copy-Item C:\Prometheus\prometheus.yml C:\Prometheus\prometheus.yml.bak
可用 Get-AuthenticodeSignature 检查 MSI 的签名状态。具体发布包的签名者和安装选项可能随版本变化;若签名状态异常或发布来源无法确认,不要继续安装。
Get-AuthenticodeSignature C:\Install\windows_exporter.msi
安装并验证 windows_exporter
1. 安装 exporter
使用管理员权限打开 PowerShell,将路径替换为实际 MSI 文件位置:
Start-Process msiexec.exe -ArgumentList '/i "C:\Install\windows_exporter.msi" /passive' -Wait -Verb RunAs
/passive 会显示安装进度但不要求交互操作。也可以双击 MSI 按向导完成安装。首次部署可先使用安装包的默认配置,不必额外启用非必需的采集器。
安装完成后检查 Windows 服务:
Get-Service windows_exporter
如果服务已安装并运行,应看到类似结果:
Status Name DisplayName
------ ---- -----------
Running windows_exporter windows_exporter
若服务状态是 Stopped,可尝试启动:
Start-Service windows_exporter
Get-Service windows_exporter
如果提示找不到服务,先在“设置 → 应用”或“控制面板 → 程序和功能”中确认安装是否完成,再检查安装包及安装日志。不要在未确认安装状态时反复运行安装命令。
2. 在 Windows 本机检查指标接口
在 Windows 服务器本机请求默认端点:
(Invoke-WebRequest -Uri http://localhost:9182/metrics -UseBasicParsing).StatusCode
正常情况下返回 HTTP 状态码:
200
再查看部分指标文本:
(Invoke-WebRequest -Uri http://localhost:9182/metrics -UseBasicParsing).Content -split "`n" |
Select-Object -First 20
输出应包含以 # HELP、# TYPE 开头的说明行和指标样本。具体指标名称会受 exporter 版本及启用的采集器影响;看到有效的 Prometheus 文本格式,且请求返回 200,表示本机接口基本可用。
也可以使用系统自带的 curl.exe:
curl.exe -i http://localhost:9182/metrics
如果本机请求失败,先检查服务是否运行、安装时是否更改了监听端口,以及端口是否被其他程序占用。此时还没有必要先修改 Prometheus 配置。
配置 Prometheus 抓取 Windows 指标
1. 增加抓取任务
在 Prometheus 服务端编辑 prometheus.yml,在现有的 scrape_configs 列表中增加一个任务。以下配置假设 Windows 主机地址为 10.0.10.25,exporter 监听 9182:
scrape_configs:
- job_name: "windows"
static_configs:
- targets: ["10.0.10.25:9182"]
如果配置文件中已经有 scrape_configs,只需将 job_name: "windows" 这一项作为新的列表成员加入,不要再创建第二个顶层 scrape_configs。如果 Windows 主机有可解析的内网 DNS 名称,也可以将 IP 替换为该名称,例如 win-app-01.internal:9182。
Prometheus 默认抓取间隔通常足以用于首次连通性验证。只有在现有配置明确要求单独设定频率时,才为该任务增加 scrape_interval;例如设置为 15s:
scrape_configs:
- job_name: "windows"
scrape_interval: 15s
static_configs:
- targets: ["10.0.10.25:9182"]
2. 检查配置并使其生效
如 Prometheus 安装目录包含 promtool,先运行配置检查。路径以实际安装位置为准:
C:\Prometheus\promtool.exe check config C:\Prometheus\prometheus.yml
配置正确时会看到类似提示:
SUCCESS: C:\Prometheus\prometheus.yml is valid prometheus config file syntax
如果检查失败,按提示修复缩进、冒号、引号或列表层级。YAML 对缩进敏感,不能用 Tab 代替空格;修复后再次执行检查。
配置检查通过后,让 Prometheus 重新读取配置。具体方式取决于 Prometheus 的启动方式:
- 如果由 Windows 服务管理器或其他服务管理工具运行,使用该工具重启对应的 Prometheus 服务。
- 如果在前台运行,按实际的进程管理方式重启 Prometheus。
- 如果部署时已明确启用 Prometheus 的配置热加载机制,也可以使用该机制重新加载配置。
不要假设所有 Prometheus 实例都支持相同的热加载方式。重启或重载后,检查服务进程仍在运行,并打开 Prometheus Web 页面,通常为 http://<Prometheus服务端地址>:9090。
3. 验证目标是否可达
在 Prometheus Web 页面打开 Status → Targets,找到 job="windows" 的目标。正常时状态为 UP,页面会显示最近一次抓取时间及抓取地址。
也可以在 Prometheus 查询页面输入:
up{job="windows"}
成功时应得到一个值为 1 的时间序列。如果得到 0,表示目标已被 Prometheus 纳入抓取,但最近一次抓取失败;如果没有结果,优先确认配置是否已加载、job_name 是否拼写一致,以及目标是否出现在 Targets 页面。
检查 Windows 指标是否进入 Prometheus
up 为 1 只能说明 Prometheus 成功抓取了目标,不能单独证明每个 Windows 采集器都已提供数据。接下来可在查询页面检查常见指标。不同版本及采集器配置下,具体指标名可能不同;可先在查询框输入 windows_,查看自动补全结果。
以下是常见的查询示例:
windows_cpu_time_total
windows_memory_available_bytes
windows_logical_disk_free_bytes
如果指标存在,Prometheus 会返回对应时间序列及标签。需要观察 CPU 变化时,可查询一段时间内的速率;这里的计算是 Prometheus 对计数器增量的估算,不代表单次即时采样:
rate(windows_cpu_time_total[5m])
也可以在 Prometheus 的 Graph 页面选择时间范围,观察指标是否持续出现。刚添加目标后,等待至少一个抓取周期再判断;若抓取间隔为 15s,通常等待几十秒后再刷新查询更容易确认数据。
常见异常处理
本机无法访问 localhost:9182/metrics
先检查服务状态:
Get-Service windows_exporter
- 服务不存在:确认 MSI 是否安装成功、系统架构是否匹配,以及安装时是否出现错误。
- 服务停止:检查 Windows 事件日志或安装日志中的启动错误,再尝试启动服务。
- 服务运行但接口连接失败:核对监听端口和监听地址。若安装时自定义过参数,应以实际配置为准,不能只按默认端口判断。
- 请求返回非
200或内容不是指标文本:检查端点路径是否为/metrics,以及是否有其他程序占用了预期端口。
可查看端口占用情况:
Get-NetTCPConnection -LocalPort 9182 -State Listen -ErrorAction SilentlyContinue
如果没有监听记录,说明当前没有进程在该端口监听;如果存在记录,可结合安装参数和服务状态确认监听进程。不要直接结束未知进程。
Windows 本机正常,但 Prometheus 抓取失败
按从网络到配置的顺序检查:
- 目标地址和端口:确认 Prometheus 配置中的地址是 Windows 主机可从 Prometheus 服务端访问的地址,而不是
localhost。 - Windows 防火墙:若目标端口未放行,Prometheus 服务端无法连接。先核对现有防火墙策略,再按最小范围添加允许规则。
- 网络路径:检查路由、安全组或上游防火墙是否允许 Prometheus 服务端访问 Windows 主机的
9182/TCP。 - Prometheus 状态:查看 Targets 页的错误信息。连接超时通常指向网络丢包或策略阻断;连接被拒绝通常表示目标端口没有服务监听或监听地址不匹配;名称解析失败则需检查 DNS。
- 配置是否生效:确认
promtool check config通过,且 Prometheus 已重载或重启。
如确需创建 Windows 入站规则,建议仅允许 Prometheus 服务端 IP 访问,并使用明确的规则名称。以下命令会修改防火墙配置;执行前确认适用的网络配置文件和源 IP。示例假设 Prometheus 地址为 10.0.1.10:
New-NetFirewallRule `
-DisplayName "Allow windows_exporter from Prometheus" `
-Direction Inbound `
-Action Allow `
-Protocol TCP `
-LocalPort 9182 `
-RemoteAddress 10.0.1.10 `
-Profile Domain,Private
规则添加后,从 Prometheus 服务端重新检查 Targets。若要回滚这条规则,可按名称删除;此操作只删除该规则,不会卸载 exporter:
Remove-NetFirewallRule -DisplayName "Allow windows_exporter from Prometheus"
不要为了排错直接开放所有来源,也不要在未确认网络配置文件的情况下启用面向所有网络的规则。
up 为 1,但查询不到预期指标
这通常说明连接已建立,但所查指标名称在当前采集配置或版本中不存在,或对应采集器未启用。先在 /metrics 内容中搜索 windows_,确认实际暴露的名称;再根据安装包支持的配置方式检查采集器设置。不要因为一个指标缺失就判定整个 exporter 不可用。
验收与回滚
验收检查项
首次部署完成后,逐项确认:
windows_exporter服务已安装,状态为Running。- Windows 本机访问
http://localhost:9182/metrics返回200,且响应包含 Prometheus 格式的指标文本。 - Prometheus 配置检查通过,Windows 抓取任务已加载。
- Prometheus Status → Targets 中对应目标为
UP。 up{job="windows"}返回1,且至少能查询到当前配置实际提供的 Windows 指标。- 入站规则如有新增,来源范围仅覆盖需要访问的 Prometheus 服务端或受控网段。
回滚检查项
若需撤销本次接入,先从 Prometheus 配置中移除新增的 windows 抓取任务,再运行 promtool check config。确认检查通过后,按实际运行方式重载或重启 Prometheus。若创建过专用防火墙规则,按规则名称删除。
如果还要卸载 exporter,可通过 Windows“设置 → 应用”或“控制面板 → 程序和功能”卸载 windows_exporter,随后检查服务是否已移除。卸载前确认没有其他 Prometheus 任务仍在抓取该主机;不要通过手动删除程序目录或服务注册表项代替卸载。回滚完成后,再确认 Prometheus 配置有效、相关目标不再出现在 Targets 页面,且无本次新增的防火墙规则残留。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8549.html



