diff --git a/docs/FAQ.md b/docs/FAQ.md index 529ede763..e16cb4dcf 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -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 diff --git a/internal/api/config_handlers.go b/internal/api/config_handlers.go index 9050a8c59..26fc0816b 100644 --- a/internal/api/config_handlers.go +++ b/internal/api/config_handlers.go @@ -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." diff --git a/internal/monitoring/monitor.go b/internal/monitoring/monitor.go index 1965885da..7bd642347 100644 --- a/internal/monitoring/monitor.go +++ b/internal/monitoring/monitor.go @@ -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).