windows_exporterダウンロードwindows_exporterソースコードのダウンロード

windows_exporter

その他のソースコード

v0.29.2

ダウンロード

windows_exporter

Windowsマシン用のPrometheus Exporter。

コレクター

名前	説明	デフォルトで有効になっています
広告	Active Directoryドメインサービス
ADCS	Active Directory証明書サービス
ADFS	Active Directory Federationサービス
キャッシュ	キャッシュメトリック
CPU	CPUの使用	✓✓
cpu_info	CPU情報
CS	「コンピューターシステム」メトリック（システムプロパティ、num cpus/totalメモリ）
容器	コンテナメトリック
ディスクドライブ	ディスクドライブメトリック
DFSR	DFSRメトリック
DHCP	DHCPサーバー
DNS	DNSサーバー
交換	交換メトリック
filetime	ファイルメトリック
fsrmquota	Microsoft File Server Resource Manager（FSRM）クォータコレクター
HyperV	Hyper-Vホスト
iis	IISサイトとアプリケーション
ライセンス	Windowsライセンスステータス
logical_disk	論理ディスク、ディスクI/O	✓✓
ログオン	ユーザーログオンセッション
メモリ	メモリ使用量メトリック	✓✓
mscluster	MSClusterメトリック
MSMQ	MSMQキュー
MSSQL	SQL Serverパフォーマンスオブジェクトメトリック
netframework	.NETフレームワークメトリック
ネット	ネットワークインターフェイスI/O	✓✓
OS	OSメトリック（メモリ、プロセス、ユーザー）	✓✓
PageFile	PageFileメトリック
Performancecounter	カスタムパフォーマンスカウンターメトリック
Physical_Disk	物理ディスクメトリック	✓✓
プリンター	プリンターメトリック
プロセス	プロセスごとのメトリック
remote_fx	RemoteFXプロトコル（RDP）メトリック
Scheduled_task	スケジュールされたタスクメトリック
サービス	サービス状態メトリック	✓✓
SMB	SMBサーバー
smbclient	SMBクライアント
SMTP	IIS SMTPサーバー
システム	システム呼び出し	✓✓
TCP	TCP接続
Terminal_Services	ターミナルサービス（RDS）
TextFile	テキストファイルからPrometheusメトリックをお読みください
サーマルゾン	サーマル情報
時間	Windows Timeサービス
UDP	UDP接続
アップデート	Windows Updateサービス
vmware	VMwareゲストエージェントがインストールしたパフォーマンスカウンター

報告されたメトリック、構成設定、および使用例の詳細については、各コレクターのリンクドキュメントを参照してください。

フィルタリング有効コレクター

windows_exporterは、デフォルトで有効なコレクターからすべてのメトリックを公開します。これは、異なる家族のメトリックを比較するときにエラーを回避するためにメトリックを収集する推奨方法です。

高度な使用のために、 windows_exporterコレクターのオプションのリストに渡してメトリックをフィルタリングできます。 collect[]パラメーターは複数回使用できます。 Prometheus構成では、この構文をScrape Configで使用できます。

  params:
    collect[]:
      - foo
      - bar

これは、さまざまなプロメテウスサーバーがノードから特定のメトリックを収集するのに役立ちます。

フラグ

Windows_exporterは、特定の動作を構成するためにフラグを受け入れます。輸出業者のグローバルな動作を構成するものを以下にリストしますが、コレクター固有の動作は上記のそれぞれのコレクターのドキュメントに文書化されています。

