PVEViewer: kompletny przegląd narzędzia do inwentaryzacji i raportowania VM w Proxmox VE

Zarządzanie infrastrukturą wirtualizacyjną opartą na Proxmox VE bywa proste, dopóki liczba maszyn wirtualnych nie przekroczy kilkunastu, a klastrów nie zrobi się więcej niż jeden. Wtedy pojawia się pytanie, które zna każdy administrator: „Ile mam w sumie VM-ów, ile zasobów zużywają i gdzie dokładnie leżą problemy?”. Odpowiedzią na ten problem jest PVEViewer — darmowe narzędzie dla Windows, które łączy się z klastrami Proxmox VE przez REST API i w kilkadziesiąt sekund zamienia surowe dane API w czytelny, wielozakładkowy raport Excel oraz interaktywne, filtrowalne widoki na żywo.

W tym artykule wyjaśniamy dokładnie, czym jest PVEViewer, jak działa, dla kogo jest przeznaczony, jakie problemy rozwiązuje oraz czym różni się od ręcznej inwentaryzacji, skryptów własnych i innych narzędzi do monitoringu Proxmox.

Spis treści

1. Czym jest PVEViewer
2. Dla kogo jest to narzędzie
3. Jak działa PVEViewer — krok po kroku
4. Pełny przegląd funkcji
5. Eksport do Excela — 13 zakładek workbooka
6. Automatyczna analiza zdrowia klastra (health check)
7. Praca z wieloma klastrami
8. Backup konfiguracji hosta
9. Tryb CLI i automatyzacja
10. Bezpieczeństwo i uwierzytelnianie
11. PVEViewer a migracja z VMware
12. Czym PVEViewer różni się od innych narzędzi
13. Najczęściej zadawane pytania (FAQ)
14. Podsumowanie

1. Czym jest PVEViewer?

PVEViewer to darmowa aplikacja na Windows do inwentaryzacji, raportowania i planowania pojemności (capacity planning) środowisk Proxmox VE. Program łączy się z dowolnym węzłem klastra Proxmox przez oficjalne REST API i metryki RRD, zbiera dane równolegle ze wszystkich hostów i maszyn wirtualnych, a następnie prezentuje je na dwa sposoby:

• jako żywe, filtrowalne siatki danych bezpośrednio w aplikacji,
• jako kompletny, 13-zakładkowy skoroszyt Excel, gotowy do analizy, wysłania przełożonemu lub zaimportowania do innego systemu.

Kluczowa filozofia narzędzia brzmi: żadnych agentów, żadnej bazy danych historii — tylko odpowiedzi. PVEViewer nie instaluje niczego na hostach Proxmox. Jedynym wymaganiem jest QEMU Guest Agent wewnątrz maszyn wirtualnych, który i tak w większości środowisk Proxmox już działa (dostarcza dane o adresach IP, systemach plików i systemie operacyjnym).

Narzędzie jest zbudowane pod aktualną gałąź Proxmox VE 9.x, obsługuje maszyny QEMU/KVM i komunikuje się z klastrem przez REST API oraz metryki RRD. Aplikacja jest samodzielnym (self-contained) plikiem .exe dla Windows 10/11 64-bit — nie wymaga instalacji ani środowiska .NET.

2. Dla kogo jest to narzędzie?

PVEViewer został zaprojektowany z myślą o kilku konkretnych grupach:

• Administratorzy infrastruktury, którzy potrzebują szybkiego, wiarygodnego obrazu tego, co dzieje się w klastrze Proxmox — bez ręcznego klikania po interfejsie webowym node po nodzie.
• Zespoły migrujące z VMware, dla których strona wprost wskazuje PVEViewer jako narzędzie „purpose-built” — przyzwyczajone do klasycznych, wielozakładkowych eksportów inwentaryzacyjnych znanych z narzędzi VMware, PVEViewer daje analogiczne doświadczenie na Proxmoksie.
• Konsultanci i integratorzy IT, którzy potrzebują szybko przygotować raport stanu środowiska klienta na potrzeby audytu lub wyceny.
• Zespoły odpowiedzialne za capacity planning, które chcą wiedzieć, gdzie brakuje zasobów, zanim skończy się miejsce na dysku lub pamięć RAM.
• Administratorzy odpowiedzialni za compliance i disaster recovery, którzy potrzebują regularnych, zautomatyzowanych zrzutów konfiguracji hostów.

