{
"meta": {
"title": "API Proxmox Monitor — Referenčná príručka integrácií | ProxMenux",
"description": "Koncové body HTTP ProxMenux Monitor pre Home Assistant, Homepage, Grafana, Prometheus, n8n a vlastné panely. Čítanie stavu a zdokumentované operácie: ovládanie VM, spustenie záloh, oznámenia a potvrdenie výstrah.",
"ogTitle": "API Proxmox Monitor — Príručka integrácií",
"ogDescription": "Koncové body ProxMenux Monitor pre Home Assistant, Homepage, Grafana, Prometheus, n8n a vlastné panely.",
"twitterTitle": "API monitora Proxmox | ProxMenux",
"twitterDescription": "Koncové body pre Home Assistant, Homepage, Grafana, Prometheus, n8n a vlastné panely."
},
"header": {
"title": "Referenčná príručka API",
"description": "Koncové body HTTP na čítanie stavu a zdokumentované akcie: senzory Home Assistant, karty Homepage, panely Grafana, zber Prometheus, toky n8n a vlastné skripty. Obsahuje kategórie, exportované metriky a príklady curl.",
"section": "ProxMenux Monitor"
},
"intro": {
"title": "Na čo je táto stránka",
"body": "Táto stránka uvádza koncové body integrácií: čítanie údajov, spustenie záloh, vlastné oznámenia a potvrdenie výstrah. API beží v procese Flask panela na TCP 8008. Adresu počúvania a TLS opisuje Prístup a overenie."
},
"headerEndpoint": "Koncový bod",
"headerMethod": "Metóda",
"headerUse": "Použitie",
"auth": {
"heading": "Prihlásenie",
"intro": "Pri zapnutom overovaní chránené koncové body očakávajú JWT Bearer token v hlavičke požiadavky:",
"tokensIntro": "Dva spôsoby získania tokenu:",
"items": [
"Tokeny API, odporúčané pre integrácie. Platia 365 dní a vytvárajú sa v Zabezpečenie → Tokeny API. Majú názov a možno ich jednotlivo odvolať. Na údaje použite read_only, full_admin iba na potrebné správcovské akcie.",
"Prihlásenie, JWT na 24 hodín. POST /api/auth/login s menom, heslom a TOTP, ak ho vyžaduje 2FA. JWT vyprší po 24 hodinách; skripty sa potom musia prihlásiť znova."
],
"flowLink": "Prihlásenie, heslá, 2FA, audit a TLS opisuje Prístup a overenie.",
"rows": [
{
"endpoint": "/api/auth/login",
"method": "POST",
"use": "Polia tela (schéma): '{'\"username\",\"password\",\"totp_token?\"'}'. Vráti JWT na 24 hodín."
},
{
"endpoint": "/api/auth/api-tokens",
"method": "GET",
"use": "Uveďte API tokeny (iba metadáta — mená, predpony, dátumy; nikdy nie skutočný tajný kód)."
},
{
"endpoint": "/api/auth/generate-api-token",
"method": "POST",
"use": "Vytvorí token API na 365 dní v overenej relácii. Polia: password, token_name?, totp_token?, scope?. Heslo a požadované TOTP sa overia znova. scope je predvolene read_only; full_admin treba zvoliť výslovne. Tajný token sa vráti iba raz."
},
{
"endpoint": "/api/auth/api-tokens/",
"method": "DELETE",
"use": "Zrušte špecifický API token jeho ID."
}
]
},
"conventions": {
"heading": "Konvencie",
"items": [
"Väčšina používa JSON. Niektoré sťahovania vracajú obyčajný text; /api/prometheus používa textový formát Prometheus 0.0.4 namiesto OpenMetrics. Overte typ odpovede konkrétnej cesty.",
"Mnohé zápisy vracajú '{'\"success\": true, ...'}'. Chyby sa líšia; bežný formát je '{'\"success\": false, \"error\": \"'<'reason'>'\"'}'. Kontrolujte stav HTTP aj polia: niektoré výzvy overenia používajú HTTP 200 so success false.",
"Parametre závisia od koncového bodu. limit, offset, since a filtre kategórií použite iba tam, kde sú podporované.",
"Časové formáty sa líšia: Unix čas, reťazce ISO-8601 aj dátumy systemd. Nepredpokladajte rovnakú jednotku ani výslovné časové pásmo vo všetkých poliach."
]
},
"system": {
"heading": "Systém a hardvér",
"rows": [
{
"endpoint": "/api/system",
"method": "GET",
"use": "Aktuálne hodnoty CPU, pamäte, swapu, času prevádzky a záťaže."
},
{
"endpoint": "/api/info",
"method": "GET",
"use": "Statické informácie o hostiteľovi: meno hostiteľa, jadro, verzia PVE, model CPU, distro."
},
{
"endpoint": "/api/system-info",
"method": "GET",
"use": "Rozšírené systémové údaje pre hlavičku panela: celkové metriky a čas spustenia."
},
{
"endpoint": "/api/hardware",
"method": "GET",
"use": "Podrobný hardvérový inventár: zariadenia PCI, GPU a senzory."
},
{
"endpoint": "/api/hardware/live",
"method": "GET",
"use": "Aktuálne hodnoty rýchlo sa meniacich senzorov."
},
{
"endpoint": "/api/temperature/history",
"method": "GET",
"use": "Časové rady teplôt CPU a jeho puzdra."
},
{
"endpoint": "/api/gpu//realtime",
"method": "GET",
"use": "Aktuálne metriky GPU NVIDIA, Intel a AMD podľa pozície PCI."
}
]
},
"actions": {
"heading": "Systémové akcie",
"intro": "Tieto asynchrónne systémové akcie používajú dočasné jednotky systemd. Pri zapnutom overovaní ich zápisy vyžadujú full_admin; read_only môže čítať .../status. Prijatý štart vráti HTTP 202 a stav; priebeh sledujte cez .../status. Ovládanie hostí a zálohy majú iné odpovede, opísané nižšie.",
"shapeTitle": "Tvar bežnej odozvy",
"shapeIntro": "Asynchrónne systémové akcie používajú tento objekt stavu JSON. Ovládanie hostí a zálohy majú iné formáty:",
"shapeCode": "{\n \"unit\": \"proxmenux-action-pve-update.service\",\n \"state\": \"idle | running | success | failed | cancelled\",\n \"started_at\": \"Sat 2026-08-01 11:01:32 CEST\",\n \"finished_at\": null,\n \"exit_code\": null,\n \"result\": null\n}",
"concurrencyTitle": "Súbežnosť a zrušenie",
"concurrencyBody": "Ďalší štart tej istej aktívnej akcie vráti HTTP 409. Zrušenie je možné iba s dokumentovanou cestou DELETE, napríklad pri aktualizácii PVE. Stav prejde na cancelled a časy zostanú. Konečné stavy sú v pamäti procesu a po reštarte Monitora sa môžu stratiť.",
"rows": [
{
"endpoint": "/api/system/power/reboot",
"method": "POST",
"use": "Spustí reštart hostiteľa Proxmox. Spojenie HTTP sa môže prerušiť, keď systemd začne vypínanie."
},
{
"endpoint": "/api/system/power/reboot/status",
"method": "GET",
"use": "Stav aktuálneho alebo posledného reštartu."
},
{
"endpoint": "/api/system/power/shutdown",
"method": "POST",
"use": "Vypne hostiteľa Proxmox, napríklad po signáli na vypnutie z UPS."
},
{
"endpoint": "/api/system/power/shutdown/status",
"method": "GET",
"use": "Stav aktuálneho alebo posledného vypínania."
},
{
"endpoint": "/api/system/pve-update/run",
"method": "POST",
"use": "Spustí aktualizáciu PVE používanú voľbou Aktualizovať teraz v Health Monitor aj ponukou shellu; odovzdá ju update-pve-safe.sh."
},
{
"endpoint": "/api/system/pve-update/status",
"method": "GET",
"use": "Stav aktuálnej alebo poslednej aktualizácie PVE."
},
{
"endpoint": "/api/system/pve-update",
"method": "DELETE",
"use": "Zruší prebiehajúcu aktualizáciu PVE signálom SIGTERM."
},
{
"endpoint": "/api/proxmenux/self-update/run",
"method": "POST",
"use": "Aktualizuje ProxMenux inštalátorom nastaveného stabilného alebo beta kanála. Vlastná jednotka systemd umožní pokračovať počas reštartu proxmenux-monitor vykonaného inštalátorom."
},
{
"endpoint": "/api/proxmenux/self-update/status",
"method": "GET",
"use": "Stav aktuálnej alebo poslednej aktualizácie ProxMenux."
},
{
"endpoint": "/api/vms//control",
"method": "POST",
"use": "Odošle ovládací príkaz VM alebo LXC. Pole action prijíma start, stop, shutdown alebo reboot. Úspešná odpoveď vracia potvrdenú úlohu PVE, nie potvrdenie dokončenia. Výsledok sledujte cez koncový bod control-task hosťa."
},
{
"endpoint": "/api/vms//backup",
"method": "POST",
"use": "Vytvorí zálohu vzdump VM alebo LXC. Polia tela, všetky voliteľné, ak predvolené hodnoty zodpovedajú rozloženiu úložiska: storage (úložisko PVE), mode (snapshot, suspend alebo stop), compress (zstd, lzo, gzip alebo none), protected (true alebo false), notes a pbs_change_detection (default, legacy alebo data). Vráti UPID úlohy PVE."
},
{
"endpoint": "/api/vms//backups",
"method": "GET",
"use": "Zoznam predchádzajúcich záloh pre VM alebo LXC vo všetkých dosiahnuteľných úložiskách."
}
],
"syncVsAsyncTitle": "Dva typy akcií",
"syncVsAsyncBody": "Napájanie a aktualizácie hostiteľa používajú dočasné jednotky systemd s .../status. Iba aktualizácia PVE tu má cestu DELETE na zrušenie. Ovládanie VM/LXC vráti úlohu na sledovanie; záloha UPID úlohy na pozadí. Prijatie neznamená dokončenie. Overovanie a oprávnenia závisia od cesty.",
"curlTitle": "Príklad curl",
"curlBody": "Spustí aktualizáciu PVE a sleduje ju do dokončenia, ako automatizácia Home Assistant či playbook Ansible.",
"curlCode": "TOKEN=\n\ncurl -sSf -X POST \\\n -H \"Authorization: Bearer $TOKEN\" \\\n https://:8008/api/system/pve-update/run\n\nwhile true; do\n state=$(curl -sSf -H \"Authorization: Bearer $TOKEN\" \\\n https://:8008/api/system/pve-update/status | jq -r .state)\n [ \"$state\" != \"running\" ] && break\n sleep 30\ndone\necho \"final state: $state\"",
"haTitle": "Príklad pre Home Assistant",
"haBody": "Senzor rest zisťuje stav a rest_command spustí aktualizáciu. Priraďte ich k tlačidlu panela a potrebným automatizáciám:",
"haCode": "# configuration.yaml\nsensor:\n - platform: rest\n resource: https://pve.local:8008/api/system/pve-update/status\n name: pve_update_state\n value_template: \"{{ value_json.state }}\"\n scan_interval: 60\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"\n\nrest_command:\n pve_update:\n url: https://pve.local:8008/api/system/pve-update/run\n method: POST\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"\n\n # Start VM 100 (works for LXC too — same endpoint)\n vm_100_start:\n url: https://pve.local:8008/api/vms/100/control\n method: POST\n content_type: 'application/json'\n payload: '{\"action\": \"start\"}'\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"\n\n # Backup VM 100 to the 'pbs-main' storage\n vm_100_backup:\n url: https://pve.local:8008/api/vms/100/backup\n method: POST\n content_type: 'application/json'\n payload: '{\"storage\": \"pbs-main\", \"mode\": \"snapshot\", \"compress\": \"zstd\"}'\n headers:\n Authorization: \"Bearer !secret proxmenux_token\""
},
"health": {
"heading": "Monitor zdravia",
"rows": [
{
"endpoint": "/api/health",
"method": "GET",
"use": "Ľahká kontrola vracajúca JSON s status, timestamp a version. Vhodná na kontrolu kľúčových slov Uptime Kuma; pri zapnutom overovaní klient posiela hlavičku Bearer."
},
{
"endpoint": "/api/health/status",
"method": "GET",
"use": "Celkový stav: úroveň závažnosti a zhrnutie."
},
{
"endpoint": "/api/health/details",
"method": "GET",
"use": "Všetkých desať kategórií so stavom a štruktúrovanými údajmi jednotlivých kontrol."
},
{
"endpoint": "/api/health/full",
"method": "GET",
"use": "Úplné údaje: kategórie, aktívne chyby, potlačené výstrahy a nastavenia potlačenia. Používa výsledky na pozadí mladšie než šesť minút; inak alebo pri vynútenej obnove spustí novú kontrolu."
},
{
"endpoint": "/api/health/active-errors",
"method": "GET",
"use": "Aktívny zoznam, filtrovateľný ?category=<name>."
},
{
"endpoint": "/api/health/dismissed",
"method": "GET",
"use": "Potlačené výstrahy so zostávajúcimi hodinami stíšenia."
},
{
"endpoint": "/api/health/settings",
"method": "GET",
"use": "Nastavené trvanie potlačenia pre každú kategóriu."
},
{
"endpoint": "/api/health/remote-storages",
"method": "GET",
"use": "Inventár vzdialených úložísk definovaných Proxmoxom s online stavom."
},
{
"endpoint": "/api/health/interfaces",
"method": "GET",
"use": "Sieťové rozhrania s typom (most / agregácia / fyzické), IP a rýchlosťou spojenia."
},
{
"endpoint": "/api/health/acknowledge",
"method": "POST",
"use": "Telo: '{'\"error_key\":\"smart_sdh\"'}'. Potlačí výstrahu na čas nastavený pre jej kategóriu."
},
{
"endpoint": "/api/health/cleanup-orphans",
"method": "POST",
"use": "Ručne vyčistí chyby odstránených zariadení alebo VM. Opakované spustenie je neškodné."
}
],
"outro": "Formáty odpovedí a kategórie opisuje Health Monitor."
},
"storage": {
"heading": "Úložisko",
"rows": [
{
"endpoint": "/api/storage",
"method": "GET",
"use": "Disky viditeľné pre hostiteľa: blokové zariadenia, fondy ZFS a LVM."
},
{
"endpoint": "/api/storage/summary",
"method": "GET",
"use": "Kompaktné zhrnutie pre karty panela."
},
{
"endpoint": "/api/proxmox-storage",
"method": "GET",
"use": "Proxmox-definované úložiská z /etc/pve/storage.cfg s online stavom a voľným priestorom."
},
{
"endpoint": "/api/storage/observations",
"method": "GET",
"use": "Trvalá história pozorovaní: výstrahy SMART, chyby I/O a udalosti ZFS. Zachová sa aj po automatickom vyriešení výstrahy."
},
{
"endpoint": "/api/storage/smart/",
"method": "GET",
"use": "Aktuálne atribúty SMART pre jeden disk."
},
{
"endpoint": "/api/storage/smart//latest",
"method": "GET",
"use": "Posledný autotest SMART pre disk."
},
{
"endpoint": "/api/storage/smart//history",
"method": "GET",
"use": "Zoznam uložených správ SMART pre disk."
},
{
"endpoint": "/api/storage/smart//history/",
"method": "GET",
"use": "Prečítajte si konkrétny uložený SMART report."
},
{
"endpoint": "/api/storage/smart//test",
"method": "POST",
"use": "Spustí autotest SMART. Schéma tela: '{'\"test_type\":\"short\"|\"long\"'}'."
},
{
"endpoint": "/api/storage/smart/schedules",
"method": "GET",
"use": "Zoznam aktuálne naplánovaných testov SMART."
},
{
"endpoint": "/api/storage/smart/tools",
"method": "GET",
"use": "Overí, či sú nainštalované smartctl a súvisiace nástroje."
}
]
},
"network": {
"heading": "Sieť",
"rows": [
{
"endpoint": "/api/network",
"method": "GET",
"use": "Všetky rozhrania so stavom spojenia a adresami."
},
{
"endpoint": "/api/network/summary",
"method": "GET",
"use": "Kompaktný prehľad pre panel."
},
{
"endpoint": "/api/network//metrics",
"method": "GET",
"use": "RX/TX pre každé rozhranie, počítadlá chýb a časové rady RRD."
},
{
"endpoint": "/api/network/latency/current",
"method": "GET",
"use": "Posledné meranie latencie k bráne."
},
{
"endpoint": "/api/network/latency/history",
"method": "GET",
"use": "Časový rad latencie brány."
}
]
},
"vms": {
"heading": "VM a kontajnery",
"rows": [
{
"endpoint": "/api/vms",
"method": "GET",
"use": "VM a CT na lokálnom uzle so stavom, vmid a názvom."
},
{
"endpoint": "/api/vms/",
"method": "GET",
"use": "Celý detail pre jedného hosťa (config, sieť, disky)."
},
{
"endpoint": "/api/vms//metrics",
"method": "GET",
"use": "CPU / pamäť / disk I/O časový rad pre jedného hosťa (RRD)."
},
{
"endpoint": "/api/vms//logs",
"method": "GET",
"use": "Protokoly nedávnych úloh tohto hosťa."
},
{
"endpoint": "/api/vms//backups",
"method": "GET",
"use": "Zálohy uložené pre tohto hosťa."
},
{
"endpoint": "/api/vms//control",
"method": "POST",
"use": "Vyberte jednu akciu zo schémy: '{'\"action\":\"start|stop|reboot|shutdown\"'}'. Ovláda napájanie hosťa."
},
{
"endpoint": "/api/vms//backup",
"method": "POST",
"use": "Spustí vzdump pre hosťa. Telo určuje úložisko a režim (snapshot / suspend / stop)."
},
{
"endpoint": "/api/vms//config",
"method": "PUT",
"use": "Upraví pole popisu (poznámky) VM alebo CT. Ostatné konfiguračné kľúče tento koncový bod nemení."
},
{
"endpoint": "/api/node/metrics",
"method": "GET",
"use": "Súhrnné metriky uzla v časových radoch RRD."
}
]
},
"backups": {
"heading": "Zálohy",
"rows": [
{
"endpoint": "/api/backups",
"method": "GET",
"use": "Zálohy nájdené na úložiskách dir, NFS, CIFS a PBS zisťovaných cez lokálny uzol. Nejde o úplnú kontrolu všetkých uzlov klastra."
},
{
"endpoint": "/api/backup-storages",
"method": "GET",
"use": "Úložiská označené ako ciele záloh s voľným miestom."
}
]
},
"logs": {
"heading": "Logy, úlohy, udalosti",
"rows": [
{
"endpoint": "/api/logs",
"method": "GET",
"use": "Filtrované záznamy systémového denníka. Parametre: ?level=&service=&limit=."
},
{
"endpoint": "/api/logs/download",
"method": "GET",
"use": "Exportuje filtrovaný rozsah ako obyčajný text."
},
{
"endpoint": "/api/events",
"method": "GET",
"use": "Interný tok udalostí používaný aj na oznámenia."
},
{
"endpoint": "/api/task-log/",
"method": "GET",
"use": "Úplný protokol úlohy Proxmox v obyčajnom texte podľa UPID."
}
]
},
"notifications": {
"heading": "Oznámenia a AI",
"intro": "Odosielanie, kanály a preformulovanie AI opisujú Oznámenia a Asistent AI.",
"rows": [
{
"endpoint": "/api/notifications",
"method": "GET",
"use": "Nedávne oznámenia zobrazené na paneli."
},
{
"endpoint": "/api/notifications/download",
"method": "GET",
"use": "Exportuje oznámenia ako text."
},
{
"endpoint": "/api/notifications/status",
"method": "GET",
"use": "Stav odosielania: aktívny proces na pozadí, dĺžka radu a posledné odoslanie."
},
{
"endpoint": "/api/notifications/settings",
"method": "GET",
"use": "Číta nastavenia oznámení: kanály, prepínače udalostí, preformulovanie AI a zobrazované meno."
},
{
"endpoint": "/api/notifications/history",
"method": "GET",
"use": "História odosielania. Parametre: ?limit=&offset=&severity=&channel=."
},
{
"endpoint": "/api/notifications/history",
"method": "DELETE",
"use": "Vyprázdni tabuľku histórie odosielania."
},
{
"endpoint": "/api/notifications/test",
"method": "POST",
"use": "Odošle skúšobné oznámenie do kanála. Telo: '{'\"channel\":\"telegram\"'}'."
},
{
"endpoint": "/api/notifications/send",
"method": "POST",
"use": "Vytvorí vlastnú udalosť. Telo: '{'\"event_type\":\"custom\",\"severity\":\"WARNING\",\"title\":\"...\",\"body\":\"...\",\"data\":'{''}''}'."
},
{
"endpoint": "/api/notifications/test-ai",
"method": "POST",
"use": "Overí spojenie s poskytovateľom AI. Polia tela (schéma): '{'\"provider\",\"api_key\",\"model\",\"ollama_url?\"'}'."
},
{
"endpoint": "/api/notifications/provider-models",
"method": "POST",
"use": "Zoznam dostupných modelov pre vybraného poskytovateľa AI."
},
{
"endpoint": "/api/notifications/proxmox/setup-webhook",
"method": "POST",
"use": "Zaregistrujte monitor ako cieľ webhook v /etc/pve/notifications.cfg."
},
{
"endpoint": "/api/notifications/proxmox/cleanup-webhook",
"method": "POST",
"use": "Odstráni cieľ Monitora z konfigurácie oznámení PVE."
},
{
"endpoint": "/api/notifications/proxmox/read-cfg",
"method": "GET",
"use": "Prečítajte si aktuálne PVE notifications.cfg ako to vidí PVE."
}
]
},
"security": {
"heading": "Bezpečnosť (čítanie)",
"rows": [
{
"endpoint": "/api/security/firewall/status",
"method": "GET",
"use": "Stav firewallu PVE a aktívne pravidlá."
},
{
"endpoint": "/api/security/fail2ban/details",
"method": "GET",
"use": "Stav jailu Fail2Ban; vyžaduje nainštalovaný voliteľný komponent."
},
{
"endpoint": "/api/security/fail2ban/activity",
"method": "GET",
"use": "Nedávne udalosti Fail2Ban: blokovania, odblokovania a spustenia jailu."
},
{
"endpoint": "/api/security/lynis/status",
"method": "GET",
"use": "Stav Lynis: inštalácia a čas poslednej kontroly."
},
{
"endpoint": "/api/security/lynis/report",
"method": "GET",
"use": "Posledná správa Lynis: výstrahy, návrhy a index zabezpečenia."
},
{
"endpoint": "/api/security/tools",
"method": "GET",
"use": "Detekovať, ktoré voliteľné bezpečnostné nástroje (Fail2Ban, Lynis) sú nainštalované."
}
]
},
"proxmenuxIntegration": {
"heading": "Integrácia ProxMenux",
"rows": [
{
"endpoint": "/api/proxmenux/update-status",
"method": "GET",
"use": "Dostupnosť aktualizácie ProxMenux Monitor, nainštalovaná a najnovšia verzia."
},
{
"endpoint": "/api/proxmenux/installed-tools",
"method": "GET",
"use": "Zoznam optimalizácií ProxMenux po inštalácii zaznamenaných na hostiteľovi (z /usr/local/share/proxmenux/installed_tools.json)."
},
{
"endpoint": "/api/proxmenux/tool-source/",
"method": "GET",
"use": "Kód priradenej funkcie po inštalácii z aktuálnych skriptov hostiteľa alebo zachovaného staršieho kódu. Nezaručuje presnú snímku pôvodne spusteného kódu."
}
]
},
"prometheus": {
"heading": "Metriky Prometheus",
"intro": "Overený koncový bod GET /api/prometheus vracia textový formát Prometheus 0.0.4. Každá metrika obsahuje node=\"<hostname>\" a časovú pečiatku. Zber zabezpečí Prometheus alebo kompatibilná databáza časových radov.",
"exportedTitle": "Exportované metriky",
"headerGroup": "Skupina",
"headerMetric": "Metrika",
"headerDesc": "Popis",
"groups": [
{
"group": "Systém",
"metrics": [
{
"metric": "proxmox_cpu_usage",
"desc": "Percento využitia CPU, metrika typu gauge."
},
{
"metric": "proxmox_memory_total_bytes",
"desc": "Úplná fyzická pamäť v bajtoch."
},
{
"metric": "proxmox_memory_used_bytes",
"desc": "Použitá pamäť v bajtoch."
},
{
"metric": "proxmox_memory_usage_percent",
"desc": "Percento využitia pamäte."
},
{
"metric": "proxmox_load_average",
"desc": "Priemerná systémová záťaž. Štítok period=\"1m\" | \"5m\" | \"15m\"."
}
]
},
{
"group": "Čas prevádzky",
"metrics": [
{
"metric": "proxmox_uptime_seconds",
"desc": "Sekundy od posledného spustenia."
}
]
},
{
"group": "Hardvér",
"metrics": [
{
"metric": "proxmox_cpu_temperature_celsius",
"desc": "Teplota puzdra CPU."
},
{
"metric": "proxmox_disk_temperature_celsius",
"desc": "Teplota každého disku. Štítok disk."
},
{
"metric": "proxmox_fan_speed_rpm",
"desc": "Otáčky ventilátorov. Štítok fan."
}
]
},
{
"group": "Priestor na disku",
"metrics": [
{
"metric": "proxmox_disk_total_bytes",
"desc": "Celková kapacita každého exportovaného záznamu disku. Štítok disk."
},
{
"metric": "proxmox_disk_used_bytes",
"desc": "Použitá kapacita každého exportovaného záznamu disku."
},
{
"metric": "proxmox_disk_usage_percent",
"desc": "Percento použitej kapacity každého exportovaného záznamu disku."
}
]
},
{
"group": "Sieť",
"metrics": [
{
"metric": "proxmox_network_bytes_sent_total",
"desc": "Celkový počet odoslaných bajtov, metrika typu counter."
},
{
"metric": "proxmox_network_bytes_received_total",
"desc": "Celkový počet prijatých bajtov, metrika typu counter."
},
{
"metric": "proxmox_interface_bytes_sent_total",
"desc": "Bajty odoslané cez každé rozhranie. Štítok interface."
},
{
"metric": "proxmox_interface_bytes_received_total",
"desc": "Bajty prijaté cez každé rozhranie."
}
]
},
{
"group": "VMs / CTs",
"metrics": [
{
"metric": "proxmox_vms_total",
"desc": "Celkový počet VM a LXC."
},
{
"metric": "proxmox_vms_running",
"desc": "Počet spustených hostí."
},
{
"metric": "proxmox_vms_stopped",
"desc": "Počet zastavených hostí."
},
{
"metric": "proxmox_vm_status",
"desc": "Stav VM/CT: 1 spustený, 0 iný stav. Štítky node, vmid a name."
},
{
"metric": "proxmox_vm_cpu_usage",
"desc": "Využitie CPU pre každú VM/CT s rovnakými štítkami."
},
{
"metric": "proxmox_vm_memory_used_bytes / _max_bytes",
"desc": "Použitá pamäť a nastavené maximum každej VM/CT."
}
]
},
{
"group": "GPU",
"metrics": [
{
"metric": "proxmox_gpu_temperature_celsius",
"desc": "Teplota GPU. Štítky slot a vendor; gpu obsahuje aj názov GPU."
},
{
"metric": "proxmox_gpu_utilization_percent",
"desc": "Percento využitia GPU."
},
{
"metric": "proxmox_gpu_memory_total_bytes",
"desc": "Celková pamäť GPU."
},
{
"metric": "proxmox_gpu_power_draw_watts",
"desc": "Príkon GPU vo wattoch."
},
{
"metric": "proxmox_gpu_clock_speed_mhz",
"desc": "Takt jadra GPU."
},
{
"metric": "proxmox_gpu_memory_clock_mhz",
"desc": "Takt pamäte GPU."
}
]
},
{
"group": "UPS",
"metrics": [
{
"metric": "proxmox_ups_battery_charge_percent",
"desc": "Percento nabitia batérie."
},
{
"metric": "proxmox_ups_load_percent",
"desc": "Aktuálne zaťaženie UPS."
},
{
"metric": "proxmox_ups_runtime_seconds",
"desc": "Odhadovaná výdrž na batériu."
},
{
"metric": "proxmox_ups_input_voltage_volts",
"desc": "Vstupné napätie."
}
]
}
],
"scrapeTitle": "Konfigurácia zberu Prometheus",
"scrapeIntro": "Pri zapnutom overovaní zadajte token API do hlavičky Bearer v konfigurácii zberu Prometheus:",
"perHostTitle": "Zber pre každého hostiteľa",
"perHostBody": "Každá inštancia exportuje metriky svojho hostiteľa. V klastri nastavte Prometheus na zber z každého uzla. Štítok node rozlišuje rady v Grafane (proxmox_vms_running'{'node=\"pve01\"'}')."
},
"puttingItTogether": {
"heading": "Prepojenie integrácií",
"body": "Pozrite Integrácie na prepojenie koncových bodov so senzormi Home Assistant, kartami Homepage, panelmi Grafana, tokmi n8n a ďalšími nástrojmi. Obsahuje bežné konfigurácie na kopírovanie. Táto stránka uvádza katalóg koncových bodov."
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Prístup a overenie",
"href": "/docs/monitor/access-auth",
"tail": " — vytváranie tokenov, auditný protokol, voliteľný jail Fail2Ban a TLS."
},
{
"label": "Oznámenia",
"href": "/docs/monitor/notifications",
"tailRich": " — obsah data pre každú udalosť pri volaní /api/notifications/send."
},
{
"label": "AI asistent",
"href": "/docs/monitor/ai-assistant",
"tailRich": " — fungovanie /api/notifications/test-ai a /api/notifications/provider-models."
},
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tailRich": " — formát odpovedí /api/health/* a význam desiatich kategórií."
}
]
}
}