docs: provide honest assessment of PVE 9 VM disk monitoring

Stop making definitive claims about what works or doesn't work. The reality:
- Some users (like you) have it working fine in cluster configs
- Others report 0% disk usage
- The exact conditions that make it work are unclear
- Results vary between different setups

Updated all docs and messages to reflect this uncertainty rather than making false claims about non-existent workarounds or absolute limitations.
This commit is contained in:
Pulse Monitor
2025-08-25 15:20:34 +00:00
parent 6f86ad5b7f
commit 35cecd475a
3 changed files with 20 additions and 20 deletions
+6 -5
View File
@@ -91,11 +91,12 @@ Reduce `metricsRetentionDays` in settings and restart
### Why do VMs show 0% disk usage?
This is usually one of these issues:
**Proxmox 9**: API tokens cannot access guest agent data due to a Proxmox bug (#1373). Unfortunately there's no workaround:
- VM.Monitor permission was removed in PVE 9 (replaced with VM.GuestAgent.Audit)
- Even with correct permissions, API tokens are blocked from accessing VM disk info
- You'll have to accept that VM disk usage will show 0% until Proxmox fixes this
- Note: Container (LXC) disk usage works fine
**Proxmox 9**: VM disk monitoring has mixed results:
- Some users report it working fine, especially in cluster configurations
- Others see 0% disk usage due to API token limitations
- VM.Monitor permission was removed (replaced with VM.GuestAgent.Audit)
- If you're seeing 0%, there's currently no reliable workaround
- Note: Container (LXC) disk usage always works fine
**Proxmox 8**: Check that:
1. QEMU Guest Agent is installed and running in the VM
+10 -11
View File
@@ -2164,19 +2164,18 @@ else
fi
echo ""
echo "⚠️ IMPORTANT: Proxmox 9 VM Disk Usage Limitation"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "VM disk usage may show 0% on Proxmox 9 due to API token limitations."
echo "⚠️ NOTE: Proxmox 9 VM Disk Usage"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "VM disk usage may show 0% on Proxmox 9 with API tokens."
echo ""
echo "This is a known Proxmox issue where guest agent data (get-fsinfo)"
echo "is not accessible to API tokens, even with correct permissions."
echo "Proxmox's own web UI also shows 0% for VM disk usage (bug #1373)."
echo "This appears to be a Proxmox limitation where guest agent data"
echo "may not be accessible to API tokens in some configurations."
echo ""
echo "Unfortunately, there are NO working workarounds for API tokens:"
echo " 1. VM.Monitor was removed in PVE 9 (replaced with VM.GuestAgent.Audit)"
echo " 2. Even with correct permissions, tokens can't access guest agent data"
echo " 3. Container (LXC) disk usage works correctly with tokens"
echo " 4. You'll have to accept 0% VM disk usage until Proxmox fixes this"
echo "Results vary:"
echo " • Some users report it works, especially in cluster setups"
echo " • Others see 0% disk usage for VMs"
echo " Container (LXC) disk usage always works correctly"
echo " • If you see 0%, try configuring as a cluster if possible"
echo ""
echo "Note: qemu-guest-agent must be installed in VMs for any disk"
echo "monitoring to work. The data exists but token access is restricted."
+4 -4
View File
@@ -988,7 +988,7 @@ func (m *Monitor) pollVMsAndContainersEfficient(ctx context.Context, instanceNam
log.Info().
Str("instance", instanceName).
Str("vm", res.Name).
Msg("• Proxmox 9: API tokens cannot access guest agent data (Proxmox bug #1373)")
Msg("• Proxmox 9: API tokens may not be able to access guest agent data")
log.Info().
Str("instance", instanceName).
Str("vm", res.Name).
@@ -996,7 +996,7 @@ func (m *Monitor) pollVMsAndContainersEfficient(ctx context.Context, instanceNam
log.Info().
Str("instance", instanceName).
Str("vm", res.Name).
Msg("Unfortunately, there's no working workaround for API tokens on PVE 9 - VM disk will show 0%")
Msg("• Some PVE 9 users report it works in cluster configs, but results vary")
} else {
log.Debug().
Err(err).
@@ -1370,7 +1370,7 @@ func (m *Monitor) pollVMsWithNodes(ctx context.Context, instanceName string, cli
log.Info().
Str("instance", instanceName).
Str("vm", vm.Name).
Msg("• Proxmox 9: API tokens cannot access guest agent data (Proxmox bug #1373)")
Msg("• Proxmox 9: API tokens may not be able to access guest agent data")
log.Info().
Str("instance", instanceName).
Str("vm", vm.Name).
@@ -1378,7 +1378,7 @@ func (m *Monitor) pollVMsWithNodes(ctx context.Context, instanceName string, cli
log.Info().
Str("instance", instanceName).
Str("vm", vm.Name).
Msg("Unfortunately, there's no working workaround for API tokens on PVE 9 - VM disk will show 0%")
Msg("• Some PVE 9 users report it works in cluster configs, but results vary")
} else {
log.Debug().
Err(err).