3. Jak działa PVEViewer — krok po kroku

Proces pracy z PVEViewer sprowadza się do trzech kroków, które — zgodnie z opisem producenta — zajmują poniżej minuty od połączenia do gotowego arkusza.

Krok 1: Connect (Połącz)

Wystarczy wskazać dowolny jeden węzeł klastra. Do uwierzytelnienia można użyć:

• tokenu API (metoda rekomendowana),
• nazwy użytkownika i hasła z obsługą TOTP (2FA) jako fallback.

Samopodpisane certyfikaty SSL działają od razu, bez dodatkowej konfiguracji. Profil połączenia można zapisać do ponownego użycia.

Krok 2: Collect (Zbierz)

Po połączeniu aplikacja równolegle odpytuje całe API klastra oraz metryki RRD, zbierając:

• konfigurację i status każdej maszyny wirtualnej,
• migawki (snapshoty),
• dane z guest agenta,
• wykorzystanie zasobów (CPU, RAM, dysk, sieć),

a następnie automatycznie uruchamia reguły analizy zdrowia klastra.

Krok 3: Export (Eksportuj)

Dane można przeglądać na żywo w aplikacji albo wyeksportować w postaci pełnego, wielozakładkowego skoroszytu. Cały proces da się też zautomatyzować i uruchamiać bez nadzoru dzięki wersji CLI.

4. Pełny przegląd funkcji

Pełna inwentaryzacja VM

PVEViewer zbiera dane o każdym guest QEMU w klastrze: liczbę wirtualnych CPU, pamięć, dyski, partycje, interfejsy sieciowe, narzędzia guest agenta oraz migawki. Wszystko trafia do przejrzystych, sortowalnych siatek danych.

13-zakładkowy eksport do Excela

Jedno kliknięcie generuje kompletny skoroszyt z zakładkami: Info, CPU, Memory, Disk, Partition, Network, Tools, Snapshot, Host, Cluster, Storage oraz Health i metadane — gotowy do dalszej analizy lub przekazania zespołowi.

Wbudowana analiza zdrowia (health check)

Automatyczne reguły wykrywają m.in.:

• osierocone wolumeny dyskowe,
• brakujące lub „ciche” guest agenty,
• nieaktualne, zalegające migawki,
• presję na przestrzeń dyskową,
• przeciążenie (overcommit) CPU i pamięci,
• utratę kworum klastra,
• wygasające certyfikaty,
• oczekujące aktualizacje systemowe.

Obsługa wielu klastrów

Do jednej „lokacji” można dodać maksymalnie dwa klastry, zapisywać wielokrotnego użytku profile połączeń i łączyć wszystko w jeden skoroszyt — z kolumną źródłowego klastra na każdej zakładce.

Backup konfiguracji hosta

Funkcja niezależna od backupu samych maszyn wirtualnych. Przez SSH PVEViewer przechwytuje stan potrzebny do odtworzenia węzła po reinstalacji: konfigurację sieci, storage.cfg, katalog /etc/pve, użytkowników, klucze SSH hosta oraz listę zainstalowanych pakietów. Opcjonalnie dostępne jest szyfrowanie AES kompatybilne z OpenSSL oraz notatki przywracania per host.

Tryb bezobsługowy (CLI)

Zaplanowane, headless’owe eksporty uruchamiane na podstawie pliku konfiguracyjnego z zapisanymi profilami — idealne do nocnych zrzutów inwentaryzacji zapisywanych na udziale sieciowym. GUI i CLI to dwa oddzielne, samodzielne pliki do pobrania.

5. Eksport do Excela — 13 zakładek workbooka

To, co odróżnia PVEViewer od zwykłego dashboardu, to jakość eksportu. Skoroszyt buduje się w oparciu o bibliotekę ClosedXML i zawiera osobną zakładkę dla każdego wymiaru danych: Info, CPU, Memory, Disk, Partition, Network, Tools, Snapshot, Host, Cluster, Storage, Health. Każda zakładka jest filtrowalna, sortowalna i gotowa do dalszego przetwarzania w tabeli przestawnej.

Średnie i szczytowe wartości zużycia CPU oraz pamięci pochodzą bezpośrednio z bazy RRD Proxmoksa — nie trzeba do tego żadnego dodatkowego agenta poza standardowym QEMU Guest Agentem, który i tak działa w większości maszyn wirtualnych.

