Grafana 配置 Prometheus Proxmox VE Exporter

Published May 23, 2025Markdown

On this page

本文不做基础知识的扫盲。

我一直想将 PVE 上全量的虚拟机纳入 Grafana 中展示，然而又不想一台台的配置 node_exporter。偶然的机会听说了 Prometheus Proxmox VE Exporter 插件，索性配置一下这个插件，将 PVE 的数据接入 Grafana。

整体架构如下图：

1. 配置 PVE 用户

网上的很多教程都是直接拿 root@pam 账户来进行操作，但特权账号用作监控其实是安全风险蛮高的一件事情。这里我们单独建立一个审计（PVEAuditor）账户来执行操作。

建立账户很简单，登录网页控制台，在数据中心（Datacenter） → 权限（Permissions） → 用户（Users）中，直接添加一个用户即可。我这里使用的用户名是 monitor，鉴权方式（Realm）选择的是 PVE 鉴权。

之后要给用户配置审计角色（Role），这里很搞的是，PVE 没有办法通过 WebUI 来配置，需要登录到控制台执行命令：pveum aclmod / -user monitor@pve -role PVEAuditor 来实现。

命令执行成功后没有任何回显，但可以在 WebUI 中点击 Permissions 按钮就可以看到用户对应的权限。

2. 创建配置文件

在本地创建一个 pve.yml 文件，用于保存 PVE 的访问凭证。

可以使用密码或者 token，我这里使用的是密码，Token 的配置可参考项目官方 Github：https://github.com/prometheus-pve/prometheus-pve-exporter?tab=readme-ov-file#authentication

💡

我的 PVE 绑定了域名并配置了有效的证书，如果你使用的是自签名证书，请不要开启 SSL 校验。

3. 拉起插件的 Docker 镜像

最开始我其实是希望在本地直接用 Python 虚拟环境启动的，结果在使用 pip install prometheus-pve-exporter 的过程中，有一个依赖始终找不到，后面懒得去找了，索性直接拉 Docker 镜像。

拉镜像也很简单，直接命令执行 docker run --init --name prometheus-pve-exporter -d -p 127.0.0.1:9221:9221 -v /root/pve.yml:/etc/prometheus/pve.yml prompve/prometheus-pve-exporter 即可。

⚠

注：我的 prometheus-pve-exporter 和 prometheus、Grafana 是放在同一台机器上的，如果你的 exporter 是放在 PVE 宿主机上的，监听请监听 0.0.0.0 而非 127.0.0.1。

拉起来之后可以通过命令 curl http://localhost:9221/pve?target=<PVE IP地址> 试一下，看看能不能读取到 metrics。

4. 添加 Prometheus 配置

这一步直接跟着官网的操作，在Prometheus 的配置文件 scrape_configs 下新增一项即可（注意不要出现两个 scrape_configs: ，同时记得调整 Proxmox VE node 的地址）。

scrape_configs:
  - job_name: 'pve'
    static_configs:
      - targets:
        - 192.168.1.2  # Proxmox VE node.
        - 192.168.1.3  # Proxmox VE node.
    metrics_path: /pve
    params:
      module: [default]
      cluster: ['1']
      node: ['1']
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: 127.0.0.1:9221  # PVE exporter.