文档 Grafana Alloy 参考 组件 prometheus prometheus.exporter.windows

prometheus.exporter.windows

prometheus.exporter.windows 组件内嵌了 windows_exporter，用于暴露 Windows 系统上的各种硬件和操作系统指标。

windows_exporter 本身包含各种收集器（collector），您可以根据需要启用或禁用它们。有关收集器的更多信息，请参阅 collectors-list 部分。

用法

alloy 复制

prometheus.exporter.windows "<LABEL>" {
}

参数

您可以为 prometheus.exporter.windows 配置以下参数

enabled_collectors 定义了一个手动挑选的默认启用收集器列表。如果设置了此参数，则未在此列表中提供的任何收集器将默认禁用。有关默认设置，请参阅收集器列表。

块 (Blocks)

您可以为 prometheus.exporter.windows 配置以下块 (block)

dfsr

exchange

iis

用户提供的 app_exclude、app_include、site_exclude 和 site_include 字符串将被包装在正则表达式中。

logical_disk

卷名必须匹配 include 指定的正则表达式，且不能匹配 exclude 指定的正则表达式才能被包含。

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

msmq

指定 enabled_classes 有助于将响应限制为您指定的 MSMQ，从而减小响应的大小。

mssql

network

网卡 (NIC) 名称必须匹配 include 指定的正则表达式，且不能匹配 exclude 指定的正则表达式才能被包含。

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

physical_disk

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

printer

打印机必须匹配 include 指定的正则表达式，且不能匹配 exclude 指定的正则表达式才能被包含。

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

process

进程必须匹配 include 指定的正则表达式，且不能匹配 exclude 指定的正则表达式才能被包含。

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

scheduled_task

要包含服务器名，它必须匹配 include 指定的正则表达式，且不能匹配 exclude 指定的正则表达式。

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

service

where_clause 参数可用于将响应限制为您指定的服务，从而减小响应的大小。如果启用了 use_api，则 where_clause 将无效。

v2 收集器可以更高效地查询服务状态，但无法提供通用的服务信息。

smb

enabled_list 指定的收集器可包含以下内容

• ServerShares

例如，enabled_list 可以设置为 ["ServerShares"]。

smb_client

enabled_list 指定的收集器可包含以下内容

• ClientShares

例如，enabled_list 可以设置为 "ClientShares"。

smtp

要包含服务器名，它必须匹配 include 指定的正则表达式，且不能匹配 exclude 指定的正则表达式。

用户提供的 exclude 和 include 字符串将被包装在正则表达式中。

text_file

text_file_directory 的默认值是相对于 Alloy 可执行文件的位置。默认情况下，text_file_directory 被设置为 Alloy 安装目录中的 textfile_inputs 目录。例如，如果 Alloy 安装在 C:\Program Files\GrafanaLabs\Alloy\，则默认值为 C:\Program Files\GrafanaLabs\Alloy\textfile_inputs。

设置 text_file_directory 后，只会读取指定目录内扩展名为 .prom 的文件。

导出的字段

以下字段是导出的，可供其他组件引用。

例如，targets 可以传递给 discovery.relabel 组件以重写目标的标签集，或者传递给 prometheus.scrape 组件以收集暴露的指标。

导出的目标使用由 run 命令指定的配置好的内存流量地址。

组件健康状况

prometheus.exporter.windows 仅在给定无效配置时报告为不健康。在这种情况下，导出的字段将保留其上次健康时的值。

调试信息

prometheus.exporter.windows 不会暴露任何组件特定的调试信息。

调试指标

prometheus.exporter.windows 不会暴露任何组件特定的调试指标。

包装正则表达式字符串

某些收集器块，例如 scheduled_task，接受字符串格式的正则表达式参数。prometheus.exporter.windows 会将一些正则表达式字符串参数前缀为 ^(?:，后缀为 )$。例如，如果用户将 exclude 参数设置为 ".*"，Alloy 会将其设置为 "^(?:.*)$"。

要了解某个特定的正则表达式参数是否会被包装，请参考收集器块的文档。

收集器列表

下表列出了 windows_exporter 中可用的收集器。有些收集器仅适用于特定的操作系统，在 Alloy 运行的主机操作系统上启用不受支持的收集器将是一个空操作。

用户可以选择启用部分收集器以限制 prometheus.exporter.windows 组件暴露的指标数量，或禁用运行成本较高的收集器。

有关报告指标、配置设置和使用示例的更多信息，请参考每个收集器的链接文档。

示例

以下示例使用 prometheus.scrape 组件从 prometheus.exporter.windows 收集指标

alloy 复制

prometheus.exporter.windows "default" { }

// Configure a prometheus.scrape component to collect windows metrics.
prometheus.scrape "example" {
  targets    = prometheus.exporter.windows.default.targets
  forward_to = [prometheus.remote_write.demo.receiver]
}

prometheus.remote_write "demo" {
  endpoint {
    url = "<PROMETHEUS_REMOTE_WRITE_URL>"

    basic_auth {
      username = "<USERNAME>"
      password = "<PASSWORD>"
    }
  }
}

替换以下内容

• <PROMETHEUS_REMOTE_WRITE_URL>: 要将指标发送到的 Prometheus remote_write 兼容服务器的 URL。
• <USERNAME>: 用于 remote_write API 认证的用户名。
• <PASSWORD>: 用于 remote_write API 认证的密码。

兼容的组件

prometheus.exporter.windows 导出的内容可供以下组件使用

• 使用 Targets 的组件