6. Automatyczna analiza zdrowia klastra

Zamiast przeglądać ręcznie logi i konfigurację każdej maszyny, PVEViewer uruchamia zestaw reguł diagnostycznych, które w jednym przebiegu wskazują potencjalne problemy — od osieroconych wolumenów po utratę kworum klastra. W przykładowym raporcie z dokumentacji narzędzia pojedynczy przebieg na dwóch klastrach (4 węzły, 38 VM oraz 2 węzły, 17 VM) wygenerował siedem takich ustaleń w ramach jednego, kilkusekundowego przebiegu.

7. Praca z wieloma klastrami

Środowiska produkcyjne rzadko składają się z jednego klastra. PVEViewer pozwala dodać do dwóch klastrów na jedną „lokację” (site), zapisać profile połączeń do ponownego wykorzystania i scalić dane w jeden skoroszyt z kolumną wskazującą źródłowy klaster na każdej zakładce — co jest szczególnie przydatne przy porównywaniu obciążenia pomiędzy lokalizacjami czy środowiskami (produkcja vs. staging).

8. Backup konfiguracji hosta

Warto podkreślić, że to nie jest backup maszyn wirtualnych — do tego służy vzdump czy Proxmox Backup Server. Funkcja backupu hosta w PVEViewer odpowiada na inne pytanie: co zrobić, gdy fizyczny serwer ulegnie awarii i trzeba go odtworzyć od zera? Program przez SSH zbiera konfigurację sieci, plik storage.cfg, cały katalog /etc/pve, listę użytkowników, klucze hosta SSH oraz zainstalowane pakiety, opcjonalnie szyfrując wynik algorytmem AES zgodnym z OpenSSL i dołączając instrukcje przywracania.

9. Tryb CLI i automatyzacja

Wszystkie funkcje PVEViewer są dostępne również z linii poleceń, co pozwala zautomatyzować cały proces inwentaryzacji. Przykładowe wywołanie z dokumentacji narzędzia:

# nocna inwentaryzacja dla każdego zapisanego klastra
PVEViewer.Cli.exe --config sites.json --out \\nas\reports

→ Cluster-A  4 nodes · 38 VMs   collected
→ Cluster-B  2 nodes · 17 VMs   collected
→ health rules: 7 findings
✓ PVEViewer_site_2026-06-29.xlsx  (13 tabs)

# backup konfiguracji hostów do odtworzenia bare-metal
PVEViewer.Cli.exe backup-hosts --encrypt --out D:\Backups

Dzięki temu Harmonogram zadań Windows (Task Scheduler) może co noc generować świeży raport inwentaryzacyjny i zrzucać go na udział sieciowy — bez udziału administratora. CLI działa jako pojedynczy, samodzielny plik .exe, bez konieczności instalowania środowiska .NET, a tryb --selftest pozwala zobaczyć przykładowy skoroszyt bez podłączania jakiejkolwiek prawdziwej infrastruktury.

10. Bezpieczeństwo i uwierzytelnianie

PVEViewer wspiera dwa modele uwierzytelniania zgodne ze standardami Proxmox VE:

1. Token API — rekomendowana metoda, pozwalająca ograniczyć zakres uprawnień bez udostępniania hasła administratora.
2. Login i hasło z TOTP — klasyczne uwierzytelnianie dwuskładnikowe jako opcja zapasowa.

Samopodpisane certyfikaty, powszechne w środowiskach Proxmox, są akceptowane domyślnie, bez konieczności ręcznego importowania łańcucha certyfikatów.

11. PVEViewer a migracja z VMware

Twórcy narzędzia wprost pozycjonują je jako rozwiązanie dla zespołów migrujących z VMware. To ma sens: administratorzy przyzwyczajeni do klasycznych narzędzi inwentaryzacyjnych VMware (np. RVTools) oczekują podobnego doświadczenia — wielozakładkowego arkusza Excel z pełnym obrazem środowiska. PVEViewer odtwarza dokładnie ten model pracy, ale natywnie dla REST API Proxmoksa, bez potrzeby przepisywania własnych skryptów PowerShell czy Pythona.

12. Czym PVEViewer różni się od innych narzędzi

PVEViewer nie jest zamiennikiem pełnej platformy monitoringu — nie buduje własnej bazy danych historycznych, nie wysyła alertów w czasie rzeczywistym. Jest za to narzędziem point-in-time: każde uruchomienie to świeży, wiarygodny zrzut stanu środowiska, wzbogacony o dane trendu (średnie i szczytowe wartości) pobierane bezpośrednio z RRD Proxmoksa.

13. Najczęściej zadawane pytania (FAQ)

Czy PVEViewer jest powiązany z Proxmox?

Nie. To niezależne narzędzie, które komunikuje się z Proxmox VE przez publiczne REST API. Nie jest afiliowane, popierane ani sponsorowane przez Proxmox Server Solutions GmbH. „Proxmox” jest znakiem towarowym należącym do jego właściciela.

Czy trzeba coś instalować na hostach Proxmox?

Nie. PVEViewer odczytuje wszystko przez standardowe REST API oraz metryki RRD. Jedynym wymogiem jest QEMU Guest Agent wewnątrz maszyn wirtualnych — w większości wdrożeń Proxmox i tak już działa, dostarczając bardziej szczegółowych danych (adresy IP, systemy plików, informacje o systemie operacyjnym).

Jak wygląda uwierzytelnianie?

Rekomendowany jest token API. Wspierane jest też uwierzytelnianie login/hasło z TOTP jako opcja zapasowa. Certyfikaty samopodpisane są akceptowane domyślnie.

Czy PVEViewer obsługuje kontenery LXC?

Nie w obecnej wersji — narzędzie skupia się na maszynach wirtualnych QEMU/KVM w kontekście planowania pojemności i inwentaryzacji.

Czy program przechowuje historię danych?

Z założenia jest to narzędzie typu point-in-time — każde uruchomienie to świeży zrzut. Średnie i szczytowe zużycie zasobów pochodzi bezpośrednio z danych RRD Proxmoksa, więc kontekst trendu jest dostępny bez konieczności utrzymywania lokalnej bazy danych.

Czym różni się „backup konfiguracji hosta” od zwykłego backupu VM?

To osobna funkcja od backupu maszyn wirtualnych. Przez SSH przechwytywana jest konfiguracja potrzebna do odbudowy węzła po czystej reinstalacji: sieć, storage.cfg, katalog /etc/pve, użytkownicy, klucze hosta SSH oraz lista pakietów, z opcjonalnym szyfrowaniem AES. Nie zastępuje to narzędzia vzdump ani Proxmox Backup Server.

Ile kosztuje PVEViewer?

Aplikacja jest darmowa dla Windows. Autor przyjmuje dobrowolne wsparcie (donacje) na rozwój projektu, ale korzystanie z pełnej funkcjonalności nie wymaga żadnej opłaty.

Jakie wersje Proxmox są wspierane?

Narzędzie jest budowane pod gałąź Proxmox VE 9.x i komunikuje się z API oraz metrykami RRD tej wersji.

14. Podsumowanie

PVEViewer wypełnia realną lukę w ekosystemie Proxmox VE: brak natywnego, wielozakładkowego narzędzia do inwentaryzacji i raportowania w stylu znanym z narzędzi VMware. Bez instalowania agentów, bez budowania własnej bazy historycznej, jednym połączeniem przez REST API i SSH można w mniej niż minutę uzyskać:

• pełny obraz wszystkich maszyn wirtualnych w jednym lub dwóch klastrach,
• gotowy do wysłania, 13-zakładkowy raport Excel,
• automatyczną listę problemów wykrytych przez reguły health-check,
• opcjonalny, zaszyfrowany backup konfiguracji każdego hosta na wypadek awarii bare-metal,
• pełną automatyzację przez CLI i harmonogram zadań.

Dla administratorów Proxmox, zespołów migrujących z VMware oraz konsultantów IT, którzy regularnie potrzebują wiarygodnego, czytelnego raportu stanu środowiska — to praktyczne, darmowe i szybkie w użyciu narzędzie, warte przetestowania.

Pobierz PVEViewer (GUI) dla Windows · Pobierz wersję CLI

Uwaga: PVEViewer jest dostarczany „tak jak jest” (as is), bez gwarancji. Użytkownik odpowiada za weryfikację wyników we własnym środowisku. Narzędzie nie jest afiliowane, popierane ani sponsorowane przez Proxmox Server Solutions GmbH.