フラグ	説明	デフォルト値
`--web.listen-address`	ホスト：輸出業者のためのポート。	`:9182`
`--telemetry.path`	収集されたメトリックのサーフェースのためのURLパス。	`/metrics`
`--telemetry.max-requests`	同時リクエストの最大数。 0無効にします。	`5`
`--collectors.enabled`	使用するコレクターのコンマ分離されたリスト。 `[defaults]`を使用して、デフォルトで有効になっているすべてのコレクターを含む拡張されたプレースホルダーとして使用します。」	`[defaults]`
`--collectors.print`	本当なら、利用可能なコレクターと出口を印刷します。
`--scrape.timeout-margin`	クライアントが許可されているタイムアウトから減算する秒。オーバーヘッドまたは高負荷を可能にするために調整します。	`0.5`
`--web.config.file`	TLSとAUTHを設定するためのWeb構成	なし
`--config.file`	パスまたはURLから構成ファイルを使用します	なし
`--config.file.insecure-skip-verify`	URLから構成ファイルをロードするときにTLSをスキップします	間違い
`--log.file`	ログメッセージの出力ファイル。 [stdout、stderr、eventlog、<ログファイルへのパス>]の1つ注： MSIインストーラーは、インストールされているサービスにデフォルトの引数を追加します。これをEventLogに設定します	stderr

インストール

最新リリースは、リリースページからダウンロードできます。

各リリースには.MSIインストーラーが提供されます。インストーラーは、Windows_ExporterをWindowsサービスとしてセットアップし、Windowsファイアウォールに例外を作成します。

インストーラーがパラメーターなしで実行されている場合、輸出者は有効なコレクター、ポートなどのデフォルト設定で実行されます。

インストーラーは、輸出者をカスタマイズする構成ファイルを提供します。

構成ファイル

Exporter実行可能ファイルと同じディレクトリにあります。
YAML形式があり、 --config.fileパラメーターが付属しています。
コレクターを有効または無効にし、コレクター固有のパラメーターを設定し、グローバルパラメーターを設定するために使用できます。

次のパラメーターが利用可能です。

名前	説明
`ENABLED_COLLECTORS`	`--collectors.enabled`フラグとして、有効なコレクターのコンマ集合リストを提供する
`CONFIG_FILE`	`--config.file`フラグを使用して、構成ファイルを指定します。空の場合、設定ファイルは設定されません。 Special Value `config.yaml` 、dirをインストールしてconfig.yamlへのパスを設定します
`LISTEN_ADDR`	バインドするIPアドレス。デフォルトは空の文字列になります。（ローカルアドレス）
`LISTEN_PORT`	バインドするポート。デフォルトは`9182`です。
`METRICS_PATH`	メトリックを提供するパス。デフォルトは`/metrics`になります
`TEXTFILE_DIRS`	`--collector.textfile.directories`フラグを使用して、コレクターがメトリックを含むテキストファイルを読み取るカンマで区切られた1つ以上のディレクトリを指定します。
`REMOTE_ADDR`	Windowsファイアウォールの例外（許可リスト）にコンマを分離したリモートIPアドレスを設定できます。デフォルトは空の文字列（任意のリモートアドレス）になります。
`EXTRA_FLAGS`	完全なCLIフラグを渡すことができます。デフォルトは空の文字列になります。 for `--collectors.enabled`および`--config.file` 、特殊なプロパティ`ENABLED_COLLECTORS`と`CONFIG_FILE`使用します
`ADDLOCAL`	windows_exporterインストーラー内の機能を有効にします。サポートされた値： `FirewallException`
`REMOVE`	Windows_Exporterインストーラー内の機能を無効にします。サポートされた値： `FirewallException`

パラメーターは、 msiexecを介してインストーラーに送信されます。 PowerShellでは、プロパティを定義する前に--%を渡す必要があります。

招待状の例：

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="--collectors.exchange.enabled=""ADAccessProcesses"""

構成ファイルを定義します。

msiexec / i < path - to - msi - file > --% CONFIG_FILE="D:config.yaml"

Windowsの古いバージョンの一部では、インストールコマンドを適切に解析するために、二重引用符でパラメーター値を囲む必要がある場合があります。

msiexec / i C:UsersAdministratorDownloadswindows_exporter.msi --% ENABLED_COLLECTORS="ad,iis,logon,memory,process,tcp,textfile,thermalzone" TEXTFILE_DIRS="C:custom_metrics"

