windows_exporter

适用于Windows机器的Prometheus导出器。

收集器

过滤启用的收集器

默认情况下，windows_exporter 将公开所有启用收集器的指标。这是收集指标的推荐方式，以避免在比较不同系列的指标时出现错误。

对于高级用途，可以向 windows_exporter 传递一个可选的收集器列表来过滤指标。collect[] 参数可以多次使用。在 Prometheus 配置中，您可以在 抓取配置 下使用此语法。

  params:
    collect[]:
      - foo
      - bar

这对于让不同的 Prometheus 服务器从节点收集特定指标很有用。

标志

windows_exporter 接受用于配置某些行为的标志。下面列出了配置导出器全局行为的标志，而特定于收集器的标志则在上面相应的收集器文档中有所说明。

安装

可以从 releases 页面 下载最新版本。

每个版本都提供一个 .msi 安装程序。安装程序将把 windows_exporter 设置为 Windows 服务，并在 Windows 防火墙中创建一个例外。

如果安装程序在没有任何参数的情况下运行，导出器将使用默认设置运行，包括启用的收集器、端口等。以下参数可用：

参数通过 msiexec 发送给安装程序。示例调用：

msiexec /i <path-to-msi-file> ENABLED_COLLECTORS=os,iis LISTEN_PORT=5000

带有自定义查询的服务收集器示例。

msiexec /i <path-to-msi-file> ENABLED_COLLECTORS=os,service --% EXTRA_FLAGS="--collector.service.services-where ""Name LIKE 'sql%'"""

在一些较旧的 Windows 版本上，您可能需要用双引号将参数值括起来，以使安装命令正确解析：

msiexec /i C:\Users\Administrator\Downloads\windows_exporter.msi ENABLED_COLLECTORS="ad,iis,logon,memory,process,tcp,textfile,thermalzone" TEXTFILE_DIRS="C:\custom_metrics\"

要安装导出器并创建防火墙例外，请使用以下命令：

msiexec /i <path-to-msi-file> ADD_FIREWALL_EXCEPTION=yes

要修复安装，例如强制重新创建 Windows 服务：

msiexec /fa <path-to-msi-file>

Powershell 7.3 及以上版本在使用 --% EXTRA_FLAGS 时需要将 PSNativeCommandArgumentPassing 设置为 Legacy：

$PSNativeCommandArgumentPassing = 'Legacy'
msiexec /i <path-to-msi-file> ENABLED_COLLECTORS=os,service --% EXTRA_FLAGS="--collector.service.services-where ""Name LIKE 'sql%'"""

Docker 实现

windows_exporter 可以作为 Docker 容器运行。Docker 镜像可在以下位置获取：

• Docker Hub：docker.io/prometheuscommunity/windows-exporter
• GitHub Container Registry：ghcr.io/prometheus-community/windows-exporter

标签

Docker 镜像使用导出器的版本进行标记。latest 标签也可用，指向最新版本。

此外，带有 -hostprocess 后缀的 hostprocess 风格基于 https://github.com/microsoft/windows-host-process-containers-base-image， 设计用于作为 Windows 主机进程容器运行。该镜像的大小比默认镜像小。

Kubernetes 实现

有关在 Windows Kubernetes 上安装的详细步骤，请参见此处。

支持的版本

windows_exporter 支持 Windows Server 2016 及更高版本，以及桌面版 Windows 10 和 11（21H2 或更高版本）。

Windows Server 2012 和 2012R2 仅作为尽力而为的支持，不保证可以工作。

使用方法

go get -u github.com/prometheus/promu
go get -u github.com/prometheus-community/windows_exporter
cd $env:GOPATH/src/github.com/prometheus-community/windows_exporter
promu build -v
.\windows_exporter.exe

Prometheus指标将在localhost:9182上公开

示例

仅启用服务收集器并指定自定义查询

.\windows_exporter.exe --collectors.enabled "service" --collector.service.services-where "Name='windows_exporter'"

仅启用进程收集器并指定自定义查询

.\windows_exporter.exe --collectors.enabled "process" --collector.process.include="firefox.+"

当有多个同名进程时，WMI会将第一个实例之后的进程表示为process-name#index。因此，要获取所有进程而不仅仅是第一个，正则表达式必须使用.+。更多信息请参阅process。

将[defaults]与--collectors.enabled参数一起使用

将[defaults]与--collectors.enabled参数一起使用，该参数会扩展为所有默认收集器。

.\windows_exporter.exe --collectors.enabled "[defaults],process,container"

这会在默认收集器之上额外启用进程和容器收集器。

使用配置文件

可以使用--config.file标志指定YAML配置文件。例如：.\windows_exporter.exe --config.file=config.yml。如果使用绝对路径，请确保用引号括起路径，例如：.\windows_exporter.exe --config.file="C:\Program Files\windows_exporter\config.yml"

也可以从URL加载配置。例如：.\windows_exporter.exe --config.file="https://example.com/config.yml"

如果需要跳过TLS验证，可以使用--config.file.insecure-skip-verify标志。例如：.\windows_exporter.exe --config.file="https://example.com/config.yml" --config.file.insecure-skip-verify

collectors:
  enabled: cpu,cs,net,service
collector:
  service:
    services-where: "Name='windows_exporter'"
log:
  level: warn

一个示例配置文件可以在这里找到。

配置文件注意事项

配置文件值可以与CLI标志混合使用。例如：

.\windows_exporter.exe --collectors.enabled=cpu,logon

log:
  level: debug

CLI标志的优先级高于配置文件中指定的值。

许可证

基于MIT