prompve/prometheus-pve-exporter

Prometheus Proxmox VE Exporter

概述

Prometheus Proxmox VE Exporter是一款从Proxmox VE节点收集信息并供Prometheus监控系统使用的导出器。它支持多种收集器（状态、版本、节点、集群、资源、配置等），可通过Docker便捷部署，适用于监控Proxmox VE集群的运行状态、资源使用及版本信息等。

安装

使用pip安装

注意：自2.0.0版本起不再支持Python 2，请使用Python 3.6或更高版本。

shell
python3 -m pip install prometheus-pve-exporter

使用Docker安装

shell
docker pull docker.xuanyuan.run/prompve/prometheus-pve-exporter

示例：显示使用帮助信息

shell
docker run -it --rm docker.xuanyuan.run/prompve/prometheus-pve-exporter --help

示例：运行容器（挂载配置文件并发布端口）

shell
docker run --name prometheus-pve-exporter -d -p 127.0.0.1:9221:9221 -v /path/to/pve.yml:/etc/pve.yml docker.xuanyuan.run/prompve/prometheus-pve-exporter

运行后，可通过 http://localhost:9221/ 访问Prometheus PVE Exporter。

使用方法

命令行参数说明

usage: pve_exporter [-h] [--collector.status] [--collector.version]
                    [--collector.node] [--collector.cluster]
                    [--collector.resources] [--collector.config]
                    [config] [port] [address]

位置参数:
  config                配置文件路径（pve.yml）
  port                  导出器监听端口（默认9221）
  address               导出器绑定地址

可选参数:
  -h, --help            显示帮助信息并退出
  --collector.status, --no-collector.status
                        暴露节点/虚拟机/容器状态（默认：启用）
  --collector.version, --no-collector.version
                        暴露PVE版本信息（默认：启用）
  --collector.node, --no-collector.node
                        暴露PVE节点信息（默认：启用）
  --collector.cluster, --no-collector.cluster
                        暴露PVE集群信息（默认：启用）
  --collector.resources, --no-collector.resources
                        暴露PVE资源信息（默认：启用）
  --collector.config, --no-collector.config
                        暴露PVE开机启动状态（默认：启用）

访问指标

在双栈机器上，使用::作为address参数可同时绑定IPv6和IPv4套接字。访问 http://localhost:9221/pve?target=1.2.3.4 获取指标（其中1.2.3.4为Proxmox VE节点IP）。可通过module请求参数指定配置文件中的模块。若导出器直接部署在Proxmox主机上，target参数默认为localhost，可省略。

注意：config收集器会对每个客户机VM/容器发起一次API调用，大规模部署中建议使用--no-collector.config禁用该收集器。

认证配置

密码认证示例（pve.yml）

yaml
default:
    user: prometheus@pve  # PVE用户名
    password: sEcr3T!     # 对应密码

令牌认证示例（pve.yml）

yaml
default:
    user: prometheus@pve    # PVE用户名
    token_name: "..."       # 令牌名称
    token_value: "..."      # 令牌值

配置直接传递给proxmoxer.ProxmoxAPI()。若Proxmox VE使用自签名证书，需将证书导入本地信任存储（Debian/Ubuntu可参考https://askubuntu.com/a/***），或在凭据同级添加`verify_ssl: false`。PVE默认支持Let's Encrypt，建议优先配置可信证书。

Proxmox VE配置

为安全起见，需创建具有只读访问权限（PVEAuditor角色）的用户用于指标收集。

Prometheus配置

导出器部署在PVE节点的示例配置

yaml
scrape_configs:
  - job_name: 'pve'
    static_configs:
      - targets:
        - 192.168.1.2:9221  # 运行PVE导出器的Proxmox VE节点
        - 192.168.1.3:9221  # 运行PVE导出器的Proxmox VE节点
    metrics_path: /pve
    params:
      module: [default]

导出器部署在Prometheus主机的示例配置

yaml
scrape_configs:
  - job_name: 'pve'
    static_configs:
      - targets:
        - 192.168.1.2  # Proxmox VE节点IP
        - 192.168.1.3  # Proxmox VE节点IP
    metrics_path: /pve
    params:
      module: [default]
    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导出器地址

Grafana仪表板

• https://grafana.com/dashboards/***