PVE Metrics Exporter

Proxmox VE exporter for Prometheus and Glance: node, VM and container resource metrics plus the CPU/GPU/NVMe hardware temperatures most Proxmox exporters skip.

  • Infrastructure
  • Monitoring & Logging
  • Network Services
  • Tools & Utilities
Proxmox VE exporter for Prometheus and Glance: node, VM and container resource metrics plus the CPU/GPU/NVMe hardware temperatures most Proxmox exporters skip. Serves /metrics for Prometheus and /api/summary for Glance from one shared cache.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

50/100 Fair

Maintained
88last commit 35 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 18 days ago

GitHub stars
0
Open issues
0
Last commit
2026-10-17
Latest release
v1.2.2
License
MIT
Activity
stale

Checked 6 days ago - source: GitHub (drumandbytes/pve-metrics-exporter)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add the Proxmox driver to Rancher In Rancher, add the pve-node-driver Helm repository (the list of chart packages) and install the Proxmox VE node driver extension. Without it, Rancher does not know how to create or manage Proxmox virtual machines. source
  • Point offline Rancher to local driver files If your Rancher server is offline, set the nodeDriver.url and uiPlugin.endpoint install options to your own local URLs that host the driver and UI plugin files. Without this, the install fails because Rancher tries to download those files from the internet. source
  • Configure Prometheus and Glance endpoints Point Prometheus at /metrics and Glance at /api/summary; both endpoints share one data fetch/cache. source
  • Hardware sensor source Temperature metrics reflect what lm-sensors reports on the Proxmox host, so available CPU, GPU, NVMe, and chipset readings depend on the host's sensor configuration. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which endpoints should I configure in Prometheus and Glance?

Point Prometheus at /metrics and Glance at /api/summary. Both endpoints are served from the same short-TTL cache.

What port does the exporter listen on?

It listens on port 9221 by default. You can change this with the LISTEN_ADDR environment variable.

What Proxmox token permissions are required?

Create an API token with read access to /, /nodes, and the storage or VM paths you want monitored. PVEAuditor is enough because the exporter never writes, and PROXMOX_TOKEN must contain the full Authorization header value rather than just the token ID.

How do I handle Proxmox's default self-signed TLS certificate?

PROXMOX_INSECURE_SKIP_VERIFY defaults to true, so the default self-signed certificate works out of the box. Set it to false once Proxmox is using a trusted certificate.

How often does the exporter query the Proxmox API?

It reuses fetched data for CACHE_TTL, which defaults to 15 seconds. If a refresh fails, stale data can be used for up to CACHE_MAX_STALE, which defaults to 5 minutes.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads