cv4pve-metrics-exporter is a Prometheus metrics exporter for Proxmox VE that provides comprehensive monitoring data for your virtualization infrastructure.
Features:
Prometheus metrics export for monitoring and alerting
Node health and status metrics
VM/Container resource usage and performance metrics
Storage capacity and usage metrics
Replication status monitoring
High Availability (HA) resource tracking
Subscription status monitoring
Disk SMART health monitoring
Customizable endpoint (host, port, URL path)
API token support for secure authentication
Multiple host support for HA configurations
What's new in 2.1.0
Breaking - cv4pve_replication_failed_total (counter) is replaced by cv4pve_replication_fail_count (gauge). Proxmox VE reports the failed attempts in a row, back to 0 at the first success: as a counter it never went down, and new failures after a recovery were not seen. Alert on cv4pve_replication_fail_count > 0. Fixed - Each scrape answered with the data of the previous one, and the first scrape after start was empty. - Concurrent API calls could receive each other's answers (the shared LastResult of the API client): each call now uses its own client, sharing connection and login. - A failed login or an unreachable cluster stopped the exporter. The scrape now answers HTTP 503, so Prometheus sets up to 0, and the exporter keeps running. - Series of objects that no longer exist were exported forever: a deleted guest or storage, a renamed guest, old tags, the previous version of an upgraded node, a guest later covered by a backup job, an offline node's per-node metrics. - Guest disk and network counters stayed frozen after a guest restarted or migrated; they now reset, and rate() works. - HA: cv4pve_ha_node_state never reported the node states, and cv4pve_ha_state did not use the states of the HA manager. Both now come from /cluster/ha/status/manager_status. - SMART: SAS disks, which report OK instead of PASSED, were exported as unhealthy. - The standard profile did not cache backup coverage (10 min) and subscription (1 h); a setting left out of the settings file now takes its standard value. - A call that failed was cached like a successful one and not retried until the cache expired. - Failed backup-coverage and balloon calls were not counted in cv4pve_scrape_errors_total (balloon: section="guest"), and cv4pve_scrape_last_success_timestamp_seconds advanced even when calls failed. - --debug and --log-level did not log the Proxmox VE API calls. - Under systemd without a WorkingDirectory the exporter hung at start (a file watcher on /); systemctl stop ended with exit code 143 and marked the unit failed; Type=notify reported ready before the endpoint was listening. - When the HTTP endpoint could not start (port taken, address not allowed) the exporter exited with code 0, so Restart=on-failure did not restart it. - As a Windows service, the log was not written anywhere; it now goes to the Event Log. - Help text of --settings-file. Changed …
What's Changed - feat: v2.0 major rewrite by @franklupo in #4 Full Changelog: v1.7.0...v2.0.0
1.7.0Jan 7, 2026
Frequently asked questions
Is cv4pve-metrics-exporter free?
Yes. cv4pve-metrics-exporter is free and open-source software released under the GPL-3.0 license.
What is the latest version of cv4pve-metrics-exporter?
The latest version is 2.1.0, released on Sep 30, 2026.
Is it safe to download cv4pve-metrics-exporter?
The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with 913559340b658e1519e7beaf36dfb2d189fe8a1fdfe54f100becf9f6ab1377a2.
Which Windows versions does cv4pve-metrics-exporter support?
cv4pve-metrics-exporter runs on Windows and is available for 32-bit (x86), 64-bit (x64), ARM64 systems.
How do I uninstall cv4pve-metrics-exporter?
Open Settings › Apps › Installed apps, find cv4pve-metrics-exporter and select Uninstall. From the command line, run winget uninstall --id=Corsinvest.cv4pve.metrics-exporter -e.
Is there a portable version of cv4pve-metrics-exporter?
Yes. cv4pve-metrics-exporter is available as a portable ZIP archive (cv4pve-metrics-exporter.exe-win-x64.zip, 64-bit (x64)) that runs without installation. Copy it to any folder or USB drive and run it from there.
Alternatives to cv4pve-metrics-exporter
Other Development kits programs for Windows from different developers.