ファイアウォール例外を作成して輸出業者をインストールするには、次のコマンドを使用します。

msiexec / i < path - to - msi - file > --% ADDLOCAL=FirewallException

PowerShellバージョン7.3以降では、PSNativeCommandargumentPassingが使用されるときにLegacyに設定する必要があります--% EXTRA_FLAGS ：

 $PSNativeCommandArgumentPassing = ' Legacy '
msiexec / i < path - to - msi - file > ENABLED_COLLECTORS = os , service --% EXTRA_FLAGS="--collectors.exchange.enabled=""ADAccessProcesses"""

Dockerの実装

Windows_exporterは、Dockerコンテナとして実行できます。 Docker画像はで使用できます

Docker Hub： docker.io/prometheuscommunity/windows-exporter
githubコンテナレジストリ： ghcr.io/prometheus-community/windows-exporter

さらに、接尾辞として-hostprocessを備えたフレーバーhostprocessは、Windowsホストプロセスコンテナとして実行されるように設計されたhttps://github.com/microsoft/windows-host-process-containers-base-imageに基づいています。その画像のサイズは、デフォルトの画像よりも小さいです。

Kubernetesの実装

Windows Kubernetesにインストールする詳細な手順を参照してください。

サポートされているバージョン

windows_exporter 、Windows Serverバージョン2016以降、およびWindowsバージョン10および11（21H2以降）をデスクトップすることをサポートしています。

Windows Server 2012および2012R2は、Best-Effortのみとしてサポートされていますが、機能することは保証されていません。

使用法

 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で公開されます

HTTPエンドポイント

Windows_Exporterは、次のHTTPエンドポイントを提供します。

/metrics ：Prometheusテキスト形式でメトリックを公開します。
/health ：輸出業者が実行されているときに200 OKを返します。
/debug/pprof/ ：pprofエンドポイントを公開します。 --debug.enabledが設定されている場合にのみ。

例

サービスコレクターのみを有効にし、カスタムクエリを指定します

 .windows_exporter.exe --collectors.enabled "service" --collector.service.include="windows_exporter"

プロセスコレクターのみを有効にし、カスタムクエリを指定します

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

同じ名前の複数のプロセスがある場合、WMIは最初のインスタンスの後のプロセスprocess-name#indexとして表します。したがって、最初のものだけでなく、すべてを取得するには、正規表現を使用する必要があります.+ 。詳細については、プロセスを参照してください。

[defaults]を使用して、 `--collectors.enabled`引数を使用します

[defaults]を使用して、すべてのデフォルトコレクターで拡張される--collectors.enabled引数を使用します。

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

これにより、デフォルトの上に追加のプロセスとコンテナコレクターが可能になります。

構成ファイルを使用します

YAML構成ファイルは、 --config.fileフラグで指定できます。例.windows_exporter.exe --config.file=config.yml 。絶対パスを使用している場合は、必ずパスを引用してください.windows_exporter.exe --config.file="C:Program Fileswindows_exporterconfig.yml"

構成をURLからロードすることもできます。例.windows_exporter.exe --config.file="https://example.com/config.yml"

TLS検証をスキップする必要がある場合は、 --config.file.insecure-skip-verifyフラグを使用できます。 Eg .windows_exporter.exe --config.file="https://example.com/config.yml" --config.file.insecure-skip-verify

 collectors :
  enabled : cpu,net,service
collector :
  service :
    include : windows_exporter
log :
  level : warn

構成ファイルの例はこちらにあります。

構成ファイルノート

構成ファイルの値は、CLIフラグと混合できます。例えば

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

 log :
  level : debug

CLIフラグは、構成ファイルで指定された値よりも優先度が高いことを享受しています。

ライセンス

MITの下

拡大する

追加情報

バージョン v0.29.2
タイプその他のソースコード
更新時間 2025-05-12
サイズ 590.26KB
から Github

windows_exporter