跳到主要内容

PVE 虚拟机监控

Dash 0.4.0 配套 Node 0.3.0,支持本机 Proxmox VE QEMU VM 的当前状态、Guest Agent IP 和 PVE RRD 历史。包含关机 VM,排除模板;不包含 LXC、HA 配置和 VM 控制。

安装和启用​

安装 PVE 采集服务要求宿主机使用 systemd,并提供 /etc/pve 和 /usr/bin/pvesh。root helper 负责本机采集,Node 以非特权用户运行。无需 PVE API 用户、token 或本机编译器。

Dash 包含匹配的 PVE helper 时,桌面节点表、移动端卡片和节点设置弹窗均提供 PVE 部署入口。

  1. 使用携带 Node 0.3.0 及同版本 PVE helper 的 Dash 发布包。
  2. 在管理台创建节点,复制 PVE 安装命令(已包含 --pve),在 PVE 宿主机执行。
  3. 检查采集服务和 Node 服务:
systemctl status ithiltir-node-pve-cache.service ithiltir-node.service
journalctl -u ithiltir-node-pve-cache.service -n 100 --no-pager

安装器会在停止现有 Node 前校验 helper 的 SHA-256 和版本,并安装:

路径或服务用途
/usr/local/libexec/ithiltir-node/pve-cacheroot 所有的 helper 二进制
ithiltir-node-pve-cache.service运行 pve-cache --group <运行组>
/run/ithiltir-node/pve.sockroot 所有、运行组可访问的 Unix socket,权限 0660
Node systemd drop-in设置 ITHILTIR_NODE_PVE_SOCKET=/run/ithiltir-node/pve.sock 和 ITHILTIR_NODE_TRANSPORT=grpc
/run/ithiltir-node/pve-guest仅 root 可读的 Guest Agent 缓存和退避状态

Node 经 socket 读取内存中的观测结果。helper 重启后重新采集基本指标;IP 缓存状态可跨 helper 重启保留,宿主机重启时清空。

启用历史查询​

PVE 安装器会启用 gRPC 上报和历史查询连接。已有 PVE 安装重新执行 PVE 部署命令,即可更新 helper 和传输配置。

HTTPS 代理须支持 HTTP/2 并转发 /ithiltir.node.v1.Node/,应在安装前配置。gRPC 与 Dash HTTP 共用监听地址,app.grpc_port 不生效。配置见反向代理。

使用 Cloudflare 代理时,应先在对应域名的 Network(网络)→ gRPC 中开启 gRPC。源站入口须使用 HTTPS 443、支持通过 ALPN 协商 HTTP/2,Cloudflare SSL/TLS 模式至少为 Full。未开启 gRPC 时,Cloudflare 会返回 403 Forbidden。完整要求见 Cloudflare gRPC 文档。

管理员调用 GET /api/admin/nodes/{id}/virt/capabilities,确认 connected 和 pve_history 均为 true。

看板和访问权限​

点击宿主机卡片上的 PVE 图标进入 /pve/{id}。页面展示 VM 列表、详情和历史曲线,?vm=<vmid> 选择 VM。快照每 15 秒刷新;历史在选择 VM、时间范围或手动刷新时读取。

PVE 游客访问默认关闭。管理台系统设置开启 pve_guest_visible 后,游客仅能查看标为游客可见的宿主机,其 VM 名称、IP、快照和历史都会开放。该开关独立于宿主历史、流量和 Uptime 权限。

节点高级设置中的 VM CPU/内存阈值仅标注历史图表,不发送告警通知。CPU 默认阈值为 80%,内存默认 90% 且需单独启用;内存按历史点的内存上限计算,缺失数据保持未知。

采样与新鲜度​

数据采集和有效期
VM 清单每 3 秒刷新本机配置
VM 动态指标每 VM 间隔至少 3 秒;8 路并发,单次超时 2 秒,完成后即可读取
VM 观测每台 VM 独立 collected_at 和 90 秒 TTL;过期动态指标省略、状态变为 unknown
磁盘容量每 60 秒单独查询,超过 2 分钟省略
Guest Agent IP成功后最少 60 秒刷新;失败按 1、2、5 分钟退避;样本有效期 900 秒
Node VM 上报独立于宿主指标,每 3 秒读取 helper;失败后退避重试
Dash 快照缓存Redis 或 --no-redis 内存保存 10 分钟,重复或更旧样本不续期

只有 QMP 状态为 running 的 VM 采集动态指标和 IP。IP 还要求 PVE 启用 Guest Agent,且 VM 内代理正常运行。IP 查询不阻塞基本指标;VM 指标和 IP 各自独立过期。字段和地址过滤规则见 Dash API。

VM 历史按需读取 PVE RRD,支持 hour/day/week/month/year 与 AVERAGE/MAX。Dash 不把 VM 快照或历史写入 PostgreSQL,也不计入宿主流量、在线率或计费。

更新、停用和排错​

  • Node 自更新只替换普通 Node,不替换 root helper 和服务单元;更新 helper 时重新执行安装命令并加 --pve。
  • 重装时省略 PVE 选项会保留现有选择;--no-pve 停用并删除服务、helper 和 drop-in。
  • 没有快照:检查 helper 服务、socket 权限和 Node 的 ITHILTIR_NODE_PVE_SOCKET。
  • 有快照但历史不可用:检查 gRPC 代理、Node transport 和 capabilities。
  • 有指标但没有 IP:检查 PVE Guest Agent 配置、VM 内代理及 helper 日志;失败后按上述间隔重试。
  • node_offline 表示查询会话未连接;unsupported 表示不支持历史查询;busy 表示查询并发已满;deadline_exceeded 表示查询超时。

接口详情见 Dash API 和节点协议。

Cloudflare 返回 403​

如果 Node 日志同时出现 PermissionDenied、unexpected HTTP status code ... 403 和 text/html,且响应正文是 Cloudflare 错误页,先检查上述 gRPC 开关;已开启时,再检查 Cloudflare 安全事件和源站 gRPC 代理配置。credentials rejected 也可能由代理返回的 403 触发,不能单凭这条日志判断节点密钥错误。

修正配置后重启 Node,并检查日志:

sudo systemctl restart ithiltir-node
sudo journalctl -u ithiltir-node -n 100 --no-pager

Node 收到 PermissionDenied 或 Unauthenticated 后会停止该目标的历史查询重连,修正代理配置后仍需重启才能重新建立查询会话。最后检查 capabilities 中的 connected 和 pve_history 是否均为 true。