# PVE Metrics Exporter

PVE Metrics Exporter is a self-hosted infrastructure app. Proxmox VE exporter for Prometheus and Glance: node, VM and container resource metrics plus the CPU/GPU/NVMe hardware temperatures most Proxmox exporters skip. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3236/pve-metrics-exporter

## Description

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.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 88 (last commit 35 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/pve-metrics-exporter-06kreq81shdkz0?q=pve-metrics-exporter
- GitHub: https://github.com/drumandbytes/pve-metrics-exporter

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3236/pve-metrics-exporter), the self-hosted and open-source app directory.
