docs: review Monitor documentation in all seven translations

This commit is contained in:
Jonatan
2026-10-17 15:08:53 +02:00
parent ce1a3de719
commit dace78214a
209 changed files with 43788 additions and 1942 deletions
@@ -0,0 +1,174 @@
{
"meta": {
"title": "Panel Apps: jeden spúšťač pre všetky webové odkazy | ProxMenux",
"description": "Pomocou prístrojovej dosky Apps otvorte registrované LXC Webové odkazy a vlastné odkazy, zorganizujte ich podľa kategórie a skočte späť k hosťovi, ktorý vlastní každú službu."
},
"header": {
"title": "Panel: karta Apps",
"description": "Jediný spúšťač pre webové rozhrania, ktoré používate cez uzol, či už pochádzajú z registrovanej aplikácie LXC alebo z vlastného webového odkazu.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Spúšťač, nie inštalátor aplikácií",
"body": "Karta <strong>Apps</strong> neinštaluje softvér ani sama nevyhľadáva služby. Zoskupuje uložené odkazy do prehľadávateľnej mriežky. Odkazy LXC sa nastavujú na <appTabLink>karte App</appTabLink> hosťovského systému; vlastné odkazy zahŕňajú služby VM, reverzné proxy a externé panely."
},
"sources": {
"heading": "Čo sa objavuje v Apps",
"intro": "Každá spúšťateľná URL sa stáva vlastnou kartou. Zdroj určuje, kde je karta upravená, ale nie ako vyzerá počas bežného používania.",
"colSource": "Zdroj",
"colAppears": "Čo sa objaví",
"colManagedFrom": "Kde sa spravuje",
"rows": [
{
"source": "Registrovaná aplikácia LXC",
"appears": "Jedna karta pre každý Web Link uložený na zázname aplikácie.",
"managedFrom": "VM a LXC → Okno LXC → Aplikácia"
},
{
"source": "Vlastný odkaz viazaný na hosťa",
"appears": "URL služby spojená so špecifickým VM alebo LXC.",
"managedFrom": "Aplikácie → Upraviť"
},
{
"source": "Vlastný odkaz bez priradenia",
"appears": "Ľubovoľný cieľ HTTP(S) vrátane externej služby alebo služby za reverzným proxy.",
"managedFrom": "Aplikácie → Upraviť"
}
],
"relationshipTitle": "Aplikácie a karta LXC App majú rôzne úlohy",
"relationshipBody": "<appTabLink>Karta App</appTabLink> LXC spravuje identitu aplikácie, webové odkazy a voliteľné sledovanie verzií. Karta <strong>Apps</strong> používa tieto odkazy na rýchle otvorenie. Úprava karty LXC preto otvorí záznam hosťovského systému bez duplikovania konfigurácie."
},
"cards": {
"heading": "Ako používať kartu",
"intro": "Celá karta je cieľ štartu, zatiaľ čo jej menšie kontroly poskytujú kontext bez otvorenia služby.",
"items": [
"Kliknutím na kartu otvoríte jej URL na novej karte prehliadača.",
"Logo najprv používa logo Web Link a v prípade potreby sa vráti k logu aplikácie.",
"Čip kategórie používa rovnakú farbu a označenie ako zodpovedajúci webový odkaz v záložke LXC App.",
"Označenie hosťovského systému určuje priradenú VM alebo LXC. Kliknutie otvorí jeho okno: odkazy LXC otvoria <strong>App</strong>, odkazy VM <strong>Stav</strong>.",
"Fialová šípka hore znamená, že špecifická aplikácia alebo obraz Docker má k dispozícii aktualizáciu. Nie je to všeobecný počet aktualizácií pre celého hosťa."
]
},
"toolbar": {
"heading": "Hľadať, filtrovať a triediť",
"intro": "Nástrojová lišta zužuje veľkú kolekciu aplikácií bez zmeny uložených záznamov.",
"items": [
"Vyhľadávanie zodpovedá názvu aplikácie, menu hosťa, VMID a kategórii.",
"Filter kategórie zobrazuje jednu kategóriu naraz alebo všetky aplikácie.",
"Zoraďte podľa <strong>Názvu</strong>, <strong>ID</strong> alebo <strong>Kategórie</strong>. Triedenie podľa kategórie pridá nadpisy medzi skupiny kariet.",
"Poradie sa zapamätá v tomto prehliadači. Vyhľadávaný text a filter kategórie sa pri návrate na stránku obnovia.",
"Karta Apps zostáva k dispozícii, keď je mriežka prázdna, takže prvý vlastný odkaz môže byť pridaný bez registrácie aplikácie LXC ako prvý."
]
},
"customLinks": {
"heading": "Pridávanie a úprava vlastných webových odkazov",
"intro": "Použite vlastný odkaz, ak služba nie je reprezentovaná registrovanou aplikáciou LXC.",
"steps": [
"Vyberte <strong>Pridať odkaz</strong> na paneli nástrojov alebo v prázdnom zobrazení.",
"Zadajte meno a kompletnú <code>http://</code> alebo <code>https://</code> URL.",
"Voliteľne pridať logo, vybrať alebo vytvoriť kategóriu a pripojiť odkaz na VM alebo LXC.",
"Uložte odkaz. Jeho karta sa ihneď zobrazí v mriežke.",
"Ak chcete upraviť alebo odstrániť vlastný odkaz, vyberte <strong>Upraviť</strong> a ceruzku na karte."
],
"colField": "Pole",
"colRequired": "Požadované",
"colPurpose": "Účel",
"fields": [
{
"field": "Názov",
"required": "Áno",
"purpose": "Názov karty a hľadaný termín."
},
{
"field": "URL",
"required": "Áno",
"purpose": "Úplné miesto určenia HTTP (S) otvorené kartou."
},
{
"field": "URL loga",
"required": "Nie",
"purpose": "Diaľkový obrázok zobrazený na karte."
},
{
"field": "Kategória",
"required": "Nie",
"purpose": "Pridá zdieľaný odznak a umožňuje filtrovanie kategórií."
},
{
"field": "Priradenie hosťovského systému",
"required": "Nie",
"purpose": "Priradí odkaz k VM alebo LXC a umožní skratku k hosťovskému systému."
}
],
"editTitle": "Upraviť zdroj pravdy",
"editBody": "Režim úprav zobrazuje ceruzky iba pri vlastných odkazoch. Kartu aplikácie LXC upravíte na <appTabLink>karte App</appTabLink> hosťovského systému zmenou uloženého odkazu."
},
"categories": {
"heading": "Kategórie a signály aktualizácie",
"intro": "Kategórie usporadúvajú odkazy; indikátory aktualizácií opisujú stav softvéru. Sú zámerne oddelené.",
"items": [
"Registrácia LXC podporovaná katalógom môže predplniť kategóriu, ale zostáva editovateľná.",
"Vlastné názvy kategórií môžu byť vytvorené z rovnakého voliča a následne opätovne použité filtrom.",
"Farby kategórií sú deterministické a prispôsobujú sa svetlej alebo tmavej téme. Fialové a červené odtiene sú vyhradené pre aktualizácie a nebezpečné stavy.",
"Pri Docker odkazoch ProxMenux priradí kartu ku kontajneru alebo obrazu a zobrazí stav aktualizácie daného obrazu. Aktualizácie Docker Engine zostávajú na <updatesLink>karte Aktualizácie</updatesLink> LXC."
]
},
"persistence": {
"heading": "Ukladanie a správanie vyrovnávacej pamäte",
"intro": "Palubná doska je určená na otvorenie z už dostupných dát Monitor, a nie na preskenovanie každého hosťa.",
"items": [
"Vlastné odkazy sa atomicky ukladajú do <code>/etc/proxmenux/custom_links.json</code> a pri štarte Monitora načítajú do pamäte.",
"Registrované odkazy LXC zostávajú súčasťou uloženého záznamu monitora v ich aplikácii; prístrojová doska Apps ich nezdvojuje do vlastného súboru.",
"Vytvorenie, úprava alebo odstránenie vlastného odkazu ihneď obnoví zoznam v pamäti.",
"Predvoľba triedenia je miestna pre tento prehliadač a nesynchronizuje sa medzi zariadeniami ani používateľmi.",
"Pozícia aplikácií na najvyššej úrovni sa ovláda samostatne pomocou <settingsLink>Nastavenia → Poradie navigácie</settingsLink>."
]
},
"troubleshooting": {
"heading": "Bežné situácie",
"colProblem": "Situácia",
"colResolution": "Riešenie",
"rows": [
{
"problem": "Aplikácia LXC je registrovaná, ale nie je zobrazená žiadna karta",
"resolution": "Otvorte záložku App a pridajte aspoň jeden webový odkaz. Samotné sledovanie verzie nevytvára kartu spúšťača."
},
{
"problem": "URL alebo logo je nesprávne",
"resolution": "Upraviť vlastný odkaz v Apps, alebo upraviť webový odkaz vo vlastnej záložke LXC App."
},
{
"problem": "Chýba služba Docker",
"resolution": "Upraviť registrovanú aplikáciu Docker a uložiť webový port služby ako webový odkaz."
},
{
"problem": "Fialová šípka sa vzťahuje na nesprávnu aktualizáciu Docker",
"resolution": "Skontrolujte názov a opis webového odkazu, aby ich bolo možné priradiť k zamýšľanému kontajneru alebo obrazu."
},
{
"problem": "Apps sa otvára pred Prehľadom systému",
"resolution": "Prvá uložená položka v Nastavenia → Poradie navigácie sa stane úvodnou kartou. Obnovte predvolené poradie alebo presuňte Prehľad na prvé miesto."
}
]
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "LXC App záložka",
"href": "/docs/monitor/dashboard/vms-lxcs/app",
"tail": " — registrácia aplikácií, webových odkazov a voliteľného sledovania verzií."
},
{
"label": "Karta Aktualizácie LXC",
"href": "/docs/monitor/dashboard/vms-lxcs/updates",
"tail": " — nastavenie a spustenie aktualizácií aplikácií, Docker Engine a obrazov."
},
{
"label": "Karta Nastavenia",
"href": "/docs/monitor/dashboard/settings#navigation-order",
"tail": " — zmena poradia navigácie a úvodnej karty."
}
]
}
}
@@ -0,0 +1,248 @@
{
"meta": {
"title": "ProxMenux Monitor — Panel: Hardvér | Dokumentácia ProxMenux",
"description": "Na karte Hardvér je inventár fyzického počítača: CPU a základná doska, pamäťové moduly, teplotné senzory, GPU (s monitorovaním jednotlivých slotov v reálnom čase a inštalátorom ovládačov jedným kliknutím), Coral TPU akcelerátory, prehľad úložiska s kontrolou rýchlosti pripojenia, úplný zoznam zariadení PCI a USB, spotreba energie, jednotky PSU, ventilátory a stav UPS."
},
"header": {
"title": "Panel: Hardvér",
"description": "Fyzický stroj na jednej obrazovke: CPU a základná doska, každý pamäťový modul, teplotné snímače všetkých subsystémov, GPU so živým využitím a inštalátorom ovládačov, Coral TPU, každé zariadenie PCI a USB s ovládačom jadra, úplný inventár diskov s dohodnutými rýchlosťami spojenia, príkon, chladenie a UPS.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Postavený zo štandardných nástrojov",
"body": "Väčšina z tejto karty je spracovaná z <code>lscpu</code>, <code>dmidecode</code>, <code>lspci</code>, <code>lsusb</code>, <code>lsblk</code>, <code>smartctl</code>, <code>nvme</code>, <code>sensors</code>, <code>nvidia-smi</code>, <code>intel_gpu_top</code>, <code>amdgpu_top</code>, <code>ipmitool</code> a <code>upsc</code>. Sekcie vykresľujú iba vtedy, keď príslušný nástroj vráti dáta, takže hostiteľ bez UPS neukáže kartu UPS a hostiteľ bez IPMI neukáže údaje o výkone mimo pásma."
},
"thresholds": {
"title": "Farby stavu a prahové hodnoty, ktoré sa tu uplatňujú",
"intro": "Každý indikátor a údaj teploty používa rovnakú škálu: <green/> <strong>zelená</strong> pod prahom Upozornenie, <amber/> <strong>jantárová</strong> medzi Upozornenie a Kritické, <red/> <strong>červená</strong> od prahu Kritické vyššie. Odporúčané predvolené hodnoty ProxMenux:",
"items": [
"<strong>Teplota CPU</strong> — upozornenie 80 °C, kritické 90 °C.",
"<strong>Teplota disku</strong> HDD 60/65 °C · SSD 70/75 °C · NVMe 80/85 °C · SAS 55/65 °C (varovanie/kritické)."
],
"outro": "Hodnoty možno nastaviť pre každého hostiteľa. <link>Nastavenia → Prahy monitora stavu</link> sú hlavný zdroj a vysvetľujú ich úpravu."
},
"sections": {
"heading": "Časti",
"intro": "Sekcie sa zobrazujú zhora nadol v tomto poradí. Niektoré vyžadujú príslušný hardvér alebo nástroj a sú označené ako <em>(podmienené)</em>.",
"systemInfoTitle": "Informácie o systéme",
"systemInfoIntro": "Dva bloky vedľa seba, vždy prítomné:",
"systemInfoItems": [
"<strong>CPU</strong> — model, mikroarchitektúra, pätice/jadrá/vlákna, základná a boost frekvencia, príznaky virtualizácie (VT-x / AMD-V) a topológia cache.",
"<strong>Základná doska</strong> — výrobca, model, verzia a dátum BIOS, UUID SMBIOS. Pomáha nájsť správnu stránku výrobcu na stiahnutie firmvéru."
],
"memoryTitle": "Pamäťové moduly",
"memoryBody": "Jeden riadok na obsadený slot podľa <code>dmidecode</code>: označenie, kapacita modulu, typ (DDR4 / DDR5 / varianty ECC), nastavená a menovitá rýchlosť, výrobca, číslo dielu a sériové číslo. Prázdne sloty sú sivé, aby bolo vidieť možnosti rozšírenia.",
"thermalTitle": "Sledovanie teplôt",
"thermalIntro": "Sedem blokov s údajmi z <code>lm-sensors</code>, <code>sysfs</code> a čítačiek pre konkrétne nástroje. Snímače úložiska hwmon sú priradené k fyzickému blokovému zariadeniu, s modelom a cestou <code>/dev/...</code>. Blok sa skryje, ak kategória neobsahuje snímače.",
"thermalItems": [
"<strong>CPU</strong> — teploty puzdra procesora a jednotlivých jadier.",
"<strong>GPU</strong> — snímače samostatnej GPU cez <code>nvidia-smi</code> / <code>amdgpu_top</code> a Intel iGPU. Zahŕňa najteplejší bod a teplotu pamäťového prechodu, ak ich ovládač poskytuje.",
"<strong>NVME</strong> — zložená teplota radiča priradená ku konkrétnemu mennému priestoru NVMe.",
"<strong>HDD</strong> — hodnoty <code>drivetemp</code> pre rotačné blokové zariadenia.",
"<strong>SSD</strong> — hodnoty <code>drivetemp</code> pre nerotačné blokové zariadenia SATA/SAS.",
"<strong>PCI</strong> — senzory, ktoré sa javia ako zariadenia pripojené k PCI (HBA, sieťové karty s internými senzormi).",
"<strong>OTHER</strong> — čipset, VRM, senzory okolia, ktoré sa inde nehodia."
]
},
"graphics": {
"heading": "Grafické karty",
"intro": "Každý radič videa má kartu s výrobcom, modelom, typom (<em>Integrovaný</em> / <em>PCI</em> / BMC), adresou PCI (BDF), ovládačom jadra a modulmi. <strong>Prepnúť režim</strong> mení zdieľanie LXC s natívnym ovládačom na passthrough VM (<code>vfio-pci</code>) a späť. <link>Prepnúť režim GPU (VM ↔ LXC)</link> vysvetľuje zmeny na hostiteľovi.",
"vfioImageAlt": "Grafické karty: integrovaná Matrox G200EH priradená k mgag200, pripravená pre LXC, a NVIDIA Quadro P400 priradená k vfio-pci, pripravená pre passthrough VM",
"vfioImageCaption": "Dve GPU: čip BMC Matrox používa natívny ovládač a je pripravený pre LXC; NVIDIA Quadro P400 je priradená k <code>vfio-pci</code> a pripravená pre passthrough VM.",
"lxcImageAlt": "Grafické karty: Intel UHD Graphics iGPU s i915 a NVIDIA Quadro P1000 s nvidia, obe pripravené pre kontajnery LXC",
"lxcImageCaption": "Rovnaký uzol po vrátení karty NVIDIA k natívnemu ovládaču: obe GPU sú pripravené pre kontajnery LXC.",
"realtimeTitle": "Okno monitorovania v reálnom čase",
"realtimeBody": "Kliknutie otvorí monitorovanie GPU podľa slotu, ktoré každé tri sekundy zisťuje údaje nástrojom výrobcu. Ukazuje výrobcu, typ, slot PCI, ovládač, moduly jadra, využitie jednotiek (Render/3D, Video, Blitter, VideoEnhance), grafické a pamäťové frekvencie, teplotu, dostupnú spotrebu, VRAM a aktívne procesy s ich zaťažením jednotiek. Dáta z <code>/api/gpu/&lt;slot&gt;/realtime</code>.",
"toolsIntro": "Nástroj výrobcu používaný pre každú GPU:",
"headerVendor": "Výrobca",
"headerTool": "Nástroj",
"headerProject": "Projekt",
"tools": [
{
"vendor": "NVIDIA",
"tool": "nvidia-smi",
"projectLabel": "developer.nvidia.com",
"projectHref": "https://developer.nvidia.com/nvidia-system-management-interface"
},
{
"vendor": "Intel iGPU",
"tool": "intel_gpu_top (igt-gpu-tools)",
"projectLabel": "gitlab.freedesktop.org",
"projectHref": "https://gitlab.freedesktop.org/drm/igt-gpu-tools"
},
{
"vendor": "AMD",
"tool": "amdgpu_top",
"projectLabel": "github.com/Umio-Yasuno/amdgpu_top",
"projectHref": "https://github.com/Umio-Yasuno/amdgpu_top"
},
{
"vendor": "Matrox / ASPEED (BMC)",
"tool": "(iba zobrazovanie)",
"projectLabel": "Detekovaný a označený ako BMC; žiadny blok v reálnom čase."
}
],
"nvidiaImageAlt": "Monitorovanie NVIDIA Quadro P1000: výrobca NVIDIA, načítaný ovládač nvidia, grafická frekvencia 1.26 GHz, pamäťová 2.50 GHz, teplota 50 °C, všetky jednotky na 0 %, žiadne aktívne procesy, celková pamäť 4096 MiB",
"nvidiaImageCaption": "NVIDIA Quadro P1000 s proprietárnym ovládačom: frekvencie, teplota, ukazovatele využitia jednotiek a aktívne procesy.",
"intelImageAlt": "Monitorovanie Intel UHD Graphics iGPU s ovládačom i915: spotreba 11.31 W, zaťaženie video jednotky 1 % a proces ffmpeg s využitím 8 MB",
"intelImageCaption": "Intel iGPU s aktívnym <code>i915</code>. Tabuľka Aktívne procesy zobrazuje úlohu ffmpeg používajúcu video jednotku.",
"amdImageAlt": "Monitorovanie integrovanej GPU AMD Lucienne s amdgpu: využitie jednotiek 0 % a amdgpu_top ako aktívny proces",
"amdImageCaption": "AMD iGPU monitorovaná cez <code>amdgpu_top</code>. Samotný nástroj je aktívny proces, pretože získava živé údaje.",
"installTitle": "Inštalácia ovládača NVIDIA z okna",
"installBody": "Pri <code>nouveau</code>/<code>nvidiafb</code> bez proprietárneho ovládača NVIDIA nie sú dostupné frekvencie, spotreba ani zaťaženie procesov. Okno ponúkne <strong>Nainštalovať ovládače NVIDIA</strong> a spustí skript opísaný v <link>Inštalácia ovládačov NVIDIA na hostiteľovi</link>.",
"noDriverAlt": "Monitorovanie NVIDIA Quadro P620 s načítanými nvidiafb a nouveau, oznámením Rozšírené monitorovanie nie je dostupné a modrým tlačidlom Nainštalovať ovládače NVIDIA",
"noDriverCaption": "Proprietárny ovládač ešte nie je nainštalovaný: okno ponúka inštaláciu jedným kliknutím.",
"promptAlt": "Potvrdenie inštalácie ovládača NVIDIA s nájdenými GPU, kontajnermi LXC s passthrough NVIDIA a tlačidlami Áno/Zrušiť",
"promptCaption": "Súhrn pred inštaláciou: nájdené GPU, kontajnery LXC s passthrough NVIDIA a plánované kroky. Bez potvrdenia sa nič nemení.",
"successAlt": "Výstup terminálu zobrazujúci ovládač NVIDIA 580.105.08 nainštalovaný úspešne a nvidia-smi hlásijúci Quadro P620",
"successCaption": "Úspešná inštalácia: NVIDIA <code>.run</code> zostavený cez DKMS, služba perzistencie pripravená a <code>nvidia-smi</code> hlási GPU.",
"warningTitle": "Vyberte si verziu ovládača, ktorú GPU skutočne podporuje",
"warningBody": "Novšie vetvy NVIDIA ukončujú podporu starších rodín GPU, napríklad Maxwell alebo Kepler. Ak po inštalácii <code>nvidia-smi</code> hlási <em>\"No devices were found\"</em> alebo DKMS zlyhá, vetva nemusí GPU podporovať. Zopakujte inštaláciu so staršou vetvou, napríklad legacy 470.x pre Kepler. Kompatibilitu overte na <a>oficiálnej stránke vyhľadávania ovládačov</a>.",
"whereGoIntro": "Kam ísť odtiaľto:",
"whereGoItems": [
"<link1>Inštalácia ovládačov NVIDIA na hostiteľovi</link1> — úplný postup, matica kompatibility jadra, voliteľná oprava NVENC a prenos do LXC.",
"<link2>Prepnúť režim GPU (VM ↔ LXC)</link2> — čo robí ovládanie <em>Prepnúť režim</em> na karte.",
"<link3>Pridať GPU do VM (passthrough)</link3> a <link4>Pridať GPU do LXC</link4> — prvé priradenie neviazanej GPU."
]
},
"coral": {
"heading": "Coral TPU / AI akcelerátory",
"subHeading": "(podmienečné)",
"intro": "Zobrazí sa pri pripojenom Google Coral alebo inom AI akcelerátore. Okno zariadenia uvádza pripojenie (M.2 / mini-PCIe / USB), šírku PCIe, ID výrobcu/produktu, softvérovú podporu (<code>apex</code> v jadre pre PCIe, <code>libedgetpu</code> v používateľskom priestore pre USB), moduly (<code>gasket</code> + <code>apex</code>), uzly (<code>/dev/apex_*</code>), stav runtime Edge TPU, živú teplotu a výstražné prahy firmvéru.",
"imageAlt": "Podrobnosti Coral Edge TPU: pripojenie PCIe/M.2, 5.0 GT/s x1, ID 1ac1:089a, ovládač apex, načítané moduly gasket a apex, /dev/apex_0 prítomný, Edge TPU Runtime nenainštalovaný, 53.5 °C a hardvérové výstražné prahy",
"imageCaption": "Coral M.2 s načítanými modulmi jadra hostiteľa, prítomným uzlom zariadenia a dostupnými výstrahami teploty firmvéru. Indikátor runtime sa zmení na zelený po inštalácii zodpovedajúceho Edge TPU Runtime.",
"pathsIntro": "Dve možnosti inštalácie podľa vyhotovenia:",
"pathsItems": [
"<strong>M.2 / Mini-PCIe</strong> — hostiteľ potrebuje moduly jadra <code>gasket</code> + <code>apex</code> zostavené cez DKMS, aby sa pri štarte objavil uzol <code>/dev/apex_0</code>.",
"<strong>Akcelerátor USB</strong> — hostiteľ potrebuje iba runtime Edge TPU v používateľskom priestore (<code>libedgetpu1-std</code>) z repozitára APT spoločnosti Google."
],
"outro": "<installLink>Inštalovať Coral TPU na hostiteľa</installLink> rozpozná a spravuje oba varianty. Informácie a oficiálny runtime sú na <a>coral.ai/docs</a>. Potom priraďte zariadenie kontajneru cez <lxcLink>Pridať Coral TPU do LXC</lxcLink>."
},
"storage": {
"heading": "Súhrn úložiska",
"intro": "Všetky blokové zariadenia známe jadru, zoskupené podľa typu. Každý disk ukazuje názov (<code>sda</code>, <code>nvme0n1</code>, <code>zram0</code>…), typ (<em>SSD</em>, <em>HDD</em>, <em>NVMe SSD</em>), model a dohodnuté spojenie. Kliknutie otvorí model, sériové číslo, kapacitu, rozhranie a aktuálnu aj maximálnu rýchlosť spojenia.",
"imageAlt": "Súhrn úložiska s jedenástimi blokovými zariadeniami (SSD SATA, HDD SATA, SSD NVMe a zram), modelmi a rýchlosťami spojenia; dva NVMe ukazujú 3.0 x4 so zvýraznenou aktuálnou rýchlosťou",
"imageCaption": "Jedenásť zariadení na tomto uzle. SATA spojenia sa zobrazujú ako <em>SATA &lt;version&gt;, &lt;Gb/s&gt; (current: ...)</em>; NVMe ako <em>&lt;PCIe gen&gt; x&lt;width&gt;</em>.",
"nvmeBody": "Riadok NVMe porovnáva dohodnuté spojenie s podporovaným maximom. Pri rozdiele, napríklad Gen3 x4 SSD na <strong>3.0 x1</strong> v slote zapojenom jednou linkou, je aktuálna hodnota jantárová. Pomáha pri diagnostike pomalých diskov alebo zmenách liniek po aktualizácii BIOS.",
"nvmeModalAlt": "NVMe detail pohonu pre nvme0n1: NVMe typ SSD, kapacita 953.9 GB, súčasná rýchlosť spojenia 3.0 x1 zvýraznená v jantári, maximálna rýchlosť spojenia 3.0 x4, model WDC CL SN720, sériové číslo, rozhranie PCIe/NVMe",
"nvmeModalCaption": "Podrobnosti NVMe s obmedzeným spojením: disk podporuje x4, ale slot je zapojený x1.",
"outro": "Dáta SMART, samotesty, história a správa PDF sú v <storageLink>Panel: Úložisko</storageLink>. Rovnaké dáta používa <smartLink>Stav a testy SMART diskov</smartLink>. Dlhý test zo skriptu zapíše JSON zobrazený v Monitore v <em>Úložisko → História</em>."
},
"pci": {
"heading": "PCI zariadenia",
"intro": "Zariadenia PCI určené pomocou <strong>PCI BDF</strong> (Bus:Device.Function, napríklad <code>03:00.0</code>) a triedy (<em>Radič úložiska</em>, <em>Radič USB</em>, <em>Grafická karta</em>, <em>Sieťový radič</em>, <em>Zvukový radič</em>…). Každá karta zobrazuje výrobcu, názov a <strong>aktuálne priradený ovládač jadra</strong>, užitočné pri diagnostike passthrough, skupín IOMMU či nesprávneho ovládača.",
"imageAlt": "Pätnásť zariadení PCI podľa triedy: radiče úložiska ahci/nvme, USB, grafické karty (jedna s vfio-pci, druhá s natívnym ovládačom), sieť igb/tg3 a zvuk pri GPU odovzdanej VM",
"imageCaption": "Pätnásť zariadení na uzle. GPU aj pridružená zvuková funkcia sú priradené k <code>vfio-pci</code>, teda pripravené pre passthrough VM.",
"bdfTitle": "Čítanie BDF",
"bdfBody": "<code>03:00.0</code> znamená zbernicu PCI <code>03</code>, zariadenie <code>00</code>, funkciu <code>0</code>. Samostatné GPU zvyčajne používajú <code>.0</code> pre GPU a <code>.1</code> pre zvuk HDMI. Obe funkcie sa odovzdávajú VM spolu; preto <link>Prepnúť režim GPU</link> pri odchode z režimu VM vyčistí aj osamotené zvukové priradenia."
},
"usb": {
"heading": "USB zariadenia",
"intro": "Zariadenia USB s výrobcom a produktom, verziou USB, adresou <code>bus:device</code>, ID <code>vendor:product</code> a ovládačom jadra. Sú rozdelené podľa úlohy: <em>Komunikácia</em> (adaptéry Z-Wave / Zigbee), <em>UPS</em>, úložisko alebo HID. Zariadenia tak rozlíšite bez porovnávania ID.",
"imageAlt": "Zariadenia USB: Aeotec Z-Wave Z-Stick, koordinátor Zigbee ConBee II a UPS Ellipse ECO, s verziou USB, adresou, ID vendor:product a priradeným ovládačom",
"imageCaption": "Tri zariadenia USB: dva adaptéry domácej automatizácie cez <code>usbfs</code> a UPS cez <code>usbfs</code>, s ktorým NUT komunikuje cez libusb."
},
"power": {
"heading": "Spotreba energie",
"subHeading": "(podmienečné)",
"intro": "Zobrazí sa, ak hostiteľ poskytuje telemetriu príkonu. Podľa dostupnosti ukazuje dva nezávislé zdroje:",
"items": [
"<strong>Celkový príkon ACPI / IPMI</strong> — príkon celého systému zo snímača základnej dosky alebo BMC. Typické pre serverové dosky.",
"<strong>Príkon puzdra CPU</strong> — počítadlá Intel RAPL alebo ekvivalent AMD. Odlišuje príkon CPU od zvyšku systému na bežných doskách bez celkového snímača."
],
"supplyImageAlt": "Spotreba: 198 W celkovo cez ACPI a dva zdroje so stavom OK a výstupom 185 W a 5 W",
"supplyImageCaption": "Serverová doska s jedným snímačom ACPI a dvoma zdrojmi cez IPMI: druhý je redundantný, v pokoji na 5 W.",
"cpuImageAlt": "Spotreba na bežnej doske: iba príkon CPU 8.7 W cez Intel RAPL",
"cpuImageCaption": "Bežná doska bez celkového snímača: ukazuje iba príkon CPU cez RAPL."
},
"psu": {
"heading": "Napájacie zdroje",
"subHeading": "(podmienečné)",
"body": "Na serverových strojoch s dvojitými zdrojmi ukazuje IPMI prítomnosť (PSU 1 / PSU 2 / …), vstupné napätie, výstupný výkon a stav OK/zlyhanie. Skontrolujte po výpadku napájania na uzle s redundantnými zdrojmi."
},
"fans": {
"heading": "Ventilátory systému",
"subHeading": "(podmienečné)",
"body": "Otáčky každého ventilátora v RPM s minigrafom, ak je podporovaný. Bez jednotlivých údajov ukáže jednu hodnotu ventilátora skrinky."
},
"ups": {
"heading": "Stav UPS",
"subHeading": "(podmienečné)",
"body": "Zobrazí sa pri nastavenom a dostupnom serveri NUT (Network UPS Tools). Ukazuje stav (sieť / batéria / nabíjanie / slabá batéria), nabitie batérie, odhad výdrže, percento zaťaženia, vstupné napätie, model a firmvér. Rovnaké údaje používa <em>Bezpečnosť a certifikáty</em> monitora stavu; prechod na batériu sa hneď zobrazí."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerSection": "Sekcia karty",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"section": "Statický inventár (PCI, CPU, BIOS)",
"endpoint": "/api/hardware",
"source": "<code>lspci -vmm</code>, <code>/proc/cpuinfo</code>, <code>dmidecode</code>; vyrovnávacia pamäť počas životnosti procesu."
},
{
"section": "Hodnoty živých snímačov",
"endpoint": "/api/hardware/live",
"source": "<code>sensors</code> (lm-sensors), <code>/sys/class/hwmon</code> a <code>/sys/block</code> identifikujú úložné zariadenia. Teploty zostávajú živé; iba mapovanie hwmon na zariadenia sa uchováva v pamäti 60 sekúnd."
},
{
"section": "História teploty CPU",
"endpoint": "/api/temperature/history",
"source": "Časový rad zaznamenávaný každých 60 sekúnd zberačom teploty a uložený v SQLite."
},
{
"section": "Živé metriky GPU",
"endpoint": "/api/gpu/<slot>/realtime",
"source": "NVIDIA: <code>nvidia-smi --query-gpu=...</code>. Intel: <code>intel_gpu_top</code>. AMD: sysfs <code>/sys/class/drm/cardN</code>."
}
],
"codeComment1": "# Porovnať inventár s pohľadom operačného systému",
"codeComment2": "# Potvrďte kartu GPU ktorú prístrojová doska vidí"
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Nainštalovať ovládače NVIDIA (host)",
"href": "/docs/hardware/nvidia-host",
"tail": " — skript spustený inštalačným tlačidlom v okne GPU."
},
{
"label": "Prepnúť režim GPU (VM ↔ LXC)",
"href": "/docs/hardware/switch-gpu-mode",
"tail": " — zmeny na hostiteľovi po prepnutí režimu na karte GPU."
},
{
"label": "Inštalovať Coral TPU na hostiteľa",
"href": "/docs/hardware/install-coral-tpu-host",
"tail": " — inštalácia modulu jadra a runtime Coral."
},
{
"label": "SMART Zdravie a test disku",
"href": "/docs/disk-manager/smart-disk-test",
"tail": " — skript poskytujúci dáta SMART v podrobnostiach disku na karte Úložisko."
},
{
"label": "Dashboard: Záložka úložiska",
"href": "/docs/monitor/dashboard/storage",
"tail": " — úplná tabuľka atribútov SMART, história samotestov a správa PDF."
},
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tail": " — kategória CPU a teplota, ktorá používa rovnaké snímače."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tail": " — koncové body hardvéru a GPU."
},
{
"label": "Index panela",
"href": "/docs/monitor/dashboard",
"tail": " — Ostatné karty."
}
]
}
}
@@ -0,0 +1,101 @@
{
"meta": {
"title": "ProxMenux Monitor — Panel | Dokumentácia ProxMenux",
"description": "Panel je hlavným rozhraním ProxMenux Monitor: desať kariet vrátane spúšťača Apps, spoločná hlavička a nastaviteľné poradie hlavnej navigácie."
},
"header": {
"title": "Panel",
"description": "Každodenný pohľad na ProxMenux Monitor: desať kariet vrátane spúšťača Apps, spoločná hlavička a nastaviteľné poradie hlavnej navigácie.",
"section": "ProxMenux Monitor"
},
"oneHeader": {
"title": "Jedna hlavička, desať kariet",
"body": "Hlavička s logom, názvom uzla, indikátorom stavu, dobou prevádzky, obnovením a témou zostáva viditeľná. Aktívna karta mení celý obsah pod ňou. Farba indikátora zodpovedá najhoršej kategórii <link>monitora stavu</link>; panel zobrazuje ten istý údaj."
},
"tabs": {
"heading": "Desať kariet",
"intro": "Každá karta má svoju vlastnú vyhradenú stránku. Stránky sa pridávajú postupne pri vypĺňaní dokumentácie; nižšie je úplný zoznam a za čo je zodpovedný každý z nich.",
"headerTab": "Karta",
"headerOwns": "Čo pokrýva",
"rows": [
{
"name": "Prehľad systému",
"linksTo": "/docs/monitor/dashboard/system-overview",
"owns": "CPU / widgety pamäte / teploty, aktívny počet VM a LXC, grafy historických metrík, súhrny úložiska a siete. Predvolená vstupná karta, kým sa neprispôsobí poradie navigácie."
},
{
"name": "Aplikácie",
"linksTo": "/docs/monitor/dashboard/apps",
"owns": "Spoločný spúšťač registrovaných webových odkazov LXC a vlastných odkazov s kategóriami, vyhľadávaním, skratkami k hosťovským systémom a indikátormi aktualizácií aplikácií."
},
{
"name": "Úložisko",
"owns": "Proxmox pools, fyzické disky, SMART údaje, ZFS stav, opotrebovanie a životnosť, história pozorovania."
},
{
"name": "Sieť",
"owns": "Fyzické rozhrania, bondy, mosty a OVS, adresy IP/MAC, grafy RX/TX a história RRD každého rozhrania."
},
{
"name": "VM a LXC",
"owns": "Inventár hosťovských systémov, podrobnosti konfigurácie, metrík a denníkov a akcie spustenia, zastavenia, reštartu a vypnutia."
},
{
"name": "Hardvér",
"owns": "Model a topológia CPU, rozloženie pamäte, topológia PCIe a GPU s monitorovaním každého slotu v reálnom čase."
},
{
"name": "Systémové záznamy",
"owns": "Živé <code>journalctl</code> s filtrami, História úloh Proxmox, protokol upozornení, sťahovacie log zväzky."
},
{
"name": "Terminál",
"owns": "Shell hostiteľa alebo ľubovoľnej VM/CT v prehliadači pomocou <code>xterm.js</code> cez WebSockets."
},
{
"name": "Zabezpečenie",
"owns": "Nastavenie overovania, heslo, 2FA a tokeny API, denník auditu, voliteľný panel Fail2Ban a nasadenie Secure Gateway."
},
{
"name": "Nastavenia",
"owns": "Jazyk Monitora, poradie navigácie, kanály oznámení, poskytovateľ AI, prahové hodnoty stavu, výnimky a inventár úprav po inštalácii."
}
]
},
"headerAnatomy": {
"heading": "Anatómia hlavičky",
"items": [
"<strong>Logo + názov produktu</strong> vľavo. Keď sa zistí novšie vydanie monitora, logo sa zmení na variant „dostupná aktualizácia“.",
"<strong>Identita uzla</strong>: názov z <code>pvesh get /nodes</code>, prípadne z <code>hostname</code>.",
"<strong>Indikátor stavu</strong>: V poriadku (zelená), Varovanie (žltá), Kritický (červená). Kliknutie otvorí monitor stavu. Modré označenie <em>info</em> sa zobrazí, ak sú skryté položky ešte v období potlačenia.",
"<strong>Doba prevádzky</strong>: čas behu hostiteľa v čitateľnom formáte.",
"<strong>Tlačidlo Obnoviť</strong>: zopakuje volania API pre živé údaje bez načítania celej stránky.",
"<strong>Výber témy</strong>: svetlá, tmavá alebo systémová. Ukladá sa do <code>localStorage</code>."
]
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Záložka aplikácií",
"href": "/docs/monitor/dashboard/apps",
"tail": " — spoločný spúšťač webových odkazov a jeho vzťah k registrovaným aplikáciám LXC."
},
{
"label": "Karta Prehľad systému",
"href": "/docs/monitor/dashboard/system-overview",
"tail": " — úvodná karta s úplnou dokumentáciou."
},
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tail": " — okno indikátora stavu s podrobnosťami desiatich kategórií."
},
{
"label": "Architektúra",
"href": "/docs/monitor/architecture",
"tail": " — ako panel komunikuje s backendom Flask."
}
]
}
}
@@ -0,0 +1,251 @@
{
"meta": {
"title": "ProxMenux Monitor — Prehľad: karta Sieť | Dokumentácia ProxMenux",
"description": "Karta Sieť uvádza všetky rozhrania hostiteľa: fyzické karty, mosty, bondy, VLAN a virtuálne rozhrania VM/LXC. Detail zobrazuje IP, MAC, stav, členov bondu, prenosy od spustenia a históriu RRD."
},
"header": {
"title": "Prehľad: karta Sieť",
"description": "Rozhrania hlásené jadrom — fyzické karty, mosty, bondy, VLAN a virtuálne porty VM/LXC — sú zoskupené do troch kariet. Kliknutím na riadok otvoríte adresy, počítadlá prenosov a historické údaje RRD.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Aktuálne aj historické údaje",
"body": "Aktuálny stav pochádza z <code>psutil.net_if_stats()</code> a <code>ip</code>, história prenosov z úložiska RRD Proxmox cez <code>/api/network/&lt;interface&gt;/metrics</code>. Počítadlá sa obnovujú približne každých 5 sekúnd a údaje RRD pre graf sa načítajú podľa potreby."
},
"topRow": {
"heading": "Horný riadok: štyri štatistické karty",
"headerCard": "Karta",
"headerWhat": "Čo ukazuje",
"rows": [
{
"card": "Sieťové prenosy",
"what": "Agregovaná rýchlosť RX / TX na všetkých rozhraniach, formátovaná v správnej jednotke (bps / Kbps / Mbps / Gbps)."
},
{
"card": "Aktívne rozhrania",
"what": "Dve počítadlá: <em>Physical X / Y</em> a <em>Bridges X / Y</em>, aktívne z celkového počtu. Prvé miesto na kontrolu, keď niečo prestane fungovať."
},
{
"card": "Stav siete",
"what": "Rýchle hodnotenie: V poriadku / Varovanie / Kritické podľa stavu spojenia, dostupnosti brány a integrity mosta. Zodpovedá kategórii <em>Sieťové rozhrania</em> v Health Monitor."
},
{
"card": "Odozva siete",
"what": "Čas odozvy brány s malým grafom. Kliknutie otvorí nižšie opísané <strong>okno Odozva siete</strong>: históriu a test ping na požiadanie voči bráne, Cloudflare alebo Google so správou PDF na stiahnutie."
}
]
},
"flow": {
"heading": "Diagram sieťových tokov",
"intro": "Medzi horným riadkom a tromi kartami zobrazuje <strong>Network Flow</strong> aktuálnu topológiu. Cesty paketov vedú od fyzických kariet cez mosty v strede k VM a kontajnerom. Animované impulzy znázorňujú aktuálne prenosy rx/tx na každom spojení.",
"imageAlt": "Diagram toku siete – NIC vľavo, hostiteľ a mosty v strede, VM a LXC vpravo, s animovanými impulzmi na každom pripojení",
"imageCaption": "Network Flow — farebne odlíšené uzly plus animované kométy, ktorých smer a hrúbka odrážajú živú premávku.",
"elementsTitle": "Čo ukazuje diagram",
"elementsIntro": "Každý uzol predstavuje položku z rovnakého inventára ako karty nižšie. Topologické usporiadanie umožňuje ihneď vidieť ich vzťahy:",
"elements": [
"<strong>Sieťové karty</strong> (oranžové) — fyzické rozhrania s aktívnym spojením; neaktívne sú zobrazené tlmene.",
"<strong>Hostiteľ</strong> (oranžový) — hostiteľ Proxmox medzi sieťovými kartami a mostmi. Pevný bod, na ktorý nemožno kliknúť.",
"<strong>Mosty</strong> (tyrkysové) — mosty Linux a OVS s aspoň jedným aktívnym hosťovským systémom. Nepoužívané mosty sú skryté, aby diagram zvýraznil skutočné prenosy.",
"<strong>LXC</strong> (tyrkysové) — spustené kontajnery pripojené k mostu.",
"<strong>VM</strong> (fialové) — spustené virtuálne stroje pripojené k mostu.",
"Zastavené VM a kontajnery sú skryté."
],
"pulsesTitle": "Čo animácia kóduje",
"pulsesBody": "Animované kométy, ktoré cestujú pozdĺž každého okraja predstavujú živú premávku:",
"pulses": [
"<strong>Smer</strong> — k sieťovej karte znamená <em>tx</em> hosťovského systému, k hosťovi znamená <em>rx</em>.",
"<strong>Hrúbka čiary</strong> rastie s rýchlosťou rx+tx hosťovského systému. Bez prenosov zostáva slabá animovaná čiara, pri veľkom prenose je hrubá.",
"<strong>Žiara hlavy kométy</strong> — teplý odtieň približne pri 1 MB/s, intenzívny od 30 MB/s. Pomáha rozpoznať hosťovský systém, ktorý najviac vyťažuje sieťovú kartu.",
"<strong>Kliknutie</strong> — každý uzol okrem hostiteľa otvorí nižšie opísané okno detailu rozhrania. Kliknutie na hostiteľa nemá žiadny účinok; v tomto zobrazení preň nie je okno."
],
"useTitle": "Keď je to užitočné",
"useBody": "Karty ukazujú, <em>čo</em> existuje; diagram ukazuje, <em>ako je to prepojené</em> a kadiaľ tečú dáta. Odhalí hostí na rovnakom moste, dva vyťažené systémy na jednej karte ako možné úzke miesto alebo VM, ktorá zaplní spojenie, kým ostatné takmer neprenášajú."
},
"groups": {
"heading": "Tri skupiny rozhraní",
"intro": "Tri karty zoskupujú rozhrania podľa úlohy. Hlavička každej uvádza počet aktívnych rozhraní. Farebný štítok označuje <strong>typ</strong> každého rozhrania:",
"badges": [
"Modrá <strong>Fyzická</strong> – skutočné NIC.",
"Zelená <strong>Most</strong> Most Linux alebo most OVS (<code>vmbr*</code>).",
"Fialové <strong>Bond</strong> — agregované rozhranie bond / LACP / active-backup.",
"Tyrkysové <strong>VLAN</strong> — podrozhranie VLAN (<code>vmbr0.10</code>, <code>eno1.42</code>, …)."
],
"clickable": "<strong>Na každý riadok možno kliknúť</strong>: fyzické a virtuálne rozhrania, mosty aj bondy. Nižšie opísaný detail zobrazí základné údaje, IP, počítadlá a históriu RX/TX z úložiska RRD Proxmox.",
"physicalTitle": "Fyzické rozhrania",
"physicalBody": "Fyzické rozhrania rozpoznané jadrom: <code>eno1</code>, <code>enp4s0</code>, <code>eth0</code>, <code>wlp3s0</code> a ďalšie. Každé zariadenie má riadok s modrým štítkom <strong>Physical</strong> a stavom spojenia. Zobrazujú sa aj <em>členovia bondu</em> s odkazom na príslušný bond.",
"bridgeTitle": "Sieťové mosty",
"bridgeBody": "Mosty Linux (<code>vmbr0</code>, <code>vmbr1</code>, …) a OVS spravované Proxmoxom. Každý riadok ukazuje zelený štítok <strong>Bridge</strong>, pri jednom porte fyzické rozhranie a stav mosta. Bondy majú fialový štítok <strong>Bond</strong>, podrozhrania VLAN tyrkysový <strong>VLAN</strong>.",
"vmTitle": "Rozhrania VM / LXC",
"vmBody": "Rozhrania <code>tap*</code> a <code>veth*</code> vytvorené pri spustení hostí, jedno pre každú virtuálnu kartu. Hlavička uvádza <em>X / Y Active</em> a riadky odkazujú na VM/CT v karte VMs a LXCs. Po zastavení hosťa neaktívne záznamy zmiznú pri ďalšom obnovení."
},
"drillIn": {
"heading": "Detail rozhrania",
"intro": "Kliknutím na riadok otvoríte okno s piatimi blokmi:",
"headerBlock": "Blok",
"headerContents": "Obsah",
"rows": [
{
"block": "Základné informácie",
"contents": "Názov, typ (fyzické / most / bond / VLAN / vm), MAC adresa, stav (aktívne / neaktívne), MTU a základné fyzické rozhranie pri virtuálnych typoch."
},
{
"block": "Členovia bondu",
"contents": "Iba pre bondy: každá členská karta s aktívnym alebo chybovým stavom, režim bondu (active-backup / 802.3ad / balance-alb / …) a primárne rozhranie, ak je nastavené."
},
{
"block": "IP adresy",
"contents": "Každá adresa IPv4/IPv6 s dĺžkou predpony. Automaticky nastavené adresy link-local sú uvedené sivou farbou."
},
{
"block": "Historický graf",
"contents": "Rýchlosť RX/TX vo vybranom období (1 hodina / 24 hodín / 7 dní / 30 dní / 1 rok), získaná z <code>/api/network/&lt;interface&gt;/metrics</code> (RRD Proxmox)."
},
{
"block": "Premávka od posledného štartu",
"contents": "Celkový počet bajtov a paketov RX/TX od posledného spustenia hostiteľa a počítadlá chýb a zahodených paketov."
}
],
"inactiveTitle": "Detail neaktívnych rozhraní zostáva dostupný",
"inactiveBody": "Ak je rozhranie <em>neaktívne</em>, okno zobrazí upozornenie „Neaktívne rozhranie“ bez aktuálnych počítadiel. Konfigurácia s adresami a členmi bondu aj história zostanú viditeľné na určenie príčiny a času poruchy."
},
"latency": {
"heading": "Okno Odozva siete",
"intro": "Kliknutím na <em>Odozva siete</em> v hornom riadku otvoríte okno s históriou, testom na požiadanie, tromi cieľmi a správou PDF na stiahnutie.",
"targetsTitle": "Ciele",
"targetsIntro": "Rozbaľovací zoznam hore vyberá cieľ testu ping:",
"targets": [
"<strong>Brána</strong> — smerovač LAN. Testuje iba miestny úsek, aby ste mohli skúmať problémy prepínača alebo kabeláže bez vplyvu WAN.",
"<strong>Cloudflare (1.1.1.1)</strong> — verejný resolver DNS v sieti anycast. Testuje úsek WAN.",
"<strong>Google (8.8.8.8)</strong> — alternatívny verejný cieľ na overenie výsledkov alebo pri regionálnych problémoch Cloudflare."
],
"mode1Title": "Režim 1 — Historické zobrazenie",
"mode1Alt": "Okno odozvy v historickom režime s cieľom Brána, hodinovým intervalom a zobrazenými predchádzajúcimi meraniami",
"mode1Caption": "História odozvy brány za poslednú hodinu. Zberné vlákno teploty a odozvy ukladá merania do databázy každých 60 sekúnd.",
"mode1Body1": "Predvolený režim okna. Druhý zoznam vyberá obdobie (<em>1 hodina / 6 hodín / 24 hodín / 3 dni / 7 dní</em>). Nad grafom sú Aktuálna / Minimum / Priemer / Maximum a stav Výborná / Dobrá / Zvýšená / Zlá podľa prahov uvedených nižšie.",
"mode1Body2": "Zdrojom sú merania, ktorými Health Monitor zisťuje dlhodobé spomalenie siete. Vlákno na pozadí <code>_temperature_collector_loop</code> meria bránu každých 60 sekúnd a ukladá históriu do lokálnej databázy SQLite.",
"mode2Title": "Režim 2 — Test v reálnom čase",
"mode2Alt": "Okno odozvy s priebežným pingom na Cloudflare, priebehom 50 % a pribúdajúcimi meraniami v grafe",
"mode2Caption": "Dvojminútový test voči Cloudflare s meraním každých päť sekúnd, ktoré sa hneď pridá do grafu. <em>Zastaviť</em> ukončí test skôr; <em>Testovať znova</em> pridá merania do rovnakého súboru údajov.",
"mode2Intro": "Prepnutie cieľa na Cloudflare alebo Google spustí na požiadanie ping test. Správanie:",
"mode2Items": [
"<strong>Trvanie</strong> — dve minúty na test s ukazovateľom priebehu a zostávajúcimi sekundami.",
"<strong>Interval</strong> — meranie každých päť sekúnd, 24 meraní na test.",
"<strong>Metóda</strong> — ICMP Echo Request (<code>ping</code>), tri po sebe idúce pingy na meranie s priemernou odozvou.",
"<strong>Zastaviť</strong> — okamžite ukončí test a zachová doterajšie údaje.",
"<strong>Testovať znova</strong> — pridáva merania k existujúcim údajom, aby ste viacerými testami vytvorili dlhšiu históriu.",
"<strong>Ukazovateľ aktuálneho stavu</strong> — prehodnocuje sa po každom meraní podľa rovnakých prahov Výborná / Dobrá / Zvýšená / Zlá."
],
"thresholdsTitle": "Hraničné hodnoty výkonu",
"headerStatus": "Stav",
"headerRange": "Rozsah",
"headerImpact": "Praktický vplyv",
"thresholdRows": [
{
"status": "Výborná",
"range": "< 50 ms",
"impact": "Optimálne pre aplikácie v reálnom čase, herné a video hovory."
},
{
"status": "Dobrá",
"range": "50 – 100 ms",
"impact": "V poriadku pre väčšinu aplikácií, s minimálnym dopadom."
},
{
"status": "Zvýšená",
"range": "100 – 200 ms",
"impact": "Citeľné oneskorenie. Môže ovplyvniť VoIP a interaktívne aplikácie."
},
{
"status": "Zlá",
"range": "> 200 ms",
"impact": "Odozva je výrazne zvýšená. Odporúča sa preveriť sieť."
}
],
"reportTitle": "Správa o latencii siete (PDF)",
"reportIntro": "Oba režimy majú pri výbere cieľa tlačidlo <strong>Správa</strong>. Vytvorí PDF meraní, ktoré môžete priložiť k žiadosti o podporu u poskytovateľa internetu.",
"reportPreviewAlt": "Prvá strana správy PDF o odozve: súhrn, ukazovateľ, štatistiky, graf a vysvetlenie prahov",
"reportPreviewCaption": "Prvá strana obsahuje súhrn, ukazovateľ, hlavné štatistiky, časový priebeh odozvy a vysvetlenie prahov. Od strany 2 nasleduje tabuľka meraní a metodika.",
"downloadLabel": "Stiahnuť príklad správy o odozve (PDF)",
"sectionsIntro": "Správa obsahuje šesť sekcií:",
"sections": [
"<strong>Súhrn</strong> — ukazovateľ od 0 do viac ako 300 ms so zelenou, žltou a červenou zónou; stav Výborná / Dobrá / Zvýšená / Zlá; cieľ, režim, počet meraní a súhrn straty paketov.",
"<strong>Štatistiky odozvy</strong> — štyri ukazovatele pre aktuálnu hodnotu, minimum, priemer a maximum, plus počet meraní, priemerná strata paketov a obdobie testu.",
"<strong>Graf odozvy</strong> — plošný graf meraní počas testu s referenciami minima, priemeru a maxima na zvislej osi.",
"<strong>Prahy výkonu</strong> — rovnaká štvorstupňová škála ako vyššie s farebnou bodkou pre každý stupeň.",
"<strong>Podrobné výsledky</strong> — číslovaná tabuľka s časom, odozvou, stratou paketov a stavom každého merania. Odhalí krátke špičky skryté za priemermi.",
"<strong>Metodika</strong> — ICMP Echo Request, tri po sebe idúce pingy na meranie, názov a IP cieľa a záverečné hodnotenie podľa stavu."
],
"useCaseTitle": "Príklad použitia: podpora poskytovateľa internetu",
"useCaseBody": "Pri spomalení spustite dvojminútový test Cloudflare, predĺžte záznam cez <em>Testovať znova</em> a vyberte <em>Správa</em>. PDF obsahuje všetky merania a metodiku. Môžete ho priložiť k žiadosti o podporu s časmi poruchy; poskytovateľ určuje potrebné dôkazy."
},
"excluding": {
"heading": "Vylúčenie rozhraní z monitorovania",
"body1": "Rozhrania možno vylúčiť z monitorovania, napríklad zámerne vypnuté mosty, testovacie rozhrania alebo odstránené karty, ktoré zostali v konfigurácii. Nastavenie je v <code>excluded_interfaces</code>: Health Monitor pre ne nevytvára varovania ani oznámenia a nezahŕňa ich do celkového stavu.",
"body2": "V kontextovej ponuke vyberte <em>Vylúčiť z monitorovania</em>. Rozhranie zostane viditeľné s fialovým štítkom <strong>vylúčené</strong>. V rovnakej ponuke môžete monitorovanie opäť zapnúť."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerSection": "Časť karty",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"section": "Inventár rozhrania",
"endpoint": "/api/network",
"source": "<code>ip -j addr</code> + <code>ip -j link</code> a zisťovanie bondov a mostov."
},
{
"section": "Súhrnné karty",
"endpoint": "/api/network/summary",
"source": "Súhrn inventára a počet aktívnych a neaktívnych rozhraní."
},
{
"section": "História RX/TX jednotlivých rozhraní",
"endpoint": "/api/network/<iface>/metrics",
"source": "Aktuálne počítadlá používajú <code>/proc/net/dev</code>; história grafu pochádza z RRD Proxmox cez pvesh. Rozhrania VM/LXC používajú údaje hosťa, fyzické rozhrania a mosty údaje uzla."
},
{
"section": "Odozva: aktuálna",
"endpoint": "/api/network/latency/current",
"source": "Krátka séria <code>ping</code> na nastavenú bránu alebo cieľ."
},
{
"section": "Odozva: história",
"endpoint": "/api/network/latency/history",
"source": "Merania ukladá zberné vlákno teploty a odozvy na pozadí približne každých 60 sekúnd."
}
],
"codeComment1": "# Overiť stav rozhraní zobrazený v prehľade",
"codeComment2": "# Overiť aktuálne meranie odozvy celej trasy"
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tail": " — kategória Sieť a prahy histórie odozvy."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tail": " — koncové body siete a odozvy."
},
{
"label": "Integrácie",
"href": "/docs/monitor/integrations",
"tail": " — zber Prometheus poskytuje rovnaké sieťové metriky."
},
{
"label": "Index prehľadu",
"href": "/docs/monitor/dashboard",
"tail": " — Ostatné karty."
},
{
"label": "ProxMenux → Sieť",
"href": "/docs/network",
"tail": "— strana akcií: analýza mostov, trvalé názvy rozhraní, zálohovanie a reštart, iperf3."
}
]
}
}
@@ -0,0 +1,246 @@
{
"meta": {
"title": "ProxMenux Monitor — Prehľad: karta Zabezpečenie | Dokumentácia ProxMenux",
"description": "Karta Zabezpečenie združuje ochranné funkcie do dvoch stĺpcov: ProxMenux Monitor (overovanie, SSL/HTTPS, tokeny API, Secure Gateway) a Proxmox VE (firewall, Fail2Ban, audit Lynis). Obsahuje sprievodcu Secure Gateway, postup auditu Lynis a inštaláciu a nastavenie pravidiel Fail2Ban."
},
"header": {
"title": "Prehľad: karta Zabezpečenie",
"description": "Bezpečnostné funkcie sú rozdelené do dvoch blokov: nastavenia samotného Monitora (overovanie, SSL, tokeny, Secure Gateway) a nastavenia sledovaného hostiteľa Proxmox (firewall, Fail2Ban, Lynis).",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Dve oblasti, jedna karta",
"body": "Karta Zabezpečenie má dve časti: <strong>ProxMenux Monitor</strong> (nastavenia prehľadu) a <strong>Proxmox VE</strong> (nastavenia hostiteľa). Ak Fail2Ban alebo Lynis chýba, jeho karta ponúka inštaláciu; po inštalácii zobrazí ovládacie prvky."
},
"monitor": {
"heading": "ProxMenux Monitor",
"intro": "Štyri karty umožňujú nastaviť prístup k prehľadu a overovanie používateľov."
},
"auth": {
"heading": "Overovanie",
"imageAlt": "Karta overovania so stavom Zapnuté, tlačidlami Odhlásiť sa a Zmeniť heslo, informáciami o dvojfaktorovom overovaní a tlačidlami na jeho zapnutie a vypnutie overovania",
"imageCaption": "Karta so zapnutým overovaním: indikátor stavu, Zmeniť heslo, Zapnúť 2FA a deštruktívna akcia Vypnúť overovanie.",
"intro": "Karta umožňuje spravovať prihlásenie do prehľadu. Prvé spustenie, pravidlá hesiel, nastavenie TOTP a obnovu po strate autentifikátora opisuje časť <link>Prístup a overovanie</link>. Táto karta slúži na každodennú správu týchto nastavení:",
"items": [
"<strong>Stav overovania</strong> — indikátor <em>Zapnuté</em> / <em>Vypnuté</em> / <em>Odmietnuté</em>.",
"<strong>Zmeniť heslo</strong> — aktuálne heslo + nové heslo + potvrdenie.",
"<strong>Zapnúť / Vypnúť dvojfaktorové overovanie</strong> — pri zapnutí otvorí nastavenie s QR kódom, pri vypnutí vyžiada aktuálne heslo.",
"<strong>Vypnúť overovanie</strong> — deštruktívna akcia, ktorá pri ďalšej návšteve znova zobrazí úvodné okno <em>Chrániť prehľad?</em>."
]
},
"ssl": {
"heading": "SSL / HTTPS",
"imageAlt": "Karta SSL/HTTPS so stavom HTTP bez SSL, zisteným certifikátom hostiteľa Proxmox s držiteľom, vydavateľom a platnosťou a možnosťami použiť certifikát Proxmox alebo vlastný certifikát",
"imageCaption": "Karta SSL/HTTPS s vypnutým HTTPS. Monitor zistí certifikát nainštalovaný na hostiteľovi Proxmox a umožní ho použiť jedným kliknutím. Pre vlastné súbory uložené inde je k dispozícii <em>Použiť vlastný certifikát</em>.",
"intro": "Sprístupní prehľad cez HTTPS bez reverzného proxy. Karta zistí certifikát používaný Proxmoxom v <code>/etc/pve/local/</code> a zobrazí držiteľa, vydavateľa a platnosť na kontrolu pred zapnutím. HTTPS možno zapnúť dvoma spôsobmi:",
"items": [
"<strong>Použiť certifikát Proxmox</strong> — Monitor jedným kliknutím použije certifikát hostiteľa. Vhodné, ak PVE aj prehľad používajú rovnaký názov DNS.",
"<strong>Použiť vlastný certifikát</strong> — vložte absolútne cesty k certifikátu <code>.pem</code> a súkromnému kľúču <code>.key</code>. Pred reštartom služby sa overia. Ak načítanie zlyhá, prehľad sa automaticky vráti na HTTP a zostane dostupný."
],
"enabledAlt": "Karta SSL/HTTPS so zapnutým HTTPS, aktívnym certifikátom s cestami k pve-ssl.pem a pve-ssl.key a tlačidlom Vypnúť HTTPS",
"enabledCaption": "HTTPS je zapnuté — karta zobrazuje používaný certifikát, cesty k súborom a akciu <em>Vypnúť HTTPS</em>, ktorá obnoví HTTP na rovnakom porte.",
"acmeTitle": "ACME / Let's Encrypt cez Proxmox",
"acmeBody": "Ak má uzol Proxmox nastavený Let’s Encrypt v <em>Datacenter → Certifikáty → ACME</em>, prehľad po kliknutí na <em>Použiť certifikát Proxmox</em> použije rovnaký certifikát, ktorý hostiteľ poskytuje prehliadačom. Samostatné nastavenie ACME pre Monitor nie je potrebné.",
"walkthroughLink": "Podrobný postup v časti <link>HTTPS pre ProxMenux Monitor</link> vysvetľuje zistenie certifikátu ACME, údaje zapisované na disk a použitie vlastnej dvojice <code>.pem</code> / <code>.key</code>."
},
"apiTokens": {
"heading": "Prístupové tokeny API",
"emptyAlt": "Prázdna karta prístupových tokenov API s informáciami o tokenoch a tlačidlom Vygenerovať nový token API",
"emptyCaption": "Karta tokenov po novej inštalácii. Pole <em>O tokenoch API</em> vysvetľuje platnosť, použitie a vloženie tokenu do hlavičiek <code>Authorization: Bearer</code>.",
"intro": "Tokeny platné jeden rok pre bezobslužné integrácie: widgety Homepage, senzory REST v Home Assistant, zber dát pre Grafana, toky n8n a vlastné skripty. Karta prechádza tromi stavmi: prázdna → formulár → vygenerovaný token.",
"generateBody": "<strong>Vygenerujte token.</strong> Kliknite na <em>Vygenerovať nový token API</em>. Zadajte opisný <em>názov tokenu</em>, aby ste ho neskôr rozpoznali v zozname, a svoje <em>heslo</em> na dodatočné potvrdenie. Pri zapnutom 2FA je potrebný aj aktuálny kód TOTP.",
"generateAlt": "Formulár na vytvorenie tokenu API s poľami Názov tokenu a Heslo a tlačidlami Vygenerovať token a Zrušiť",
"generateCaption": "Formulár na vytvorenie tokenu API: zadajte názov a potvrďte heslom a pri zapnutom 2FA aj kódom TOTP.",
"saveBody": "<strong>Token ihneď uložte.</strong> Celá hodnota tokenu sa po vytvorení zobrazí <strong>iba raz</strong>. Karta na to upozorňuje oranžovým oznámením a tlačidlom kopírovania. Neskôr ju nemožno získať; v zozname aktívnych tokenov uvidíte len predponu.",
"generatedAlt": "Vygenerovaný token API so skrytou hodnotou, tlačidlom kopírovania, pokynmi pre hlavičku Authorization: Bearer a zoznamom aktívnych tokenov s predponami",
"generatedCaption": "Token je vygenerovaný: hodnota sa zobrazí iba raz spolu s tlačidlom kopírovania a presným vzorom <code>Authorization: Bearer</code>. Zoznam aktívnych tokenov nižšie uchováva názov, predponu a dátum vytvorenia, aby ste mohli tokeny jednotlivo odvolať.",
"outro": "Každý aktívny token má tlačidlo <em>Odvolať</em>. Odvolanie ho okamžite zneplatní a integrácie, ktoré ho používajú, prestanú fungovať. Príklady pre Homepage, Home Assistant, n8n a Prometheus sú v časti <link>Integrácie</link>."
},
"gateway": {
"heading": "Secure Gateway",
"cardAlt": "Karta Secure Gateway pred prvým nasadením s tlačidlom Nasadiť Secure Gateway",
"cardCaption": "Karta Secure Gateway po novej inštalácii: jedným tlačidlom spustíte sprievodcu.",
"intro": "Pristupujte k prehľadu, webovému rozhraniu Proxmox a hosťovským systémom odkiaľkoľvek v sieti <a>Tailscale</a> bez sprístupnenia portov na internete. Monitor na hostiteľovi nasadí kontajner LXC Alpine s <code>tailscaled</code> ako smerovačom podsiete. Po schválení v konzole Tailscale môžu vzdialené zariadenia pristupovať k LAN IP hostiteľa odkiaľkoľvek.",
"wizardTitle": "Sprievodca krok za krokom",
"wizardIntro": "Pred kliknutím na <em>Deploy Secure Gateway</em> vygenerujte overovací kľúč v konzole Tailscale. Sprievodca ho vyžiada v kroku 2.",
"step0Title": "0. Vygenerovať overovací kľúč Tailscale",
"step0Body": "Prihláste sa na <a>login.tailscale.com/admin/settings/keys</a> a kliknite na <em>Generate auth key…</em>. Vyberte <em>vopred overený</em> kľúč, aby brána nevyžadovala interaktívne prihlásenie do Tailscale. Hodnotu skopírujte; zobrazí sa iba raz.",
"step0Alt": "Stránka Settings → Keys v konzole Tailscale so zvýrazneným tlačidlom Generate auth key",
"step0Caption": "Konzola Tailscale — <em>Settings → Keys → Generate auth key…</em>. Ak ešte nemáte účet, vytvorte si bezplatný účet Tailscale cez odkaz v sprievodcovi.",
"step1Title": "1. Otvorte sprievodcu",
"step1Body": "Vráťte sa na kartu Zabezpečenie a kliknite na <em>Deploy Secure Gateway</em>. Prvý krok predstavuje funkcie a požiadavky.",
"step1Alt": "Úvod sprievodcu Secure Gateway: prístup cez VPN bez presmerovania portov a s koncovým šifrovaním",
"step1Caption": "Krok 1 — prehľad funkcií Secure Gateway a pripomenutie, že budete potrebovať bezplatný účet Tailscale.",
"step2Title": "2. Overenie v Tailscale",
"step2Body": "Vložte overovací kľúč z kroku 0 a vyberte názov hostiteľa. Pod týmto názvom sa brána zobrazí v konzole Tailscale, zvyčajne <code>proxmox-gateway</code> alebo názov uzla.",
"step2Alt": "Krok sprievodcu Secure Gateway s poľami pre overovací kľúč Tailscale a názov hostiteľa zariadenia a odkazom na vytvorenie kľúča",
"step2Caption": "Krok 2: vložte vopred overený kľúč a vyberte názov hostiteľa. Ak ste vynechali krok 0, odkaz pod poľom otvorí príslušnú stránku Tailscale.",
"step3Title": "3. Rozsah prístupu",
"step3Intro": "Vyberte si, čo môže vaša sieť dosiahnuť cez bránu:",
"step3Items": [
"<strong>Iba Proxmox</strong> — iba rozhranie Proxmox a Monitor. Najmenšia plocha útoku.",
"<strong>Celá lokálna sieť</strong> — celá podsieť LAN, automaticky zistená z hlavného rozhrania hostiteľa. Umožní prístup k NAS, tlačiarňam, VM a ostatným zariadeniam LAN.",
"<strong>Vlastné podsiete</strong> — zadajte konkrétne rozsahy CIDR. Pre prostredia s viacerými VLAN, v ktorých chcete sprístupniť iba vybrané segmenty."
],
"step3Alt": "Krok Rozsah prístupu v sprievodcovi Secure Gateway s možnosťami Iba Proxmox, Celá lokálna sieť a Vlastné podsiete",
"step3Caption": "Krok 3: vyberte rozsah prístupu. <em>Celá lokálna sieť</em> automaticky vyplní zistenú podsieť LAN.",
"step4Title": "4. Pokročilé možnosti (nepovinné)",
"step4Intro": "Dva voliteľné prepínače, oba <strong>predvolene vypnuté</strong>:",
"step4Items": [
"<strong>Výstupný uzol</strong> — po zapnutí a výbere na vzdialenom zariadení odchádza všetka jeho internetová komunikácia cez WAN hostiteľa Proxmox. Pri cestovaní tak telefón využíva vašu domácu internetovú prípojku.",
"<strong>Prijímať trasy</strong> — umožní bráne pristupovať k sieťam oznamovaným <em>inými</em> smerovačmi podsietí v sieti Tailscale, napríklad pri viacerých lokalitách."
],
"step4Alt": "Krok Pokročilé možnosti v sprievodcovi Secure Gateway s políčkami Exit Node a Accept Routes",
"step4Caption": "Krok 4: Exit Node a Accept Routes. Obe možnosti nechajte vypnuté, ak potrebujete iba prístup k prehľadu z telefónu alebo notebooku.",
"step5Title": "5. Skontrolovať a nasadiť",
"step5Body": "Záverečný súhrn pred nasadením. Sprievodca pripomína následný ručný krok v konzole Tailscale: <strong>schváliť trasu podsiete</strong>.",
"step5Alt": "Krok Skontrolovať a nasadiť v Secure Gateway so súhrnom názvu hostiteľa, režimu prístupu, sietí, Exit Node a Accept Routes a tlačidlom Nasadiť bránu",
"step5Caption": "Krok 5 — skontrolujte konfiguráciu a spustite nasadenie. Modré upozornenie dole pripomína čakajúce schválenie trasy.",
"approvalTitle": "Posledný manuálny krok v Tailscale admin",
"approvalBody": "Po nasadení otvorte <a>login.tailscale.com/admin/machines</a> a schváľte trasu podsiete oznamovanú bránou. Dovtedy vzdialené zariadenia v sieti Tailscale nedosiahnu cez bránu na IP adresy LAN. Čakajúce trasy sú v riadku zariadenia označené žltým upozornením. Kliknite na <em>Edit route settings</em> a zaškrtnite trasu."
},
"pve": {
"heading": "Proxmox VE",
"intro": "Ochrana hostiteľa: firewall, prevencia prienikov a bezpečnostný audit. Karty Fail2Ban a Lynis ponúkajú inštaláciu chýbajúcich nástrojov a potom zobrazia ovládanie ich správy."
},
"firewall": {
"heading": "Proxmox Firewall",
"imageAlt": "Karta firewallu Proxmox so stavom klastra a hostiteľa, pravidlami rýchleho prístupu pre Monitor a webové rozhranie Proxmox, počítadlami, zoznamom pravidiel a tlačidlom Pridať pravidlo",
"imageCaption": "Karta firewallu Proxmox: prepínače pre klaster a hostiteľa, bežné porty v časti <em>Pravidlá rýchleho prístupu</em>, počítadlá v časti <em>Prehľad pravidiel</em> a celý zoznam s tlačidlom <em>+ Pridať pravidlo</em>.",
"intro": "Karta spravuje konfiguráciu firewallu Proxmox VE. Klasický backend používa <code>iptables</code>, alternatívny <code>nftables</code>. Nespravuje ľubovoľné pravidlá vytvorené mimo Proxmoxu. Tri bloky:",
"items": [
"<strong>Firewall klastra + firewall hostiteľa</strong> — globálne prepínače. Firewall klastra musí byť zapnutý, aby sa uplatnili pravidlá hostiteľa. Karta túto závislosť uvádza priamo pri nastavení.",
"<strong>Pravidlá rýchleho prístupu</strong> — pripravené riadky pre <code>8008/TCP</code> (Monitor) a <code>8006/TCP</code> (webové rozhranie Proxmox) so stavom povolené, blokované alebo nechránené. Rozhranie Proxmox povoľuje <em>vstavané</em> makro firewallu, ktoré nemožno omylom odstrániť.",
"<strong>Prehľad pravidiel</strong> — počítadlá všetkých pravidiel, pravidiel accept, pravidiel drop/reject a rôznych chránených portov. Údaje sa čítajú z <code>/etc/pve/firewall/cluster.fw</code> a <code>/etc/pve/nodes/&lt;node&gt;/host.fw</code>.",
"<strong>Pravidlá firewallu</strong> — zoznam s akciou, protokolom, portom, zdrojom a úrovňou. <em>+ Pridať pravidlo</em> otvorí editor v karte; ikona koša odstráni pravidlo. Zmeny sa ukladajú do súborov Proxmoxu a zobrazia sa aj v jeho rozhraní (Datacenter / Node → Firewall)."
]
},
"fail2ban": {
"heading": "Fail2Ban",
"subHeading": "(podľa stavu)",
"whatIs": "<strong>Čo to je.</strong> Fail2Ban je služba s otvoreným zdrojovým kódom, ktorá v záznamoch zisťuje opakované neúspešné prihlásenia a blokuje IP adresu pomocou firewallu. Chráni SSH a webové formuláre pred nepretržitými útokmi hrubou silou. ProxMenux nastavuje tri jaily: SSH, webové prihlásenie Proxmox (port 8006) a prihlásenie ProxMenux Monitor (port 8008).",
"notBundled": "Fail2Ban <strong>nie je súčasťou balíka</strong>. Karta zistí, či je nainštalovaný, a prispôsobí sa: ak chýba, ponúkne inštaláciu jedným kliknutím. Po inštalácii zobrazí aktuálny stav jailov a blokované IP adresy a umožní nastaviť počet pokusov aj čas blokovania pre každý jail.",
"notInstalledAlt": "Karta Fail2Ban v stave Nenainštalované s opisom ochrany SSH, webového rozhrania Proxmox a Monitora cez nftables a tlačidlom Nainštalovať a nastaviť Fail2Ban",
"notInstalledCaption": "Karta Fail2Ban pred inštaláciou — modré pole opisuje nastavenia, ktoré inštalácia vykoná.",
"clickBody": "Kliknite na <em>Nainštalovať a nastaviť Fail2Ban</em>. Potvrdzovacie okno vypíše všetky zmeny, ktoré skript vykoná na hostiteľovi:",
"confirmAlt": "Potvrdenie Fail2Ban s agresívnym režimom SSH, ochranou Proxmoxu na porte 8006 a Monitora na porte 8008, zistením nftables, nastavením záznamov journald a zabezpečením SSH MaxAuthTries",
"confirmCaption": "Potvrdenie inštalácie: zoznam jailov, úprava úrovne záznamov journald na čítanie udalostí SSH a dodatočné zabezpečenie SSH (<code>MaxAuthTries=3</code>).",
"confirmIntro": "Po potvrdení panel priebežne zobrazuje inštaláciu: apt, konfiguráciu jailov a testy. Používa rovnaký mechanizmus ako inštalátor CLI ProxMenux.",
"progressAlt": "Panel so záznamom inštalácie Fail2Ban: balík, journald MaxLevelStore pre overovanie, jaily, zistenie nftables, zabezpečenie MaxAuthTries, test komunikácie fail2ban-client a správa o dokončení",
"progressCaption": "Prebieha inštalácia: panel zaznamenáva každý krok. Správa Connection closed na konci označuje ukončenie prenosu.",
"afterInstall": "Po inštalácii karta zobrazuje aktuálny stav: nastavené jaily, blokované IP a posledné blokovania. Karty oddeľujú <em>Jaily a blokované IP</em> od <em>Nedávnej aktivity</em>, ktorá obsahuje posledných N záznamov Fail2Ban.",
"activeAlt": "Aktívna karta Fail2Ban s tromi jailmi (proxmenux, proxmox, sshd), počítadlami blokovaných IP, všetkých blokovaní a neúspešných pokusov a riadkami s pokusmi, dĺžkou blokovania, intervalom a ozubeným kolieskom",
"activeCaption": "Fail2Ban je aktívny: tri predvolené jaily (<code>proxmenux</code>, <code>proxmox</code>, <code>sshd</code>) s nastaveniami počtu pokusov, dĺžky blokovania a intervalu zisťovania.",
"tuneBody": "<strong>Upravte pravidlá jailu.</strong> Ozubeným kolieskom nastavíte <em>Max Retries</em>, <em>Ban Time</em> a <em>Find Time</em>, posuvný interval na počítanie pokusov. Trvalé blokovanie zostáva aktívne až do ručného zrušenia. Formulár vysvetľuje bežné hodnoty.",
"configAlt": "Formulár jailu sshd s Max Retries, Ban Time v sekundách, možnosťou Permanent Ban, Find Time, pomocou pre bežné hodnoty a tlačidlom Uložiť konfiguráciu",
"configCaption": "Úprava jailu sshd: znížte <em>Max Retries</em>, ak SSH používate iba z vlastnej podsiete, alebo predĺžte <em>Ban Time</em> pre prehľad dostupný z internetu.",
"outro": "Návod <em>Inštalácia, nastavenie a odinštalovanie</em> opisuje aj ručnú inštaláciu, zmenu SSH MaxAuthTries a súvislosť so záznamom <code>proxmenux-auth.log</code>. Pozrite <link>ProxMenux → Zabezpečenie → Fail2Ban</link>.",
"calloutTitle": "Bez Fail2Ban tento mechanizmus neblokuje IP adresy",
"calloutBody": "ProxMenux Monitor kontroluje IP adresy blokované Fail2Ban na <em>aplikačnej úrovni</em> pred spracovaním požiadaviek Flask. Volá fail2ban-client a výsledok ukladá do vyrovnávacej pamäte na 30 sekúnd; nečíta tabuľku blokovaní SQL. Bez Fail2Ban sa neúspešné prihlásenia zapisujú do <code>proxmenux-auth.log</code>, ale tento mechanizmus IP adresy neblokuje."
},
"lynis": {
"heading": "Bezpečnostný audit Lynis",
"subHeading": "(podľa stavu)",
"whatIs": "<strong>Čo to je.</strong> Lynis je nástroj bezpečnostného auditu s otvoreným zdrojovým kódom, ktorý vykonáva približne 280 testov hostiteľa: oprávnenia, zabezpečenie jadra, SSH, zraniteľnosti balíkov, kryptografické pravidlá, plánované úlohy, identifikáciu služieb a ďalšie. Vytvorí index zabezpečenia od 0 do 100, varovania a návrhy. Bežne sa používa na hodnotenie serverov založených na Debiane.",
"whyUseful": "<strong>Prečo je to užitočné.</strong> Hodnotiť bezpečnosť čítaním každého konfiguračného súboru je náročné. Lynis odhalí často prehliadané problémy: chýbajúcu ochranu jadra, slabé šifry SSH, netrvalé záznamy alebo <code>NOPASSWD</code> v sudoers pre predvolené účty. Opakovanie kontroly po úpravách ProxMenuxu umožní porovnať zlepšenie pomocou skóre.",
"notInstalledAlt": "Karta Lynis v stave Nenainštalované s tlačidlom Nainštalovať Lynis a funkciami: index zabezpečenia, zisťovanie zraniteľností, kontrola súladu a zdroj na GitHube",
"notInstalledCaption": "Karta Lynis pred inštaláciou — modré pole zhŕňa funkcie nástroja.",
"notBundled": "Ani Lynis <strong>nie je súčasťou balíka</strong>. ProxMenux ho inštaluje priamo z oficiálneho zdrojového kódu GitHub namiesto balíka Debian.",
"confirmAlt": "Potvrdzovacie okno Lynis s funkciami: index zabezpečenia, zisťovanie zraniteľností, analýza konfigurácie, kontrola súladu a zdrojový kód z oficiálneho úložiska GitHub",
"confirmCaption": "Potvrdenie inštalácie výslovne uvádza zdroj na GitHube.",
"progressAlt": "Panel priebehu inštalácie Lynis s inštaláciou najnovšej verzie, potvrdením verzie 3.1.6 a správou o dokončení",
"progressCaption": "Prebieha inštalácia: panel priebežne zobrazuje záznam rovnako ako pri Fail2Ban.",
"afterInstall": "Po inštalácii karta zobrazí verziu a prázdnu históriu auditov. Prvú kontrolu spustíte tlačidlom <em>Spustiť bezpečnostný audit</em>.",
"installedAlt": "Karta Lynis po inštalácii s verziou 3.1.6, časom poslednej kontroly, indexom zabezpečenia 0, varovaniami 0, návrhmi 0, prázdnou správou a tlačidlom Spustiť bezpečnostný audit",
"installedCaption": "Lynis je nainštalovaný, audit ešte neprebehol. Ukazovatele zatiaľ zobrazujú nuly.",
"runningAlt": "Karta Lynis počas auditu so správou o prebiehajúcej kontrole, odhadom 2 až 5 minút a vypnutým tlačidlom Prebieha audit",
"runningCaption": "Prebieha audit: tlačidlo zobrazuje indikátor načítavania a karta upozorňuje, že kontrola môže trvať 2 až 5 minút.",
"finishedBody": "Po dokončení karta zobrazí výsledky: index zabezpečenia, varovania, návrhy a zoznam <em>Správy auditu</em> s predchádzajúcimi kontrolami.",
"resultsAlt": "Karta Lynis s indexom 71, rozdelením Lynis 66 a PVE 71, 3 varovaniami, 40 návrhmi, skóre upraveným pre Proxmox 71 zo 100 v pásme Dobré, správami na stiahnutie v PDF a tlačidlom Spustiť bezpečnostný audit",
"resultsCaption": "Príklad výsledkov: index zabezpečenia <strong>71/100 (Dobré)</strong>. Karta zobrazuje pôvodné skóre Lynis (66) a skóre upravené pre Proxmox (71). Úprava závisí od pôvodného skóre a podielu zistení považovaných za očakávané správanie Proxmox VE; nejde o pevné pripočítanie 11 bodov.",
"scoreTitle": "Pôvodné skóre Lynis a skóre upravené pre Proxmox",
"scoreIntro": "Pravidlá Lynis sú určené pre všeobecné systémy Debian. Proxmox sa od niektorých odlišuje z opodstatnených dôvodov, napríklad služby klastra bežia ako root alebo používajú vlastné nastavenia <code>journald</code>. Karta zobrazuje obe skóre, aby ste mohli:",
"scoreItems": [
"Sledovať <em>pôvodné skóre Lynis</em> rovnako ako externí audítori.",
"Sledovať skóre <em>upravené pre Proxmox</em>, vhodnejšie na porovnávanie uzlov v rovnakom klastri."
],
"reportBody": "<strong>Úplná správa.</strong> Tlačidlo <em>PDF</em> pri každom audite stiahne viacstranovú správu: súhrn pre vedenie, informácie o systéme, stav zabezpečenia, vysvetlené varovania, návrhy zoradené podľa vplyvu a zoznam balíkov. Môžete ju priložiť k bezpečnostnej kontrole.",
"reportAlt": "Príklad prvej strany správy PDF Lynis so súhrnom, indexom 71 zo 100, počtom varovaní a návrhov, názvom hostiteľa, jadrom, verziou Lynis, dátumom a prehľadom zabezpečenia",
"reportCaption": "Prvá strana správy: súhrn pre vedenie, informácie o systéme a stav zabezpečenia. Nasledujú podrobné varovania, návrhy a zoznam nainštalovaných balíkov. Ako referencia je priložený <a>príklad PDF</a>.",
"runPeriodically": "Audit spúšťajte pravidelne: po veľkých aktualizáciách Proxmoxu, po úpravách po inštalácii a pred sprístupnením vzdialeného prístupu. Správy si uchovajte; trend je dôležitejší než jedno skóre.",
"outro": "Návod na <em>inštaláciu, nastavenie a odinštalovanie</em> a rozbor príkladu správy nájdete v časti <link>ProxMenux → Zabezpečenie → Lynis</link>."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerCard": "Karta",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"card": "Overenie, 2FA, zmena hesla",
"endpoint": "/api/auth/*",
"source": "Lokálna konfigurácia overovania v ~/.config/proxmenux-monitor/auth.json; JWT vydáva Monitor."
},
{
"card": "SSL / HTTPS",
"endpoint": "/api/auth/ssl/*",
"source": "<code>openssl x509</code> na <code>/etc/pve/local/pve-ssl.pem</code> + <code>/etc/proxmenux/ssl_config.json</code>."
},
{
"card": "Zoznam, vytváranie a odvolávanie tokenov API",
"endpoint": "/api/auth/api-tokens",
"source": "Údaje tokenov sú uložené lokálne; nič neopúšťa hostiteľa."
},
{
"card": "Secure Gateway (nasadenie a stav)",
"endpoint": "/api/oci/*",
"source": "Vytvorí kontajner LXC Alpine s <code>tailscaled</code> pomocou <code>pct create</code> / <code>pct exec</code>."
},
{
"card": "Stav a pravidlá firewallu",
"endpoint": "/api/security/firewall/*",
"source": "<code>pve-firewall</code> + <code>/etc/pve/firewall/&lt;cluster|host&gt;.fw</code>."
},
{
"card": "Fail2Ban (iba po nainštalovaní)",
"endpoint": "/api/security/fail2ban/*",
"source": "<code>fail2ban-client status</code>, <code>/var/log/fail2ban.log</code>, <code>/etc/fail2ban/jail.local</code>."
},
{
"card": "Audit Lynis (iba po nainštalovaní)",
"endpoint": "/api/security/lynis/*",
"source": "Spúšťa <code>lynis audit system</code> v pozadí; správa spracovaná z <code>/var/log/lynis-report.dat</code>."
}
]
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Prístup a overenie",
"href": "/docs/monitor/access-auth",
"tail": " — celé úvodné nastavenie, výber aplikácie 2FA, obnova po strate autentifikátora a príklady reverzného proxy."
},
{
"label": "Integrácie",
"href": "/docs/monitor/integrations",
"tail": " — príklady použitia tokenov API s Homepage, Home Assistant, Prometheus a n8n a celý postup nastavenia Secure Gateway."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tailRich": " — všetky koncové body <code>/api/auth</code>, <code>/api/security</code> a <code>/api/oci</code> s metódou, telom požiadavky a príkladmi curl."
},
{
"label": "ProxMenux → Bezpečnosť → Fail2Ban",
"href": "/docs/security/fail2ban",
"tail": " — postup inštalácie, nastavené jaily a ručná inštalácia."
},
{
"label": "ProxMenux → Bezpečnosť → Lynis",
"href": "/docs/security/lynis",
"tail": " — príklad správy, vysvetlenie skóre a kedy audit zopakovať."
}
]
}
}
@@ -0,0 +1,367 @@
{
"meta": {
"title": "ProxMenux Monitor — Prehľad: karta Nastavenia | Dokumentácia ProxMenux",
"description": "Karta Nastavenia spravuje jazyk, poradie navigácie, predvoľby prehľadu, prahy a vylúčenia monitorovania, oznámenia, AI a inventár úprav po inštalácii."
},
"header": {
"title": "Prehľad: karta Nastavenia",
"description": "Jazyk Monitora, poradie navigácie, predvoľby prehľadu, vylúčenia monitorovania, oznámenia, nastavenia AI a aktuálny inventár optimalizácií ProxMenux.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Kde sa ukladá každé nastavenie",
"body": "Nastavenia spájajú zobrazenie prehľadu, monitorovanie Health Monitor, odosielanie výstrah a zmeny už vykonané ProxMenuxom na hostiteľovi. Karty odkazujú na podrobnú dokumentáciu; tu nájdete vstupný bod."
},
"interfaceLanguage": {
"heading": "Jazyk rozhrania",
"intro": "Vyberte jazyk <strong>webového rozhrania Monitora</strong>. Zmena platí ihneď, bez reštartu služby či zmeny jazyka terminálových ponúk ProxMenux.",
"items": [
"ProxMenux Monitor v súčasnosti ponúka angličtinu, nemčinu, španielčinu, francúzštinu, taliančinu, portugalčinu, slovenčinu a švédčinu.",
"Pri prvej návšteve použije jazyk prehliadača, ak je podporovaný; inak angličtinu.",
"Zmena výberu upraví jazyk stránky a zosúladí ostatné otvorené karty rovnakého profilu prehliadača.",
"Ak chýba preklad, iba daný text sa zobrazí v angličtine namiesto chybného kľúča alebo zástupného textu."
],
"scopeTitle": "Lokálna predvoľba prehliadača",
"scopeBody": "Výber je uložený v <code>localStorage</code> pod <code>proxmenux-ui-language</code>. Platí pre tento profil prehliadača a zariadenie, nie pre celý uzol. Každý správca si môže vybrať vlastný jazyk."
},
"navigationOrder": {
"heading": "Poradie navigácie",
"intro": "Usporiadajte sedem hlavných položiek: <strong>Prehľad, Aplikácie, VM a LXC, Uzol, Záloha, Terminál a Správa</strong>. Stlačte <strong>Upraviť</strong>, presuňte riadky a uložte.",
"items": [
"Myšou sa presúvanie začne stlačením. Dotyková obrazovka vyžaduje podržanie 250 ms, aby sa odlíšilo od rolovania.",
"Skupiny <strong>Uzol</strong> a <strong>Správa</strong> sa presúvajú celé; ich vnútorné stránky si zachovajú určené poradie.",
"Mobilná ponuka používa rovnaké uložené poradie.",
"<strong>Obnoviť predvolené</strong> obnoví upravované poradie. Zmenu použijete uložením.",
"Nové hlavné karty budúcich verzií sa pridajú na koniec vlastného poradia a zachovajú vaše usporiadanie."
],
"landingTitle": "Prvá položka sa stane úvodnou kartou",
"landingBody": "Monitor otvorí prvú uloženú položku. Pri <strong>Uzol</strong> otvorí Úložisko, pri <strong>Správa</strong> Systémové záznamy. Poradie je v tomto prehliadači pod <code>proxmenux-nav-order</code>, takže každé zariadenie môže mať vlastné usporiadanie."
},
"networkUnits": {
"heading": "Jednotky siete",
"imageAlt": "Karta Jednotky siete s výberom zobrazenia na Bajty",
"imageCaption": "Vyberte bity alebo bajty za sekundu pre všetky sieťové rýchlosti v prehľade.",
"body": "Zobrazuje priepustnosť v <strong>bitoch za sekundu</strong> (Mbps/Gbps) alebo <strong>bajtoch za sekundu</strong> (MB/s/GB/s). Predvolené sú bity ako v špecifikáciách kariet a poskytovateľov; prenosy súborov často používajú bajty. Grafy, štítky a pomôcky sa zmenia ihneď bez obnovenia."
},
"health": {
"heading": "Monitor zdravia",
"intro": "Karta nastavuje <strong>trvanie potlačenia</strong>: ako dlho čakať pred opätovným oznámením zamietnutej výstrahy. Každá kategória — CPU, pamäť, úložisko, disky, sieť, VM, služby PVE, záznamy, aktualizácie a zabezpečenie — má vlastný zoznam:",
"items": [
"<strong>24 h</strong> Predvolené pre väčšinu prechodných kategórií.",
"<strong>72 h</strong> — na stíšenie týchto udalostí na niekoľko dní.",
"<strong>168 h</strong> (1 týždeň) a <strong>720 h</strong> (1 mesiac) — pravidelné kontroly.",
"<strong>8760 h</strong> (1 rok) — stíšenie na dlhé obdobie.",
"<strong>-1</strong> — trvalé stíšenie až do ručného opätovného zapnutia.",
"<strong>Vlastný počet hodín</strong> — celé číslo pre inú požadovanú hodnotu."
],
"imageAlt": "Nastavenia, karta Health Monitor s trvaním podľa kategórie a aktívnymi potlačeniami",
"imageCaption": "Zoznamy určujú trvanie budúcich potlačení. Dolná časť zobrazuje stíšené výstrahy a umožňuje ich znova zapnúť.",
"editTitle": "Režim úprav",
"editBody": "Karta je najprv iba na čítanie. <strong>Upraviť</strong> vpravo hore zapne zoznamy a tlačidlá obnovenia. <strong>Uložiť</strong> naraz použije čakajúce zmeny trvania a obnovenia; <strong>Zrušiť</strong> ich zahodí. Uložiť sa zapne až pri zmenách.",
"activeTitle": "Aktívne potlačenia",
"activeIntro": "Pod trvaním časť <strong>Aktívne potlačenia</strong> uvádza dočasne stíšené výstrahy —24 h, 7 dní alebo iné obdobie— aj <em>trvalé</em>. Každý riadok zobrazuje:",
"activeItems": [
"Farebný odznak: <strong>Trvalo</strong> v jantárovej farbe alebo odpočet, napríklad <strong>zostáva 24 h</strong> / <strong>zostáva 7 dní</strong>, v modrej.",
"Identifikátor výstrahy v čitateľnej forme (napr. <code>pve_storage_full_PBS-Cloud</code> → <em>Plné úložisko PVE: PBS-Cloud</em>).",
"Kategória, závažnosť a čas zamietnutia výstrahy.",
"Tlačidlo <strong>Znova zapnúť</strong> v režime úprav pripraví zrušenie potlačenia pri uložení."
],
"activeReenableTitle": "Ako znova zapnúť výstrahu",
"activeReenableBody": "<strong>Znova zapnúť</strong> pri úprave označí riadok zeleno a prečiarkne identifikátor, ale zmena ešte neplatí. Opätovné kliknutie umožní <strong>Vrátiť späť</strong>. <strong>Uložiť</strong> odošle súbežne <code>POST /api/health/un-acknowledge</code> pre každé obnovenie a odstráni riadky. Ak problém trvá a kategória povoľuje opakovanie, výstraha sa vráti medzi aktívne pri ďalšej kontrole.",
"activePermanentNote": "Trvalé potlačenia cez <em>Natrvalo</em> alebo predvolené trvanie <code>-1</code> <strong>možno zrušiť iba tu</strong>. Hlavné okno toto tlačidlo nemá; táto časť spája zoznam a obnovenie.",
"activeAutoRefreshTitle": "Automatické obnovenie",
"activeAutoRefreshBody": "Zoznam sa obnoví pri zamietnutí alebo zapnutí výstrahy v Health Monitor, pri návrate na kartu a pri zmene viditeľnosti. Stránku netreba načítať znova.",
"calloutTitle": "Podrobnosti na stránke Health Monitor",
"calloutBody": "Eskaláciu, automatické vyriešenie pri zmiznutí zariadenia a rozdiel medzi zamietnutím a vyriešením opisuje <link>Health Monitor → Zamietnutie výstrah a trvanie potlačenia</link>. Táto karta ponúka zoznamy a aktívne potlačenia."
},
"thresholds": {
"heading": "Prahy Health Monitor",
"intro": "Predchádzajúca karta určuje <em>trvanie stíšenia po potlačení</em>; táto nastavuje <strong>hodnotu spustenia výstrahy</strong>. Väčšina kontrol má nastaviteľný <strong>varovný</strong> a <strong>kritický</strong> prah. Tabuľka vysvetľuje výnimky, napríklad kombinované pravidlo swapu a aktuálny detektor RAM.",
"whatForTitle": "Na čo slúži",
"whatForIntro": "Predvolené hodnoty sú východiskom, ale každé prostredie má vlastné podmienky:",
"whatForItems": [
"Homelab s jediným SSD môže varovať skôr, napríklad pri 75/90 %, aby zostalo miesto na snímky.",
"Prahy pamäte majú vychádzať z meraní a záťaže hostiteľa. Redundancia Ceph sama neodôvodňuje miernejšie varovania a vysoké využitie ARC ZFS neznamená neuvoľniteľnú pracovnú pamäť.",
"Teplotné prahy vyberte podľa špecifikácií disku a skutočných podmienok. Pasívne alebo nútené chladenie samo neurčuje univerzálne nižší či vyšší bezpečný limit.",
"Silne virtualizovaný hostiteľ môže pri zostavovaní dosiahnuť špičky CPU bez výstrahy pri každom 80 % výkyve, ale musí upozorniť na trvalé preťaženie."
],
"whatForOutro": "Podporované zmeny platia <strong>pri ďalšej kontrole</strong>. Health Monitor číta <code>/usr/local/share/proxmenux/health_thresholds.json</code> v každom cykle bez reštartu. Niektoré ukazovatele, napríklad teplota diskov, používajú tieto hodnoty; niektoré kapacitné pruhy majú vlastné hranice. Riadok RAM vysvetľuje aktuálnu výnimku.",
"coloursTitle": "Farby stavov Varovanie a Kritické",
"coloursIntro": "Widgety s nastavenou dvojicou Varovanie/Kritické používajú tri stavy nižšie. Iné ukazovatele, napríklad kapacitné pruhy PVE, majú vlastné hranice; samotná farba nedokazuje výstrahu Health Monitor.",
"headerColour": "Farba",
"headerRange": "Rozsah",
"headerMeaning": "Význam",
"colourRows": [
{
"colour": "Zelená",
"range": "Hodnota < varovný prah",
"meaning": "Normálny rozsah. Nevzniká výstraha."
},
{
"colour": "Oranžová",
"range": "Varovný prah ≤ hodnota < kritický prah",
"meaning": "Varovný stav. Health Monitor vytvorí udalosť WARNING; oznámenia rešpektujú filtre kanála a tiché hodiny."
},
{
"colour": "Červená",
"range": "Hodnota ≥ kritický prah",
"meaning": "Kritický stav. Health Monitor vytvorí udalosť CRITICAL, ktorá obíde tiché hodiny. Nastavenia kategórií a udalostí kanála stále platia; doručenie závisí aj od dostupnosti kanála."
}
],
"sectionsTitle": "Časti a odporúčané predvolené hodnoty",
"sectionsIntro": "Sú to úvodné hodnoty ProxMenux, kým ich nezmeníte. Časti nasledujú <em>výpočtovú záťaž</em>, <em>teplotu</em> a <em>kapacitu úložiska</em>, od aktuálnej záťaže po obsadené miesto.",
"headerSection": "Oddiel",
"headerWarning": "Varovný prah",
"headerCritical": "Kritický prah",
"headerGates": "Riadená kontrola",
"thresholdRows": [
{
"section": "Využitie CPU",
"warning": "85 %",
"critical": "95 %",
"gates": "Výstraha trvalej záťaže, keď priemerné využitie CPU prekročí prah počas kontrolného obdobia."
},
{
"section": "Pamäť",
"warning": "85 %",
"critical": "95 %",
"gates": "Tlak na RAM hostiteľa. Nastavenie uvádza kritický prah 95 %, ale aktuálny detektor používa pevné pravidlo trvalých 90 %; zmena nastavenia teraz nemení túto vetvu."
},
{
"section": "Swap (iba kritická hranica)",
"warning": "—",
"critical": "80 %",
"gates": "Swap CRITICAL vyžaduje súčasne viac než 80 % swapu a menej než 15 % dostupnej RAM počas viacerých meraní. Samotný obsadený swap pravidlo nespustí."
},
{
"section": "Teplota CPU",
"warning": "80 °C",
"critical": "90 °C",
"gates": "Teplota puzdra CPU alebo jadier z <code>lm-sensors</code>."
},
{
"section": "Teplota disku — HDD",
"warning": "60 °C",
"critical": "65 °C",
"gates": "Teplota HDD. Predvolene varovanie pri 60 °C a kritické pri 65 °C. Sú to hodnoty monitorovania, nie univerzálny limit výrobcu; overte špecifikácie modelu."
},
{
"section": "Teplota disku — SSD",
"warning": "70 °C",
"critical": "75 °C",
"gates": "SATA SSD vo formáte 2,5 palca alebo M.2. Táto trieda používa predvolene 70/75 °C; skutočné limity závisia od modelu."
},
{
"section": "Teplota disku NVMe",
"warning": "80 °C",
"critical": "85 °C",
"gates": "Teplota NVMe. Táto trieda používa predvolene 80/85 °C. Teplota obmedzovania radiča závisí od modelu a nie je vždy 85 °C."
},
{
"section": "Teplota disku — SAS",
"warning": "55 °C",
"critical": "65 °C",
"gates": "Teplota SAS. Táto trieda používa varovanie pri 55 °C a kritické pri 65 °C. Sú to <em>predvoľby monitorovania</em>, nie dôkaz poruchy chladenia pri 55 °C ani univerzálny limit výrobcu."
},
{
"section": "Miesto na disku — hostiteľ",
"warning": "85 %",
"critical": "95 %",
"gates": "Kapacita <code>/</code> a každého bodu pripojenia hostiteľa (<code>/var/lib/vz</code>, <code>/mnt/*</code>…)."
},
{
"section": "Miesto na disku LXC rootfs",
"warning": "85 %",
"critical": "95 %",
"gates": "Koreňový disk každého kontajnera, hodnotený podľa veľkosti rootfs z PVE."
},
{
"section": "Prípojné body LXC",
"warning": "85 %",
"critical": "95 %",
"gates": "Kapacita pripojení v spustených CT: mp0, mp1, NFS a bind mount. Bez rootfs."
},
{
"section": "PVE úložisko",
"warning": "85 %",
"critical": "95 %",
"gates": "Úložiská spravované PVE: LVM, LVM-thin, ZFS-pool, RBD/Ceph a PBS. Nie všetky sú blokové úložiská."
},
{
"section": "ZFS pool",
"warning": "85 %",
"critical": "95 %",
"gates": "Fondy ZFS na hostiteľovi, nezávisle od registrácie v PVE."
}
],
"defaultsTitle": "Predvolené hodnoty, zmeny a obnovenie",
"defaultsBody": "Každá časť začína predvolenými hodnotami; ukladáte iba želané zmeny. Karta ukazuje <em>platnú</em> hodnotu: vašu zmenu alebo predvoľbu. <strong>Obnoviť</strong> odstráni všetky zmeny vo všetkých častiach.",
"validationTitle": "Overenie",
"validationBody": "Pri ukladaní sa kontrolujú povolené rozsahy a odmietne sa kritický prah pod varovným. Rozhranie zobrazuje chyby a server pred uložením znovu overí požiadavky API."
},
"lxcDetection": {
"heading": "Kontrola aktualizácií v LXC",
"imageAlt": "Karta zisťovania aktualizácií LXC s prepínačom hľadania balíkov v spustených kontajneroch Debian, Ubuntu a Alpine",
"imageCaption": "Prepínač pravidelnej kontroly cez <code>apt list --upgradable</code> / <code>apk list -u</code> v spustených CT. Predvolene zapnutý. Súvisiaci prepínač v Oznámenia → Služby sa zobrazuje pri zapnutej detekcii.",
"intro": "Prepínač medzi Prahmi a Oznámeniami riadi kontrolu LXC. Zapnutý zisťuje balíky spustených CT; Hardvér zobrazuje výsledky a vstupujú do <code>lxc_updates_available</code>. Vypnutý zastaví volania <code>pct exec</code> a odstráni záznamy LXC z <code>managed_installs.json</code>; <code>/api/managed-installs</code> prestane hlásiť stav bez čakania 24 hodín.",
"whatRunsTitle": "Čo kontrola spúšťa",
"whatRunsIntro": "Pre každý CT v stave <code>running</code> s podporovaným správcom balíkov:",
"whatRunsItems": [
"<strong>Aktuálnosť metadát.</strong> Ak je cache apt/apk staršia než <strong>24 hodín</strong>, pokúsi sa o <code>apt-get update -qq</code> na Debian/Ubuntu alebo <code>apk update</code> na Alpine s limitom 60 s. Pri zlyhaní zoznam použije dostupnú, možno zastaranú cache.",
"<strong>Zoznam.</strong> Spustí <code>apt list --upgradable</code> / <code>apk list -u</code> a získa počet balíkov a niekoľko názvov.",
"<strong>Odstránenie duplicít pre CT.</strong> Odtlačok počtu, bezpečnostných aktualizácií a zoradených názvov zabráni dennému opakovaniu rovnakej sady. Významná zmena vyvolá nové oznámenie."
],
"selfUpdateTitle": "CT aktualizované mimo apt môžu hlásiť 0",
"selfUpdateBody": "Detekcia pokrýva iba správcu balíkov CT. Softvér aktualizovaný mimo apt, napríklad nastavená úloha <code>plexupdate</code> alebo obrazy získané cez <code>docker pull</code>, sa nepočíta. Nula aktualizácií apt nedokazuje aktuálnosť všetkých aplikácií. Balíky základného systému sa naďalej zisťujú.",
"refreshTitle": "Prečo obnovovať metadáta po 24 hodinách",
"refreshBody": "Dlho bežiaci CT môže mať staré metadáta apt, ak nikto nespúšťa <code>apt update</code>. <code>apt list --upgradable</code> potom môže prehliadnuť nové aktualizácie. ProxMenux skúsi obnovu po 24 hodinách a pri novšej cache ju vynechá.",
"toggleTitle": "Prepínač oznámení pri zapnutej detekcii",
"toggleBody": "Prepínač <code>lxc_updates_available</code> pre každý kanál v <strong>Oznámenia → Služby</strong> sa zobrazuje iba pri zapnutej detekcii. Vypnutie skryje riadok vo všetkých kanáloch. Voľba zostáva v databáze a po zapnutí sa obnoví pôvodná hodnota.",
"purgeTitle": "Čo sa odstráni pri vypnutí detekcie",
"purgeBody": "Vypnutie ihneď odstráni záznamy <code>type=lxc</code> z <code>/usr/local/share/proxmenux/managed_installs.json</code>. Po obnovení Hardvér prestane zobrazovať počty aktualizácií LXC. Po zapnutí register naplní ďalší cyklus, prípadne skoršie ručné obnovenie cez API."
},
"storageExclusions": {
"heading": "Vylúčené vzdialené úložiská",
"imageAlt": "Karta vylúčení vzdialených úložísk PBS-Cloud, PBS a PBS2 s prepínačmi Stav a Výstrahy pre každý riadok",
"imageCaption": "Prepínače <em>Stav</em> a <em>Výstrahy</em> pre každé úložisko. Ak sú oba vypnuté, úložisko sa nehodnotí v Health Monitor a neposiela oznámenia. Na karte Úložisko zostáva viditeľné ako vylúčené.",
"intro": "Úložiská spravované Proxmoxom (NFS / CIFS / PBS / Ceph / iSCSI / atď.) môžete vylúčiť dvoma nezávislými prepínačmi:",
"items": [
"<strong>Stav</strong> — vypnutie prepínača vyradí úložisko z kategórie Úložisko v Health Monitor. Užitočné pre zväzky archívu, ktoré bývajú offline, alebo vzdialené ciele záloh zapínané iba podľa plánu.",
"<strong>Výstrahy</strong> — vypnutie zastaví oznámenia o tomto úložisku cez nastavené kanály, aj pri zapnutých kontrolách stavu. Užitočné, ak chcete sledovať stav na paneli bez oznámení."
],
"outro": "Vylúčené úložiská zostávajú na <link>karte Úložisko</link> s fialovým odznakom <em>vylúčené</em>, aby nezmizli z inventára. Stav sa ukladá do tabuľky SQLite <code>excluded_storages</code>."
},
"interfaceExclusions": {
"heading": "Vylúčené sieťové rozhrania",
"imageAlt": "Karta vylúčení rozhraní vmbr0, vmbr1, vmbr2, bond0 a eno1 s prepínačmi Stav a Výstrahy pre každé rozhranie",
"imageCaption": "Rovnako ako pri úložisku má každé rozhranie prepínače <em>Stav</em> a <em>Výstrahy</em>. Riadok zobrazuje názov, typ (most / agregácia / fyzické), IP a rýchlosť spojenia.",
"intro": "Rovnaký princíp platí pre rozhrania: každé možno vylúčiť z kontrol stavu, oznámení alebo oboch. Bežné príklady:",
"items": [
"Zámerne vypnutý záložný most.",
"Fyzicky odstránená sieťová karta, ktorá zostáva uvedená v <code>/etc/network/interfaces</code>.",
"Podrozhranie VLAN používané iba počas údržby.",
"Správcovský most so známymi opakovanými zmenami stavu spojenia počas údržby."
],
"outro": "Stav sa ukladá do tabuľky SQLite <code>excluded_interfaces</code>. Fialový odznak <em>vylúčené</em> na <link>karte Sieť</link> ponechá vylúčené rozhrania viditeľné."
},
"notifications": {
"heading": "Oznámenia a AI",
"body1": "Tu zapnete oznámenia ProxMenux Monitor a preformulovanie pomocou AI. <em>Zapnúť oznámenia</em> spustí odosielanie na pozadí, zaregistruje cieľ webhooku Proxmox VE na príjem jeho udalostí a otvorí nastavenia kanálov Telegram, Discord, email, Gotify a ďalších. AI je v rozbaľovacej rozšírenej časti toho istého panela.",
"body2": "Možnosti vysvetľujú samostatné stránky: kanály, prepínače udalostí, formátované správy, zobrazované meno, odosielanie s odstránením duplicít, odstupom, zoskupením a tichým časom, webhook PVE, poskytovatelia AI a režimy pokynov:",
"items": [
"<notifLink>Oznámenia</notifLink>: nastavenie kanálov (Telegram, Discord, Gotify, email a heslá aplikácií Gmail / Microsoft, ntfy, Slack, Teams a všeobecný webhook), kategórie udalostí, formátované správy, zobrazované meno, odosielanie, webhook PVE, história a API.",
"<aiLink>Asistent AI</aiLink>: poskytovatelia (OpenAI, Anthropic, Gemini, Groq, OpenRouter, Ollama), modely, predvolené alebo vlastné pokyny, jazyk výstupu, podrobnosť pre kanály a návrhy AI."
]
},
"optimizations": {
"heading": "Optimalizácie ProxMenux",
"intro": "Inventár optimalizácií po inštalácii zaznamenaných ProxMenuxom na hostiteľovi. Voľby z <autoLink>Automatizované úpravy po inštalácii</autoLink> a <customLink>Prispôsobiteľné úpravy po inštalácii</customLink> zaznamenajú použitie v <code>/usr/local/share/proxmenux/installed_tools.json</code>. Monitor číta tento register. Záznam znovu nekontroluje, či všetky nastavenia zostali nezmenené.",
"imageAlt": "Karta optimalizácií ProxMenux so 14 záznamami: farebná bodka, názov a verzia. Obsahuje APT IPv4 Force, Bashrc Customization, Fastfetch, Log2ram SSD Protection, Memory Settings Optimization, Setting persistent network interfaces, System Limits Increase, APT Language Skip, Entropy Generation haveged s Legacy, Kernel Panic Configuration, Logrotate Optimization, Network Optimizations, Subscription Banner Removal a VFIO IOMMU Passthrough.",
"imageCaption": "Každá optimalizácia zobrazuje názov, verziu a farebnú bodku. Vpravo hore je oranžový počet <em>14 aktívnych</em>. Nástroje s dostupným zdrojovým kódom možno otvoriť.",
"dotsTitle": "Čo znamenajú bodky",
"dotsItems": [
"<green/> <strong>Zelená bodka</strong>: zaznamenaná optimalizácia bez označenia Legacy a dostupnej aktualizácie. Kliknite na riadok, ak je dostupný zdrojový kód.",
"<amber/> <strong>Jantárová bodka a odznak <em>legacy</em></strong>: zaznamenaná optimalizácia, ktorej skript bol premenovaný alebo nahradený. Zachovaný kód sa otvorí v režime Legacy s jantárovým zvýraznením. Aktuálnu konfiguráciu hostiteľa znovu neoveruje."
],
"clickTitle": "Otvorenie zdrojového kódu",
"clickBody": "Kliknutie otvorí priradenú funkciu bash a názov skriptu (<code>auto_post_install.sh</code> alebo <code>customizable_post_install.sh</code>). Aktuálne nástroje sa získavajú zo súborov hostiteľa, staršie môžu používať zachovaný kód. Pomáha zvýraznenie syntaxe a Kopírovať. Nejde o zaručenú snímku presného kódu spusteného pri inštalácii.",
"detailAlt": "Okno kódu APT IPv4 Force s funkciou bash force_apt_ipv4 z customizable_post_install.sh verzie 1.0. Zvýraznený kód nastavuje /etc/apt/apt.conf.d/99-force-ipv4 pomocou Acquire ForceIPv4 true, registruje nástroj a zobrazuje preloženú správu o dokončení konfigurácie APT IPv4.",
"detailCaption": "Kód <em>APT IPv4 Force</em>: funkcia <code>force_apt_ipv4()</code> z <code>customizable_post_install.sh v1.0</code> so zvýraznením syntaxe a kopírovaním jedným kliknutím.",
"whyTitle": "Prečo na tom záleží",
"whyBody": "ProxMenux môže meniť parametre jadra, repozitáre, sieť, rotáciu protokolov a odovzdanie GPU. Pred ručnými zmenami si pozrite zaznamenané optimalizácie, najmä ak hostiteľa nastavil iný správca. Karta ukazuje register a dostupný kód; neoveruje všetky aktuálne nastavenia ani neuchováva presnú históriu vykonania.",
"updatesTitle": "Oznam dostupných aktualizácií",
"updatesBody": "Ak je verzia optimalizácie na disku novšia než zaznamenaná na hostiteľovi, zobrazí sa oznam s počtom a <strong>Použiť</strong>. <strong>Použiť</strong> otvorí výber optimalizácií, rovnako ako <em>Použiť dostupné aktualizácie</em> v ponuke po inštalácii. Vyberte aktualizácie; ProxMenux znova spustí funkcie a upraví register. Keď je všetko aktuálne, oznam zmizne.",
"updatesAlt": "Karta optimalizácií ProxMenux s oznamom dostupných aktualizácií, ich počtom a tlačidlom Použiť na otvorenie výberu",
"updatesCaption": "Oznam sa objaví, ak má aspoň jedna optimalizácia novšiu verziu na disku. Pozrite <link>Použiť dostupné aktualizácie</link> pre celý postup a zodpovedajúcu voľbu Path-A v ponuke shellu.",
"revertTitle": "Vrátenie optimalizácie späť",
"revertBody": "Optimalizáciu vrátite späť príslušnou voľbou <link>Odinštalovať optimalizácie</link> v ponuke ProxMenux Scripts. Odinštalovanie odstráni záznam z <code>installed_tools.json</code> a pri ďalšom obnovení zmizne z karty."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerCard": "Karta",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"card": "Jazyk rozhrania",
"endpoint": "localStorage",
"source": "Voľba prehliadača <code>proxmenux-ui-language</code>; ak nie je uložený výber, najprv sa použije jazyk prehliadača."
},
{
"card": "Poradie navigácie",
"endpoint": "localStorage",
"source": "Voľba prehliadača <code>proxmenux-nav-order</code>; určuje aj úvodnú kartu."
},
{
"card": "Jednotky siete",
"endpoint": "/api/settings",
"source": "Uložené v tabuľke nastavení SQLite panela."
},
{
"card": "Trvanie v Health Monitor",
"endpoint": "/api/health/settings",
"source": "Trvanie potlačenia podľa kategórie v databáze Health Monitor."
},
{
"card": "Vylúčenie úložiska / rozhrania",
"endpoint": "/api/storage/exclusions, /api/network/exclusions",
"source": "SQLite tabuľky <code>excluded_storages</code> a <code>excluded_interfaces</code>."
},
{
"card": "Panel Oznámenia a AI",
"endpoint": "/api/notifications/*",
"source": "Pozrite <notifLink>Oznámenia</notifLink> a <aiLink>Asistent AI</aiLink>."
},
{
"card": "Zoznam optimalizácií ProxMenux",
"endpoint": "/api/proxmenux/installed-tools",
"source": "Číta <code>/usr/local/share/proxmenux/installed_tools.json</code>, kam zapisujú volania <code>register_tool</code> v skriptoch po inštalácii."
},
{
"card": "Okno kódu optimalizácie",
"endpoint": "/api/proxmenux/tool-source",
"source": "Získa priradenú funkciu bash z <code>auto_post_install.sh</code> alebo <code>customizable_post_install.sh</code> na hostiteľovi; staršie nástroje môžu používať zachovaný kód."
}
]
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Záložka aplikácií",
"href": "/docs/monitor/dashboard/apps",
"tail": " — spúšťač, ktorého polohu určíte v poradí navigácie."
},
{
"label": "Oznámenia",
"href": "/docs/monitor/notifications",
"tail": " — kanály, prepínače udalostí, vlastné nastavenia kanálov, história a skúšobné odoslanie."
},
{
"label": "AI asistent",
"href": "/docs/monitor/ai-assistant",
"tail": " — poskytovatelia, modely, režimy pokynov, jazyky a podrobnosť pre kanály."
},
{
"label": "Health Monitor → Potlačenie výstrah a jeho trvanie",
"href": "/docs/monitor/health-monitor#dismissing-alerts-and-the-suppression-duration",
"tail": " — ako fungujú vyššie uvedené zoznamy trvania podľa kategórie."
},
{
"label": "ProxMenux Scripts → Automatizované úpravy po inštalácii",
"href": "/docs/post-install/automated",
"tailRich": " a <customLink>Prispôsobiteľné úpravy po inštalácii</customLink> — skripty, ktoré zapisujú optimalizácie do vyššie uvedeného zoznamu."
},
{
"label": "Odinštalovať optimalizácie",
"href": "/docs/post-install/uninstall",
"tail": " — ako vrátiť späť vyššie zaznamenanú optimalizáciu."
},
{
"label": "Prehľad panela",
"href": "/docs/monitor/dashboard",
"tail": " — späť na prehľad kariet."
}
]
}
}
@@ -0,0 +1,268 @@
{
"meta": {
"title": "ProxMenux Monitor — Prehľad: karta Úložisko | Dokumentácia ProxMenux",
"description": "Karta Úložisko spája štyri zobrazenia: úložiská Proxmox so stavom, pooly ZFS, interné disky so SMART a externé disky USB. Detail disku ukazuje atribúty SMART, opotrebovanie, životnosť a trvalú históriu pozorovaní."
},
"header": {
"title": "Prehľad: karta Úložisko",
"description": "Úložiská hostiteľa na jednej obrazovke: NFS / CIFS / LVM / ZFS / dir Proxmox, stav poolov ZFS, interné disky SATA/NVMe so SMART a externé disky USB. Kliknutím na disk zobrazíte atribúty SMART a históriu pozorovaní.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Podporované tromi zdrojmi",
"body": "Úložiská Proxmox pochádzajú z <code>pvesm status</code>, ZFS zo <code>zpool status</code>, disky z <code>lsblk</code> + <code>smartctl</code> a polia NVMe z <code>nvme</code>. Karta sa obnovuje približne každých 60 sekúnd; otvorenie detailu vyžiada načítanie SMART."
},
"thresholds": {
"title": "Farby stavu a prahové hodnoty, ktoré sa tu uplatňujú",
"intro": "Health Monitor hodnotí stav ako <green/> <strong>zelený</strong> pod varovaním, <amber/> <strong>oranžový</strong> medzi varovaním a kritickým prahom a <red/> <strong>červený</strong> od kritického prahu. Nasledujú predvolené hodnoty. Jednotlivé pruhy môžu používať iné farebné hranice opísané nižšie.",
"items": [
"<strong>Kapacita</strong> (disky hostiteľa, úložiská PVE, pooly ZFS, pripojenia LXC) — varovanie 85 %, kritické 95 %.",
"<strong>Teplota disku</strong> HDD 60/65 °C · SSD 70/75 °C · NVMe 80/85 °C · SAS 55/65 °C (varovanie/kritické)."
],
"outro": "Každú hodnotu možno nastaviť pre hostiteľa. <link>Nastavenia → Prahy Health Monitor</link> uvádza rozhodujúce hodnoty a vysvetľuje ich úpravu."
},
"topRow": {
"heading": "Horný riadok: prehľad úložísk",
"intro": "Po otvorení štyri karty zhŕňajú celkovú kapacitu, miestne využitie, vzdialené využitie a zoznam fyzických diskov. Poskytujú rýchle odpovede; karty nižšie obsahujú podrobnosti.",
"imageAlt": "Karta Úložisko so štyrmi kartami: celková kapacita, miestne využitie, vzdialené využitie a fyzické disky",
"imageCaption": "Horný riadok: celková kapacita a počet diskov, miestne a vzdialene použité bajty a fyzické disky podľa typu so súhrnom stavu.",
"headerCard": "Karta",
"headerWhat": "Čo ukazuje",
"totalLabel": "Celková kapacita",
"totalWhat": "Celková hrubá kapacita všetkých fyzických diskov. Päta uvádza počet zistených diskov.",
"localLabel": "Lokálne využité",
"localWhat": "Použité bajty na miestnych úložiskách: LVM / LVM-thin / ZFS / dir na diskoch hostiteľa. Hlavná hodnota ukazuje použité bajty a päta <em>X.XX % z Y TB</em> aj percento zaplnenia.",
"remoteLabel": "Vzdialené využitie",
"remoteWhat": "Rovnaký formát ako miestne využitie pre vzdialené úložiská NFS / CIFS / PBS / Ceph / iSCSI. Počítajú sa oddelene, pretože miestne a vzdialené poruchy majú iný dosah a zdroje sa plánujú a monitorujú odlišne.",
"disksLabel": "Fyzické disky",
"disksIntro": "Dva riadky členenia pre súpis:",
"disksItems": [
"<strong>Podľa typu</strong> — počet NVMe fialovo, SSD a HDD modro. Zobrazujú sa zistené typy; hostiteľ iba s NVMe ukazuje len tento počet.",
"<strong>Podľa stavu</strong> — počet <em>normálnych</em> diskov zeleno, s <em>varovaním</em> žlto a <em>kritických</em> červeno. Bez problémov sa ukáže len „X normálnych“; ďalšie stavy sa zobrazia pri zistení problému."
]
},
"pveStorage": {
"heading": "Skladovacia karta Proxmox",
"intro": "Riadok pre každé úložisko z <code>/etc/pve/storage.cfg</code> s typom (<code>nfs</code> / <code>cifs</code> / <code>zfspool</code> / <code>lvm</code> / <code>lvmthin</code> / <code>dir</code> / <code>pbs</code>), názvom, stavom aktívne/chyba/nemonitorované, percentom využitia a farebným pruhom:",
"items": [
"<strong>Do 75 %</strong> — modrý pruh a hodnota.",
"<strong>Nad 75 % do 90 %</strong> — žltý pruh a hodnota. Farebné hranice sú oddelené od prahov Health Monitor.",
"<strong>> 90 %</strong> — červený pruh a hodnota. Táto farebná hranica je oddelená od eskalácie v Health Monitor.",
"<strong>Chyba</strong> — červený rám riadka, ak je úložisko nastavené, ale nedostupné, napríklad pri výpadku NFS alebo neplatných prihlasovacích údajoch CIFS.",
"<strong>Vylúčené</strong> — fialový rám a štítok „nemonitorované“. Úložiská vylúčené používateľom, napríklad zámerne odpojené archívne zväzky."
],
"calloutTitle": "Vylúčiť úložisko z monitorovania",
"calloutBody": "Ponuka úložiska ho umožňuje označiť ako <em>vylúčené z monitorovania</em>. Nastavenie je v <code>excluded_storages</code> a rešpektuje ho prehľad aj Health Monitor: bez oznámení a vplyvu na celkový stav."
},
"zfs": {
"heading": "ZFS Pools karta",
"intro": "Zobrazuje sa iba s nainštalovaným ZFS a aspoň jedným poolom. Každý riadok ukazuje pool so stavom, veľkosťou, prideleným a voľným miestom a ikonou stavu:",
"items": [
"<strong>ONLINE</strong> — zelená. Všetko zdravé.",
"<strong>DEGRADED</strong> — žltá. Pool poskytuje dáta, ale aspoň jedno zariadenie je nedostupné; treba riešiť jeho výmenu.",
"<strong>FAULTED</strong> / <strong>UNAVAIL</strong> / <strong>SUSPENDED</strong> — červená. Pool neposkytuje dáta a vyžaduje okamžitý zásah."
],
"outro": "Stav ZFS a SMART každého disku vstupuje do kategórie <em>Disky a I/O</em> v <link>Health Monitor</link>."
},
"physical": {
"heading": "Fyzické disky a SMART stav",
"intro": "Interné disky (SATA / NVMe). Každý riadok kondenzuje najužitočnejšie polia na prvý pohľad:",
"items": [
"<strong>Trasa zariadenia</strong> — <code>/dev/sda</code>, <code>/dev/nvme0n1</code>.",
"<strong>Štítok typu</strong> — SATA / NVMe a príslušná ikona.",
"<strong>Systémový štítok</strong> — oranžové označenie diskov rozpoznaných ako disky operačného systému. Detekcia používa pripojenia <code>/</code> a <code>/boot</code> a pridelí štítok <em>System</em>. Chýbajúci štítok nedokazuje, že disk možno bezpečne vymazať alebo použiť inak.",
"<strong>Model</strong> — výrobca a model z <code>smartctl -i</code>.",
"<strong>Kapacita</strong> — zobrazená v zrozumiteľných jednotkách.",
"<strong>Teplota</strong> — aktuálna hodnota v °C s farbou podľa typu disku; NVMe používa vyššie prahy než SATA.",
"<strong>Stav SMART</strong> — úspešný / neúspešný / neznámy.",
"<strong>Štítok pozorovaní</strong> — ak trvalá história <code>disk_observations</code> obsahuje záznamy disku, modrý štítok ukáže ich počet, napríklad <em>3 obs.</em>. Kliknutím na disk ich preskúmate.",
"<strong>Štítok stavu</strong> — V poriadku / Varovanie / Kritické podľa SMART a nedávnych pozorovaní."
],
"clickHint": "Kliknutím na celý riadok otvoríte nižšie opísaný detail disku.",
"warningTitle": "S diskami označenými System zaobchádzajte opatrne",
"warningBody": "Disky s oranžovým štítkom <strong>System</strong> obsahujú bežiaci systém. Štítok pomáha pri identifikácii; <link>ProxMenux → Správca diskov → Formátovať / Vymazať</link> na nich odmieta deštruktívne akcie. Na iné využitie zavádzacieho disku použite záchranné prostredie mimo bežiaceho Proxmoxu."
},
"external": {
"heading": "Externé úložisko (USB)",
"body": "Disky USB majú vlastnú kartu, viditeľnú pri prítomnosti aspoň jedného disku. Ukazuje rovnaké polia ako interné disky a oranžový štítok <strong>USB</strong>. Keďže sa často pripájajú iba na zálohy alebo občasné prenosy, pozorovania zostávajú uložené, ale chyby I/O odpojeného disku USB sa neeskalujú."
},
"drillIn": {
"heading": "Okno detailu disku",
"intro": "Kliknutím na disk otvoríte štyri karty: <strong>Prehľad</strong> · <strong>SMART</strong> · <strong>História</strong> · <strong>Plánovanie</strong>. Hlavička ukazuje cestu, model, kapacitu a prípadne oranžový štítok <em>System</em>.",
"overviewTitle": "Karta 1 — Prehľad",
"overviewImageAlt": "Detail disku, karta Prehľad so stavom, kruhovým ukazovateľom opotrebovania a životnosti a hlavnými atribútmi SMART",
"overviewImageCaption": "Prehľad: identifikácia, stav, zostávajúca životnosť s aktuálnym opotrebovaním a zapísanými dátami a hlavné atribúty SMART.",
"overviewIntro": "Úvodná karta na kontrolu stavu disku bez spustenia testu. Tri bloky:",
"overviewItems": [
"<strong>Identifikácia</strong> — model, sériové číslo, kapacita a stav V poriadku / Varovanie / Kritické.",
"<strong>Opotrebovanie a životnosť</strong> — kruh zostávajúcej životnosti (97 %, 50 %, …) so zdrojovým atribútom (<em>Media Wearout Indicator</em>, <em>Percentage Used</em>, …), pruh spotrebovaného percenta, odhad <em>Odhadovaná životnosť</em> v rokoch a celkové zapísané dáta. NVMe ukazuje aj <em>Available Spare</em>.",
"<strong>Atribúty SMART</strong>: hlavné hodnoty sa zobrazujú v dvoch stĺpcoch: teplota, počet hodín prevádzky s čitateľným trvaním, napríklad <em>3 roky a 116 dní</em>, otáčky alebo <em>SSD</em>, počet zapnutí, stav SMART, prerozdelené sektory, čakajúce sektory a chyby CRC. Úplná tabuľka atribútov je na karte SMART."
],
"smartTitle": "Karta 2 — SMART",
"smartImageAlt": "Detail disku, karta SMART s krátkym a rozšíreným testom, posledným výsledkom a úplnou tabuľkou atribútov",
"smartImageCaption": "Karta SMART: spustite krátky alebo rozšírený test, skontrolujte posledný výsledok a všetky atribúty a otvorte úplnú správu na tlač alebo uloženie do PDF.",
"smartIntro": "Dostupné akcie v troch častiach:",
"smartItems": [
"<strong>Spustiť test SMART</strong> — dve tlačidlá. <em>Krátky test (~2 min)</em> počká na výsledok a zobrazí ho v okne. <em>Rozšírený test (na pozadí)</em> môže na veľkých diskoch trvať hodiny, pokračuje na serveri a po dokončení odošle oznámenie.",
"<strong>Posledný test</strong> — typ, stav (<em>úspešný</em> / <em>neúspešný</em>) a čas posledného spustenia.",
"<strong>Atribúty SMART</strong> — úplná tabuľka s ID, názvom, hodnotou, najhoršou hodnotou a stavom v poriadku, varovanie alebo kritické. SATA/SAS zobrazuje číslovaný zoznam. NVMe používa <code>nvme smart-log</code>: teplotu, dostupnú rezervu, použité percento, prečítané/zapísané jednotky, čítania/zápisy hostiteľa, čas vyťaženia radiča, zapnutia, nebezpečné vypnutia, chyby média, záznamy chýb a čas celkovej teploty vo varovnom/kritickom pásme."
],
"pdfTitle": "Zobraziť úplnú správu SMART (PDF)",
"pdfIntro": "Dole na karte SMART otvorí <strong>Zobraziť úplnú správu SMART</strong> správu na tlač. Tlačovým oknom prehliadača ju uložíte do PDF na archiváciu alebo zdieľanie s podporou pri RMA.",
"pdfPreviewAlt": "Prvá strana správy SMART so súhrnom, ukazovateľom PASSED a informáciami o disku",
"pdfPreviewCaption": "Prvá strana: súhrn, ukazovateľ PASSED a úplné informácie o disku. Príklad PDF obsahuje opotrebovanie SSD, všetky atribúty SMART a históriu testov.",
"pdfDownloadLabel": "Stiahnuť príklad správy SMART (PDF)",
"pdfSectionsIntro": "Správa má šesť hlavných častí:",
"pdfSections": [
"<strong>Súhrn</strong> — stav PASSED/FAILED, zrozumiteľné hodnotenie disku — v poriadku, opotrebovaný alebo zlyhávajúci — a štyri údaje: čas správy, posledný typ testu, výsledok a overené atribúty.",
"<strong>Informácie o disku</strong> — model, sériové číslo, kapacita, typ HDD/SSD/NVMe, rodina, formát, rozhranie (SATA 3.3 · 6.0 Gb/s, …), TRIM, teplota a optimálny prah, hodiny prevádzky, zapnutia, SMART, čakajúce/prerozdelené sektory a chyby CRC.",
"<strong>Opotrebovanie a životnosť SSD</strong> (iba SSD/NVMe) — zostávajúca životnosť, zdrojový atribút, opotrebovanie, zapísané dáta a hodiny prevádzky.",
"<strong>Úplné atribúty SMART</strong> — ID, názov, hodnota, najhoršia hodnota, prah, nespracovaná hodnota a stav každého atribútu. Hlavné — Reallocated Sector Ct, Power On Hours, Reported Uncorrect, UDMA CRC Error Count, Media Wearout Indicator, … — majú pod riadkom stručné vysvetlenie.",
"<strong>Posledný autotest a úplná história</strong> — posledný test s typom, výsledkom, záverečnou správou a vtedajším počtom hodín prevádzky a číslovaná tabuľka všetkých uchovaných testov.",
"<strong>Odporúčania</strong> — kroky podľa výsledku. Pre zdravé disky: <em>disk v poriadku / pravidelné testy / stratégia záloh</em>. Pri atribútoch mimo rozsahu sa pridajú odporúčania na výmenu."
],
"pdfOutro": "Prehliadač vytvorí správu na tlač; Tlačiť aj Uložiť ako PDF otvoria tlačové okno. Vyberte názov ako <code>SMART-&lt;short-id&gt;.pdf</code>. Uchovajte datované kópie na porovnanie zmien alebo zdieľanie s podporou.",
"historyTitle": "Karta 3 — História",
"historyImageAlt": "Detail disku, karta História s predchádzajúcimi testmi SMART a možnosťami stiahnutia a odstránenia",
"historyImageCaption": "História testov SMART disku. Každý riadok ukazuje typ, čas, vek, označenie posledného testu a možnosti stiahnutia výstupu <code>smartctl</code> a odstránenia.",
"historyIntro": "Dokončené a uchované krátke aj rozšírené testy disku. Každý záznam obsahuje pôvodný výstup <code>smartctl</code> a polia spracované Monitorom pre prehľad. Akcie v riadku:",
"historyItems": [
"<strong>Stiahnuť</strong> — uloží snímku JSON s údajmi <code>smartctl -a</code> použitými v správe. Užitočné, ak podpora potrebuje pôvodné diagnostické polia.",
"<strong>Odstrániť</strong> — ručne vymaže test z histórie. Uchovávanie v Plánovaní (<em>posledných 5 / 10 / 20</em>) automaticky maže najstaršie."
],
"scheduleTitle": "Karta 4 — Plánovanie",
"scheduleImageAlt": "Detail disku, karta Plánovanie s prepínačom automatických testov SMART, zoznamom plánov a tlačidlom Pridať plán",
"scheduleImageCaption": "Plánovanie: vyberte typ, frekvenciu a uchovávanie; Monitor nastaví <code>cron</code> na automatické spúšťanie testov.",
"scheduleIntro": "Automatické testy SMART cez cron bez terminálu. Tri oblasti:",
"scheduleItems": [
"<strong>Automatické testy SMART</strong> — spoločný prepínač všetkých plánov disku. Umožní ich pozastaviť počas údržby bez vymazania nastavení.",
"<strong>Nastavené plány</strong> — riadok pre každý plán s typom (<em>krátky</em> / <em>dlhý</em>), čitateľným výrazom cron (<em>„Prvý deň mesiaca o 03:00“</em>, <em>„Každú nedeľu o 02:00“</em>), zahrnutými diskami a uchovávaním.",
"<strong>Pridať / Upraviť plán</strong> — typ (<em>krátky ~2 min</em> / <em>dlhý 1–4 h</em>), frekvencia (<em>denne / týždenne / mesačne</em>), deň mesiaca alebo týždňa, čas a uchované výsledky (<em>posledných 5 / 10 / 20</em>)."
],
"scheduleOutro": "Plán vytvorí na hostiteľovi záznam cron, ktorý volá Monitor. Výsledky sa uložia do histórie SMART na karte 3 a nastavenie uchovávania po novom teste automaticky odstráni najstaršie výsledky.",
"tempTitle": "Okno histórie teploty",
"tempIntro": "Monitor pravidelne meria disky s teplotným senzorom a ukladá hodnoty do lokálnej histórie. Aktuálna hodnota je v Prehľade; kliknutie otvorí detail histórie teploty.",
"tempImageAlt": "História teploty s cestou a modelom, obdobiami 1 hodina, 24 hodín, 7 alebo 30 dní, hodnotami Aktuálna/Minimum/Priemer/Maximum a čiarovým grafom s farbami podľa prahov typu disku",
"tempImageCaption": "Detail teploty otvoríte z Prehľadu, ak senzor vráti nenulovú hodnotu. Graf používa prahy HDD / SSD / NVMe / SAS.",
"tempShowsTitle": "Obsah okna",
"tempShowsItems": [
"<strong>Výber obdobia</strong>: <em>1 hodina</em>, predvolene <em>24 hodín</em>, <em>7 dní</em> alebo <em>30 dní</em>. Každý dopyt prispôsobí rozlíšenie, aby bol graf čitateľný.",
"<strong>Štyri ukazovatele</strong>: <em>Aktuálna</em>, <em>Minimum</em>, <em>Priemer</em> a <em>Maximum</em> za obdobie. <em>Aktuálna</em> používa prahy úložiska a oznámení na rozlíšenie normálnej, zvýšenej a vysokej teploty.",
"<strong>Čiarový graf</strong> teploty v čase s čiarou a plochou zafarbenou podľa typu disku:"
],
"tempDiskTypes": [
"HDD — zvyčajne nižšie teplotné prahy.",
"SSD — stredné teplotné prahy.",
"NVMe Vyššie prahové hodnoty (NVMe beží teplejšie podľa dizajnu).",
"SAS — varovanie pri 55 °C a kritické pri 65 °C; prah varovania sa líši od HDD."
],
"tempConfigurable": "Všetky štyri typy nastavíte v <em>Nastavenia → Prahy Health Monitor</em>.",
"tempWhyTitle": "Prečo je história dôležitá",
"tempWhyItems": [
"<strong>Odhalenie trendov.</strong> Jediné meranie neukáže, že sa disk celé týždne zahrieva, napríklad pre poruchu ventilátora, prach alebo blízky zdroj tepla. Zobrazenia za 7 a 30 dní odhalia vývoj.",
"<strong>Súvislosti špičiek.</strong> Ak záloha alebo obnova krátko zvýšila teplotu nad prah, zobrazenia za 1 a 24 hodín ukážu, či išlo o jednorazovú alebo opakovanú udalosť.",
"<strong>Nastavenie prahov.</strong> Pred zmenou v <em>Nastavenia → Prahy Health Monitor</em> si v 30-dňovom grafe pozrite skutočný prevádzkový rozsah disku."
],
"obsTitle": "História pozorovaní naprieč kartami",
"obsIntro": "Poruchy sa môžu rozvíjať postupne. Disk môže hlásiť SMART <strong>PASSED</strong> a pritom zapisovať chyby čítania do dmesg, strácať spojenia SATA alebo uvádzať občasné čakajúce sektory. ProxMenux uchováva tieto <em>signály</em> a zobrazuje ich v okne spolu s aktuálnym stavom SMART.",
"obsImageAlt": "Prehľad disku s úspešným SMART a nulou prerozdelených/čakajúcich sektorov a chýb CRC, ale s pozorovaním chyby I/O s pôvodnou správou jadra, vysvetlením ATA, prvým a posledným časom a počtom výskytov",
"obsImageCaption": "Disk, ktorý <strong>prešiel SMART</strong>, môže mať staršie pozorovania. Karta dopĺňa aktuálny stav o históriu signálov.",
"obsWhatTitle": "Čo je pozorovanie",
"obsWhatIntro": "ProxMenux zaznamená ako <strong>pozorovanie</strong> udalosti disku z denníka jadra, dmesg alebo SMART, ktoré by samostatne boli príliš podrobné pre oznámenie. Každý riadok zobrazuje:",
"obsWhatItems": [
"<strong>Typ</strong> — chyba I/O, SMART, súborového systému, poolu ZFS alebo spojenia.",
"<strong>Pôvodná správa jadra</strong> z dmesg na skopírovanie do vyhľadávača alebo žiadosti o podporu.",
"<strong>Stručné vysvetlenie</strong> známych kódov ATA: <code>IDNF</code>, adresa sektora sa nenašla, možný chybný sektor alebo kábel; <code>UNC</code>, neopraviteľná chyba čítania, chybný sektor; a ďalšie štandardné kódy.",
"<strong>Prvý a posledný čas</strong> a <strong>počet výskytov</strong> zoskupených podľa podpisu chyby."
],
"obsWhyTitle": "Prečo ich ProxMenux zaznamenáva a zobrazuje",
"obsWhyItems": [
"<strong>Poruchy sa môžu vyvíjať.</strong> Chyby zbernice ATA, sektory UNC alebo chyby média sa môžu objaviť pred stavom SMART <em>FAILED</em>. Pamäť dmesg ich po reštarte neuchová, história pozorovaní áno.",
"<strong>SMART nevylučuje každú poruchu.</strong> Disk môže mať zelené atribúty a pritom problémy. Pozorovania uchovávajú ďalšie príznaky, napríklad ICRC, IDNF, resety spojení SATA alebo zníženie rýchlosti.",
"<strong>Odlišuje aktuálne od nedávneho.</strong> Health Monitor automaticky vyrieši prechodné chyby, ktoré sa už neopakujú. História aj po dňoch ukáže napríklad tri chyby I/O z jednej noci.",
"<strong>Podklad stupňovaných oznámení.</strong> disk_io používa frekvenciu pozorovaní na výber tichého stavu, WARNING alebo CRITICAL v posuvnom 24-hodinovom okne zavedenom vo verzii 1.2.1.2."
],
"obsDedupTitle": "Zoskupovanie duplicít a opakované oznámenia",
"obsDedupBody1": "Pozorovania sa zoskupujú podľa <strong>podpisu</strong>, stabilného odtlačku typu chyby, zariadenia a kľúčových polí správy. Opakovania zvýšia <code>occurrence_count</code> v existujúcom riadku. <strong>Iný podpis</strong> vytvorí ďalšie pozorovanie a pre oznámenia predstavuje novú udalosť.",
"obsDedupBody2": "Aby nevznikla záplava oznámení, prvá kombinácia disku, podpisu a závažnosti upozorní operátora. Rovnaká kombinácia čaká 24 hodín na ďalšie oznámenie aj pri rastúcom počte. Prechod z WARNING na CRITICAL čakanie preruší a oznámi zhoršenie.",
"obsDismissTitle": "Trvalá história a aktívne chyby",
"obsDismissBody1": "Pozorovania nemožno zamietnuť, skryť ani vymazať. Každý podpis má kartu; opakovanie zvýši počet a aktualizuje posledný čas. História sleduje sériové číslo: iný disk začína bez záznamov aj na rovnakom porte a premenovanie jadrom históriu zachová.",
"obsDismissBody2": "Vyriešenie alebo zamietnutie aktívnej chyby v Health Monitor nemení pozorovania. Zostávajú aj po automatickom vyriešení, takže dočasné varovanie z minulého týždňa je stále viditeľné. Aktívne chyby spravuje <link>Health Monitor</link>."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerSection": "Časť karty",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"section": "Horné súhrnné karty",
"endpoint": "/api/storage/summary",
"source": "Agregované z <code>lsblk</code>, <code>zpool list</code>, <code>vgs</code> / <code>lvs</code>."
},
{
"section": "Inventár diskov",
"endpoint": "/api/storage",
"source": "<code>lsblk -O</code> + <code>smartctl -i</code> pre zariadenie s vyrovnávacou pamäťou identity vymazanou pri pripojení za chodu."
},
{
"section": "Úložiská Proxmox",
"endpoint": "/api/proxmox-storage",
"source": "<code>pvesh get /nodes/&lt;node&gt;/storage</code> s aktívnym/online stavom každého."
},
{
"section": "Aktuálne hodnoty SMART",
"endpoint": "/api/storage/smart/<disk>",
"source": "<code>smartctl -A &lt;dev&gt;</code> je jeden z dostupných dopytov; detailný koncový bod používa aj úplný SMART JSON a údaje špecifické pre NVMe."
},
{
"section": "História autotestov SMART",
"endpoint": "/api/storage/smart/<disk>/history",
"source": "Uložené v <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code> ako snímky JSON."
},
{
"section": "Trvalé pozorovania",
"endpoint": "/api/storage/observations",
"source": "Tabuľka SQLite aktualizovaná Health Monitor pri každom cykle a uchovaná po vyriešení aktívnych chýb."
}
],
"outro": "Overovanie reťazca zberu na hostiteľovi:",
"codeComment1": "# Získať aktuálny stav zo skriptu",
"codeComment2": "# Porovnať údaje prehľadu s priamym výstupom operačného systému"
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tail": " — kategória Disky a I/O a pravidlá potláčania."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tail": " — koncové body úložísk a SMART."
},
{
"label": "Oznámenia",
"href": "/docs/monitor/notifications",
"tailRich": " — následné akcie spustené udalosťami <code>disk_io_error</code>, <code>storage_unavailable</code> a <code>smart_test_failed</code>."
},
{
"label": "Index prehľadu",
"href": "/docs/monitor/dashboard",
"tail": " — Ostatné karty."
},
{
"label": "ProxMenux → Správca diskov",
"href": "/docs/disk-manager",
"tail": " — akcie TUI: formátovanie, vymazanie, testy SMART a import diskov do VM alebo kontajnerov."
},
{
"label": "ProxMenux → Stav a testy SMART disku",
"href": "/docs/disk-manager/smart-disk-test",
"tail": " — verzia CLI: plánovanie testov SMART, export zobrazeného JSON a podrobnosti o typoch testov a výklade výsledkov."
}
]
}
}
@@ -0,0 +1,120 @@
{
"meta": {
"title": "ProxMenux Monitor — Panel: Systémové záznamy | Dokumentácia ProxMenux",
"description": "Záložka System Logs konsoliduje tri zdroje do jednej obrazovky: živé journalctl s filtrami a downloadom, História úloh Proxmox (UPIDs) a oznamovací protokol, všetky vyhľadávateľné, filtrovateľné podľa závažnosti / časového rozsahu, a sťahovanie ako textové zväzky."
},
"header": {
"title": "Panel: Systémové záznamy",
"description": "Tri podkarty na jednej obrazovke: systémový žurnál (journalctl s filtrami), história úloh Proxmox a záznam oznámení. Vo všetkých možno vyhľadávať, filtrovať a sťahovať údaje ako textové balíky.",
"section": "ProxMenux Monitor · Prehľad"
},
"readOnly": {
"title": "Len na čítanie podľa návrhu",
"body": "Táto karta nemení súbory záznamov. Filtre sa uchovávajú v URL alebo stave rozhrania a súbory na stiahnutie pripravuje server. Panel nikdy neodstraňuje záznamy; na ich údržbu použite na hostiteľovi <code>journalctl --vacuum-time=&lt;N&gt;</code> alebo <code>logrotate</code>."
},
"topRow": {
"heading": "Horný riadok: štyri počítadlá",
"items": [
"<strong>Celkový počet záznamov</strong> — počet položiek v časovom rozsahu aktívneho filtra.",
"<strong>Chyby</strong> — počet záznamov so závažnosťou ≤ 3 (<code>err</code> / <code>crit</code> / <code>alert</code> / <code>emerg</code>).",
"<strong>Upozornenia</strong> — počet záznamov so závažnosťou 4 (<code>warning</code>).",
"<strong>Zálohy</strong> — počet záznamov úloh vzdump / PBS v rovnakom časovom rozsahu."
]
},
"subtabs": {
"heading": "Tri podkarty",
"logsTitle": "Logy",
"logsIntro": "Systémový žurnál, ktorý server načítava cez <code>journalctl</code>. Na paneli nástrojov sú tieto filtre:",
"logsFilters": [
"<strong>Závažnosť</strong> — emerg / alert / crit / err / warning / notice / info / debug alebo ľubovoľná kombinácia.",
"<strong>Časový rozsah</strong> Posledná 5 min/ 15 min/ 1 h / 6 h / 24 h / 7 d / vlastné.",
"<strong>Voľné vyhľadávanie textu</strong> — podreťazec alebo regulárny výraz (<code>journalctl --grep</code>).",
"<strong>Filter jednotky</strong> — obmedzí výsledky na konkrétnu jednotku systemd (<code>pveproxy.service</code>, <code>nginx.service</code>, …)."
],
"logsRowsAfter": "Každý riadok zobrazuje časovú pečiatku, označenie závažnosti, zdrojovú jednotku a správu. Dlhé správy sa zbalia s prepínačom „zobraziť viac“. Akcia <strong>Stiahnuť</strong> vytvorí z aktuálneho filtra jeden súbor <code>.txt</code> cez <code>GET /api/logs/download</code>, vhodný na zdieľanie časti žurnálu s ďalšou osobou.",
"logDetailsModalTitle": "Okno Podrobnosti záznamu",
"logDetailsBody": "Kliknutie na riadok otvorí okno <strong>Podrobnosti záznamu</strong> so všetkými štruktúrovanými poľami, ktoré journald zachytil pre danú položku, rovnako ako príkaz <code>journalctl --output=verbose</code> na hostiteľovi.",
"logDetailsImageAlt": "Okno Podrobnosti záznamu — rozbalená položka žurnálu s úrovňou, službou, časovou pečiatkou, zdrojom, jednotkou systemd, ID procesu, názvom hostiteľa a úplnou správou",
"logDetailsImageCaption": "Podrobnosti záznamu — všetky štruktúrované polia danej položky journald a dole úplná neskrátená správa. Užitočné pri záznamoch cron a služieb, kde záleží na vykonanom príkaze.",
"fieldsIntro": "Zobrazené polia:",
"fields": [
"<strong>Úroveň</strong> — farebné označenie závažnosti (INFO / WARNING / ERROR / CRITICAL).",
"<strong>Služba</strong> — krátky názov jednotky alebo procesu, ktorý vytvoril záznam.",
"<strong>Časová pečiatka</strong> — úplný dátum a čas riadka záznamu.",
"<strong>Zdroj</strong> — pôvod položky (žurnál, jadro, audit, …).",
"<strong>Jednotka systemd</strong> — konkrétna jednotka <code>.service</code> / <code>.timer</code> / <code>.socket</code>, ak bola k záznamu priradená.",
"<strong>ID procesu</strong> — PID procesu, ktorý vytvoril záznam.",
"<strong>Názov hostiteľa</strong> — užitočný pri preposielaní žurnálov medzi uzlami klastra.",
"<strong>Správa</strong> — úplná neskrátená správa v bloku s neproporcionálnym písmom, pripravená na kopírovanie."
],
"maxLevelStoreTitle": "Journald MaxLevelStore",
"maxLevelStoreBody": "Na novej inštalácii Proxmox používa journald predvolene <code>MaxLevelStore=warning</code>, čím zahadzuje správy info. Monitor to pri štarte rozpozná a pridá doplnkovú konfiguráciu (<code>/etc/systemd/journald.conf.d/proxmenux-loglevel.conf</code>) s prahom <code>info</code>, aby sa uchovávali informačné a závažnejšie správy. Správy debug to nezahŕňa.",
"backupsTitle": "Zálohy",
"backupsBody": "História úloh Proxmox obmedzená na zálohovanie. Jeden riadok na úlohu (<code>vzdump</code>, prenosy PBS, čistenie nepoužívaných dát a overenie), so stavom (OK / WARNINGS / ERROR), hosťovským systémom, zdrojovým úložiskom, trvaním a UPID. Kliknutím na riadok načítate úplný záznam úlohy cez <code>GET /api/task-log/&lt;upid&gt;</code> — rovnaké údaje ako v <em>Datacenter → Úlohy</em>, obmedzené na zálohy.",
"notificationsTitle": "Oznámenia",
"notificationsBody1": "Všetky oznámenia odoslané Monitorom: Telegram, Discord, e-mail, Gotify, ntfy, Slack, Teams a webhook. Každý riadok uvádza časovú pečiatku, kanál, typ udalosti, závažnosť, vytvorený názov a telo a pri zapnutej AI prepínač na porovnanie jej prepracovanej verzie s originálom.",
"notificationsBody2": "Na tejto karte overíte doručovanie oznámení cez kanál a porovnáte prepracovanie AI s pôvodnou šablónou. Kanály sa nastavujú na podrobnej stránke <link>Oznámenia</link>."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerSubtab": "Podkarta",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"subtab": "Záznamy (živý filter)",
"endpoint": "/api/logs",
"source": "<code>journalctl --output json --since &lt;range&gt;</code> s filtrami závažnosti, jednotky a vyhľadávania použitými na serveri."
},
{
"subtab": "Stiahnuť",
"endpoint": "/api/logs/download",
"source": "Rovnaký dotaz, vrátený ako obyčajný text pre grep / less."
},
{
"subtab": "Zálohy",
"endpoint": "/api/backups",
"source": "História úloh PVE filtrovaná podľa <code>vzdump</code>, prenosov PBS, čistenia nepoužívaných dát a overenia."
},
{
"subtab": "Podrobnosti úlohy zálohovania",
"endpoint": "/api/task-log/&lt;upid&gt;",
"source": "Plný textový záznam úloh čítaný z <code>/var/log/pve/tasks/&lt;index&gt;/&lt;upid&gt;</code>."
},
{
"subtab": "História oznámení",
"endpoint": "/api/notifications/history",
"source": "Tabuľka SQLite <code>notification_history</code>, ktorú plní odosielacia slučka."
}
],
"apiIntro": "Živý filter aj sťahovanie sú dostupné cez API:",
"codeComment1": "# Chyby a závažnejšie udalosti za poslednú hodinu s kľúčovým slovom",
"codeComment2": "# Stiahnuť celý žurnál za posledných 6 hodín ako obyčajný text",
"codeComment3": "# Vyhľadajte úplný výstup konkrétnej úlohy podľa UPID"
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tail": " — kategória Systémové záznamy, ktorá sleduje pretrvávajúce vzory, náhle nárasty a kaskády."
},
{
"label": "Oznámenia",
"href": "/docs/monitor/notifications",
"tail": " — sledovanie žurnálu číta rovnaký zdroj a premieňa zhody na oznámenia."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tail": " — koncové body logs a task-log s parametrami dotazov."
},
{
"label": "Index panela",
"href": "/docs/monitor/dashboard",
"tail": " — Ostatné karty."
}
]
}
}
@@ -0,0 +1,177 @@
{
"meta": {
"title": "ProxMenux Monitor — Panel: Prehľad systému | Dokumentácia ProxMenux",
"description": "Predvolená úvodná karta ProxMenux Monitor: štyri karty (CPU, pamäť, aktívne VM a LXC, teplota) s aktualizáciou naživo a minigrafom trendu, historický graf a súhrny úložiska a siete s odkazmi na podrobné karty."
},
"header": {
"title": "Panel: Prehľad systému",
"description": "Karta, ktorú panel otvorí predvolene: štyri karty živých metrík hore, historický graf v strede a súhrny úložiska a siete dole. Používajú rovnaké API ako príslušné podrobné karty.",
"section": "ProxMenux Monitor · Prehľad"
},
"readOnly": {
"title": "Snímka iba na čítanie",
"body": "Všetky panely tejto karty sú informačné. Akcie sú na prepojených kartách: Úložisko na správu diskov, VM a LXC na spustenie či zastavenie hosťovských systémov a Bezpečnosť na nastavenie overovania."
},
"captureAlt": "Karta Prehľad systému — štyri karty metrík (CPU, pamäť, aktívne VM, teplota), graf metrík uzla a súhrnné karty úložiska a siete",
"captureCaption": "Prehľad systému, predvolená úvodná karta. Štyri karty sa aktualizujú naživo, graf zobrazuje históriu a dve dolné karty sumarizujú úložisko a sieť.",
"topRow": {
"heading": "Horný riadok: živé karty metrík",
"intro": "Štyri karty v mriežke 2×2 na mobile a v jednom riadku na počítači. Každá sa aktualizuje z <code>/api/system</code> každých pár sekúnd.",
"headerCard": "Karta",
"headerWhat": "Čo ukazuje",
"headerSource": "Zdroj",
"rows": [
{
"card": "Využitie CPU",
"what": "Aktuálne percento s ukazovateľom priebehu. Vzorkovač životných funkcií ho aktualizuje každú ~1 s.",
"source": "psutil.cpu_percent()"
},
{
"card": "Využitie pamäte",
"what": "Použité GB, percento a celkové GB. Ukazovateľ zobrazuje percento.",
"source": "psutil.virtual_memory()"
},
{
"card": "Aktívne VM a LXC",
"what": "Počet bežiacich hosťovských systémov s rozdelením Spustené / Zastavené a celkovým počtom VM a LXC v päte.",
"source": "/api/vms (konsolidované)"
},
{
"card": "Teplota",
"what": "Teplota CPU v °C s označením stavu (nízka / zvýšená / vysoká) a minigrafom posledných 5 minút v pozadí. Bez snímača sa zobrazí <em>N/A</em>. Kliknutie otvorí podrobnosti.",
"source": "sensors / coretemp"
}
],
"thresholdsTitle": "Farby stavu a prahové hodnoty, ktoré sa tu uplatňujú",
"thresholdsIntro": "Prstence, ukazovatele a minigrafy používajú rovnakú škálu: <green/> <strong>zelená</strong> pod prahom Upozornenie, <amber/> <strong>jantárová</strong> medzi Upozornenie a Kritické, <red/> <strong>červená</strong> od prahu Kritické vyššie. Odporúčané predvolené hodnoty ProxMenux:",
"thresholdsItems": [
"<strong>Využitie CPU</strong> — upozornenie 85 %, kritické 95 %.",
"<strong>Pamäť</strong> — upozornenie 85 %, kritické 95 %. Swap tiež vyvolá kritický stav pri 5 % využitia; správne fungujúci hostiteľ Proxmox by ho mal používať len zriedka.",
"<strong>Teplota CPU</strong> — upozornenie 80 °C, kritické 90 °C."
],
"thresholdsOutro": "Hodnoty možno nastaviť pre každého hostiteľa. <link>Nastavenia → Prahy monitora stavu</link> sú hlavný zdroj a vysvetľujú ich úpravu.",
"sparklineTitle": "Minigraf ukazuje trend",
"sparklineBody": "Karta teploty zobrazuje pod hodnotou priebeh posledných 5 minút. Farba čiary a prechodu sa riadi uvedenými prahmi Upozornenie/Kritické. Rýchlo tak zistíte, či teplota hostiteľa stúpa, bez otvorenia podrobností."
},
"processes": {
"heading": "Procesy s najvyšším využitím CPU a pamäte",
"intro": "Karty Využitie CPU a Pamäť otvárajú triediteľný zoznam 25 najnáročnejších procesov: podľa využitia CPU pri otvorení z CPU alebo podľa rezidentnej pamäte pri otvorení z Pamäte.",
"listTitle": "Dialóg zoznamu",
"listItems": [
"<strong>Automatické obnovenie</strong> — zoznam sa aktualizuje každých 5 sekúnd, kým je okno otvorené; po zatvorení sa dotazy zastavia.",
"<strong>Filter</strong> — vyhľadávanie obmedzí zoznam podľa príkazu, používateľa alebo PID.",
"<strong>Ukazovateľ v riadku</strong> — stĺpec hlavnej metriky kreslí malý ukazovateľ škálovaný podľa najvyššej hodnoty vo filtrovanom zozname. Poradie zostáva zrejmé, aj keď žiadny proces nie je blízko 100 %.",
"<strong>Mobilné rozloženie</strong> — pod 640 px sa skryjú stĺpce PID a Používateľ, aby sa Príkaz, CPU % a Pamäť zmestili na telefón bez vodorovného posúvania."
],
"captureListAlt": "Okno procesov podľa pamäte — tabuľka zoradená podľa RSS so stĺpcami PID, používateľ, príkaz, CPU % a pamäť",
"captureListCaption": "Karta Pamäť otvorí zoznam podľa RSS (indigová farba). Karta CPU otvorí ten istý zoznam podľa využitia CPU (modrá farba).",
"detailTitle": "Podrobnosti jednotlivého procesu",
"detailIntro": "Kliknutie na riadok otvorí druhé okno so živými údajmi procesu v štyroch sekciách:",
"detailItems": [
"<strong>Prehľad</strong> — stav, nadradený proces, počet vlákien, otvorené deskriptory súborov, používateľ a skupina.",
"<strong>Zdroje</strong> — CPU %, pamäť %, rezidentná pamäť (RSS), virtuálna veľkosť, swap a celkové prečítané a zapísané I/O dáta.",
"<strong>Príkaz</strong> — krátky názov, úplný príkazový riadok, cesta k spustiteľnému súboru a pracovný adresár.",
"<strong>Trvanie</strong> — časová pečiatka spustenia a uplynutý čas behu."
],
"detailRefresh": "Podrobnosti sa aktualizujú každé 3 sekundy. Po ukončení procesu sa dotazy zastavia a objaví sa jantárové oznámenie <em>Tento proces sa skončil</em>. Posledný zachytený stav zostane stlmený na obrazovke, aby bolo vidieť dianie tesne pred koncom.",
"captureDetailAlt": "Podrobnosti procesu — Prehľad, Zdroje, Príkaz a Trvanie pre jedno PID",
"captureDetailCaption": "Podrobnosti procesu otvorené z riadka zoznamu. Farba zodpovedá karte, z ktorej sa otvorili: modrá pre CPU, indigová pre pamäť."
},
"middle": {
"heading": "Stred: grafy metrík uzla",
"body1": "Pod kartami zobrazuje <code>NodeMetricsCharts</code> históriu CPU, pamäte a diskového I/O z úložiska RRD Proxmox cez <code>/api/node/metrics</code>. Volič ponúka <em>1 hodina / 24 hodín / 7 dní / 30 dní / 1 rok</em>. Pri dlhšom období klesá rozlíšenie údajov, aby bol graf plynulý.",
"body2": "Rovnaké grafy ako vo webovom rozhraní Proxmox pre uzol, začlenené do tmavej témy Monitora a zarovnané s ostatnými panelmi."
},
"bottom": {
"heading": "Dolný riadok: Súhrny úložiska a siete",
"storageTitle": "Karta Prehľad úložiska",
"storageIntro": "Kompaktný prehľad stavu úložiska hostiteľa, rozdelený do troch blokov:",
"storageItems": [
"<strong>Celková kapacita uzla</strong> — súčet úložísk VM/LXC a lokálneho systémového úložiska, s ukazovateľom využitého a voľného miesta s farebným prechodom.",
"<strong>Celková kapacita / Fyzické disky</strong> — hrubá kapacita a počet nájdených fyzických diskov.",
"<strong>Úložisko VM/LXC</strong> — využité a voľné miesto a percento úložísk hosťovských systémov, s počítadlom pri viacerých úložiskách.",
"<strong>Lokálne úložisko (systém)</strong> — koreňový alebo systémový prípojný bod hostiteľa, oddelený od fondu hosťovských systémov."
],
"storageDrillIn": "Podrobnosti sú na <link>karte Úložisko</link>: SMART jednotlivých diskov, fondy ZFS, história pozorovaní a ďalšie údaje.",
"networkTitle": "Sieťová prehľadová karta",
"networkBody1": "Hore je počet aktívnych rozhraní, fyzických aj mostov spolu. Pod ním sú dva rady farebných označení rozhraní <code>up</code>: fyzické NIC modrou a mosty druhou farbou. Volič vpravo hore (1 hodina / 24 hodín / 7 dní / 30 dní / 1 rok) ovláda malý graf prevádzky RX / TX.",
"networkBody2": "Podrobnosti rozhraní (IP/MAC, graf RRD, členovia mosta, režim bond a ďalšie) sú na <link>karte Sieť</link>."
},
"refresh": {
"heading": "Model aktualizácie",
"intro": "Každý panel spravuje vlastný stav načítania (<code>loadingStates.cpu</code>, <code>loadingStates.storage</code>, …), aby pomalý zdroj neblokoval ostatné. Pri načítaní zobrazuje pulzujúci zástupný prvok. Zlyhania neblokujú zobrazenie: bez snímača teploty karta ukáže <em>N/A</em> namiesto chyby.",
"items": [
"<strong>Horné karty metrík</strong> — aktualizácia každých ~5 s. CPU a teplota navyše dostávajú údaje každú sekundu zo vzorkovača životných funkcií.",
"<strong>Graf metrík uzla</strong> — načíta sa pri otvorení a zmene obdobia alebo jazyka. V prípade potreby zopakuje požiadavku po 60 s.",
"<strong>Karta úložiska</strong> — aktualizácia každých ~60 s. Dáta SMART sa uchovávajú v pamäti dlhšie; karta Úložisko na požiadanie načíta nové.",
"<strong>Karta siete</strong> — súhrn každých 59 s a graf prevádzky každých 60 s pre aktívne obdobie.",
"<strong>Manuálne obnovenie</strong> — tlačidlo Obnoviť v hlavičke okamžite načíta všetky panely znova."
]
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerCard": "Karta",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"card": "Indikátor stavu v hlavičke",
"endpoint": "/api/health",
"source": "Celkový stav, ktorý monitor stavu vytvorí pri každom cykle a uloží do vyrovnávacej pamäte."
},
{
"card": "CPU / RAM / Swap / Čas prevádzky",
"endpoint": "/api/system",
"source": "<code>/proc/stat</code>, <code>/proc/meminfo</code>, <code>/proc/uptime</code> s krátkodobým vzorkovaním CPU."
},
{
"card": "Informácie o hostiteľovi (kernel, BIOS, distro)",
"endpoint": "/api/info",
"source": "<code>uname -a</code>, <code>dmidecode</code>, verzia PVE. Uložené vo vyrovnávacej pamäti na úrovni procesu."
},
{
"card": "Karty úložiska, siete a VM",
"endpoint": "/api/storage/summary, /api/network/summary, /api/vms",
"source": "Pozrite si príslušné podrobné karty. Karty v hlavičke zobrazujú kompaktný prehľad z rovnakých koncových bodov."
},
{
"card": "Frekvencia aktualizácie",
"endpoint": "—",
"source": "Systém každých 5 s; úložisko, VM a súhrn siete každých 59 s. Tlačidlo Obnoviť v hlavičke okamžite načíta všetky panely znova."
}
],
"codeComment1": "# Volanie pre indikátor stavu v hlavičke",
"codeComment2": "# verejné, bez tokenu",
"codeComment3": "# Overená snímka použitá kartami"
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tail": " — okno indikátora stavu v hlavičke: desať kategórií, odmietnutie a potlačenie upozornení."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tail": " — koncové body system, info a health."
},
{
"label": "Oznámenia",
"href": "/docs/monitor/notifications",
"tail": "— ako sa rovnaké stavy menia na Telegram / Discord / e-mailové správy."
},
{
"label": "Index panela",
"href": "/docs/monitor/dashboard",
"tail": " — ostatné karty panela v skratke."
},
{
"label": "Architektúra",
"href": "/docs/monitor/architecture",
"tail": " — vlákna na pozadí a API, ktoré poskytujú údaje pre toto zobrazenie."
}
]
}
}
@@ -0,0 +1,174 @@
{
"meta": {
"title": "ProxMenux Monitor — Panel: Terminál | Dokumentácia ProxMenux",
"description": "Shell hostiteľa Proxmox v prehliadači: až 4 terminály v mriežke, tlačidlá klávesnice pre mobilné zariadenia (ESC, TAB, šípky, kombinácie Ctrl), integrovaný prehľad príkazov z cheat.sh a ochrana JWT."
},
"header": {
"title": "Panel: Terminál",
"description": "Skutočná relácia shellu na hostiteľovi Proxmox v prehliadači. Až štyri terminály súčasne, tlačidlá klávesnice pre mobilné zariadenia a integrovaný prehľad príkazov, všetko v rovnakej téme ako zvyšok panela.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Skutočná PTY v prehliadači",
"body": "Terminál vytvorí na serveri PTY cez <code>flask_terminal_routes</code>, spojí ho cez WebSocket s <code>xterm.js</code> v prehliadači a beží ako <code>root</code>, používateľ jednotky systemd. Rovnako ako cez <code>ssh root@&lt;host&gt;</code> môžete používať <code>vim</code>, <code>tmux</code>, nástroje ncurses a CLI Proxmox (<code>qm</code>, <code>pct</code>, <code>pvesh</code>, <code>pvecm</code>). Každý PTY exportuje <code>PROXMENUX_TERMINAL=monitor</code>. Všetky podriadené procesy <code>bash</code> vrátane neskoršieho spustenia <code>menu</code> premennú zdedia, aby rozpoznali terminál Monitora."
},
"singleAlt": "ProxMenux Monitor Karta Terminál – jedna terminálová relácia zobrazujúca súhrn systému Fastfetch pri prihlásení",
"singleCaption": "Jeden host terminál otvorený a vyššie uvedený panel nástrojov ukazuje počet (<em>1 / 4 terminály</em>), <em>+ Nové</em>, <em>Hľadať</em>, <em>Vyčistiť</em> a <em>Zavrieť</em>. Pomocníci mobilnej klávesnice sa objavia pod terminálom na dotykových zariadeniach.",
"target": {
"heading": "Cieľ pripojenia",
"body1": "Karta Terminál otvorí shell na <strong>samotnom hostiteľovi Proxmox</strong>, rovnako ako prihlásenie cez SSH. Každá karta otvorí nový terminál hostiteľa.",
"body2": "Na prístup do <strong>kontajnera LXC</strong> použite tlačidlo <em>Konzola</em> na karte každého spusteného CT v <link>karte VM a LXC</link>. Otvorí okno, ktoré spustí <code>pct enter &lt;vmid&gt;</code> a použije rovnaký mobilný panel nástrojov opísaný nižšie."
},
"menuGuard": {
"heading": "Ochrana pri samoaktualizácii menu v tomto termináli",
"body1": "Po potvrdení <code>menu</code> nahradí vlastný strom skriptov a znovu sa načíta. Cez SSH alebo konzolu Proxmox to funguje, ale v prehliadači by sa ukončil PTY shellu a prerušil WebSocket. Preto <code>check_updates_stable</code>, <code>check_updates_beta</code> a <code>apply_release_channel</code> čítajú <code>PROXMENUX_TERMINAL</code> a rozpoznávajú kontext Monitora.",
"body2": "Dialóg áno/nie sa potom nahradí správou s oficiálnym príkazom inštalátora: <code>bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\"</code> pre stable a zodpovedajúcou URL <code>install_proxmenux_beta.sh</code> pre beta. Aktualizáciu vykonajte cez SSH alebo konzolu hostiteľa Proxmox; terminál prehliadača slúži iba na prečítanie a potvrdenie správy."
},
"fourTerminals": {
"heading": "Až štyri terminály naraz",
"intro": "Môžete otvoriť až štyri terminály hostiteľa súčasne. Každý má vlastný PTY aj WebSocket a ide o úplne nezávislé relácie. Ikony vedľa tlačidla „Nový“ prepínajú dve rozloženia:",
"items": [
"<strong>Zobrazenie kariet</strong> — viditeľný je jeden terminál, ostatné sú pomenované karty hore (<em>Terminál 1</em>, <em>Terminál 2</em>…). Vhodné na jednu úlohu, kým ostatné bežia na pozadí.",
"<strong>Zobrazenie mriežky</strong> — všetky otvorené terminály v mriežke 2×2. Môžete sledovať <code>htop</code> v jednom, <code>iftop</code> v druhom a upravovať v treťom bez prepínania kariet."
],
"outro": "Panel nástrojov uvádza počet (<em>1/4 terminálov</em>, <em>4/4 terminálov</em>). <strong>+ Nový</strong> otvorí kartu; malé <code>×</code> v jej hlavičke ju zatvorí. Veľké červené tlačidlo <strong>Zavrieť</strong> hore ukončí všetky terminály."
},
"gridAlt": "Karta Terminál ProxMenux Monitor — mriežka štyroch terminálov hostiteľa s ls, konfiguráciou siete, iftop a hlavnou ponukou ProxMenux vedľa seba",
"gridCaption": "Zobrazenie mriežky (4 / 4 terminály) — štyri nezávislé PTY súčasne: zoznam adresára, <code>/etc/network/interfaces</code>, <code>iftop</code> a hlavná ponuka ProxMenux. Prepínač rozloženia na paneli nástrojov mení mriežku a karty.",
"keyboard": {
"heading": "Tlačidlá klávesnice pre mobilné zariadenia",
"intro": "Klávesnice telefónov a tabletov zvyčajne nemajú ESC, TAB, šípky ani kombinácie s modifikátormi. Tieto klávesy sú potrebné pre <code>vim</code>, <code>nano</code>, <code>htop</code> a ponuky TUI. Terminál preto na malých alebo dotykových zariadeniach zobrazuje pod terminálom rad dotykových tlačidiel:",
"headerButton": "Tlačidlo",
"headerSends": "Posiela",
"headerUse": "Typické použitie",
"rows": [
{
"button": "ESC",
"sends": "\\x1b",
"use": "Ukončí režim vkladania v <code>vim</code>, zruší dialóg TUI alebo ukončí vyhľadávanie."
},
{
"button": "TAB",
"sends": "\\t",
"use": "Automatické dopĺňanie ciest a prechod medzi poľami v dialog/whiptail."
},
{
"button": "↑ ↓ ← →",
"sends": "\\x1bO[ABCD]",
"use": "História shellu, pohyb kurzora a navigácia ponúk."
},
{
"button": "↵ Enter",
"sends": "\\r",
"use": "Potvrdenie. Niektoré klávesnice nahrádzajú Enter tlačidlami Prejsť/Hotovo; toto tlačidlo je jednoznačné."
},
{
"button": "Ctrl ▾",
"sends": "Rozbaľovací zoznam",
"useRich": true
}
],
"ctrlIntro": "Tri kontrolné sekvencie:",
"ctrlItems": [
"<code>Ctrl+C</code> — zruší alebo preruší bežiaci príkaz (<code>\\x03</code>).",
"<code>Ctrl+X</code> — ukončí <code>nano</code> (<code>\\x18</code>).",
"<code>Ctrl+R</code> — spätné vyhľadávanie v histórii bash (<code>\\x12</code>)."
],
"modalTitle": "Rovnaký panel nástrojov v okne konzoly LXC",
"modalBody": "Konzola otvorená cez <link>VM a LXC → Konzola</link> zobrazuje rovnaké tlačidlá klávesnice pod oknom. Pri pripojení automaticky zadá <code>pct enter &lt;vmid&gt;</code>, čím vstúpite priamo do kontajnera."
},
"lxcAlt": "Okno konzoly LXC ProxMenux Monitor — Terminal: ubuntu (ID: 103), s rovnakým mobilným panelom nástrojov (ESC, TAB, šípky, Enter, Ctrl) pod terminálom",
"lxcCaption": "Konzola LXC otvorená cez <em>VM a LXC → Konzola</em>. Hlavička uvádza cieľový kontajner (<em>Terminal: ubuntu (ID: 103)</em>) a pod terminálom sa zobrazuje rovnaký dotykový panel nástrojov.",
"search": {
"heading": "Vyhľadávanie príkazov — integrovaný prehľad",
"intro": "Modré tlačidlo <strong>Hľadať</strong> otvorí približné vyhľadávanie príkazov. Zadajte niekoľko písmen príkazu Linux alebo Proxmox (<code>ls</code>, <code>tar</code>, <code>qm</code>, <code>pct</code>, <code>zpool</code>, <code>systemctl</code>…) a zobrazia sa príklady s voľbou <em>Odoslať do aktívneho terminálu</em> jedným dotykom. Voľbu príkazu tak nájdete bez prepínania karty prehliadača.",
"modalAlt": "Okno Vyhľadávanie príkazov ProxMenux Monitor — približné vyhľadávanie príkazov Linux a Proxmox cez cheat.sh s príkladmi ls",
"modalCaption": "Vyhľadávanie <code>ls</code> — každý výsledok zobrazuje príkaz, opis a malú šípku na odoslanie do aktívneho terminálu. Vpravo dole je uvedený zdroj údajov (<em>Údaje z cheat.sh</em>).",
"aboutLabel": "O cheat.sh:",
"aboutBody": "je open-source prehľad spravovaný komunitou s krátkymi praktickými príkladmi stoviek príkazov Linux, nástrojov správy a programovacích jazykov. Pôvodne bol navrhnutý na použitie cez <code>curl cheat.sh/&lt;command&gt;</code>, ale je dostupný aj v prehliadači. ProxMenux Monitor posiela dotazy cez proxy na serveri, aby okno používalo rovnaký pôvod ako panel.",
"headerSource": "Zdroj",
"headerWhen": "Keď sa použije",
"headerWhat": "Čo vidíš",
"onlineLabel": "(online)",
"onlineWhen": "Keď má hostiteľ prístup na internet a cheat.sh proxy odpovedá.",
"onlineWhat": "Niekoľko praktických príkladov na príkaz s opisom nad nimi. Stavová bodka v hlavičke je <green>zelená</green>.",
"fallbackLabel": "Miestna záložná možnosť",
"fallbackWhen": "Keď cheat.sh je nedostupný (offline hostiteľ, obmedzujúci firewall, cheat.sh výpadok).",
"fallbackWhat": "Pribalený zoznam bežných príkazov Linux a Proxmox. Menší katalóg, ale vždy dostupný. Stavová bodka je <red>červená</red>.",
"sendingNote": "<strong>Ako funguje odosielanie</strong>: šípka vedľa výsledku odošle text do aktívneho terminálu (vybraná karta alebo posledný terminál, na ktorý ste klikli v mriežke). Okno sa automaticky zatvorí, aby ste mohli stlačiť Enter."
},
"auth": {
"heading": "Prihlásenie",
"items": [
"Prehliadač najprv požiada o jednorazový lístok cez <code>POST /api/terminal/ticket</code> s JWT v hlavičke <code>Authorization</code>. Lístok následne odošle pri otvorení WebSocketu. Platí 5 sekúnd; pri zapnutom overovaní chýbajúci alebo neplatný lístok ukončí spojenie pred vytvorením PTY.",
"Ak je Monitor za reverzným proxy, proxy musí posielať požiadavky na upgrade WebSocket. Príklady pre Nginx / Caddy / Traefik sú na stránke <link>Prístup a overenie</link>."
]
},
"clipboard": {
"heading": "Schránka, história výstupu a zmena veľkosti",
"items": [
"<strong>Kopírovanie a prilepenie</strong> — používa schránku prehliadača. Vyberte text myšou alebo trackpadom a použite systémovú skratku (<code>Cmd+C</code> na macOS, <code>Ctrl+Shift+C</code> na Linux/Windows). Prostredia Linux podporujú aj prilepenie prostredným tlačidlom.",
"<strong>História výstupu</strong> — posúvanie kolieskom alebo dvoma prstami. xterm.js uchováva v pamäti posledných niekoľko tisíc riadkov.",
"<strong>Zmena veľkosti</strong> — pri zmene veľkosti panela terminál prispôsobí okno PTY, aby sa <code>htop</code> a <code>vim</code> zobrazovali správne.",
"<strong>Opätovné pripojenie po návrate na kartu</strong> — prepnutie aplikácie v telefóne alebo tablete, najmä iPade, môže prerušiť WebSocket. Terminál zistí zmenu viditeľnosti a po návrate sa pripojí, s časovým limitom 15 sekúnd pre pomalé VPN."
]
},
"disconnect": {
"heading": "Príčiny odpojenia",
"intro": "Najčastejšie príčiny ukončenia relácie a ich riešenia:",
"headerCause": "Príčina",
"headerFix": "Riešenie",
"rows": [
{
"cause": "JWT relácie vypršal pri otváraní alebo opätovnom pripájaní terminálu (platnosť 24 h).",
"fix": "Obnovte stránku a prihláste sa znova. Terminál nie je určený na bezobslužné relácie; platnosť JWT je rovnaká ako pri bežnom prihlásení do panela."
},
{
"cause": "Časový limit nečinnosti reverzného proxy.",
"fix": "Zvýšte <code>proxy_read_timeout</code> v Nginx alebo ekvivalent v Caddy / Traefik (príklady na stránke Prístup a overenie)."
},
{
"cause": "Telefón alebo tablet v režime spánku.",
"fix": "Po prebudení zariadenia sa karta automaticky pripojí (časový limit 15 s pre VPN). Ak nie, obnovte ju."
},
{
"cause": "Reštart služby na hostiteľovi.",
"fix": "Každý reštart <code>proxmenux-monitor.service</code> ukončí všetky PTY. Nové terminály otvorte po dokončení načítania panela."
}
]
},
"warning": {
"title": "Terminál je shell root na hostiteľovi",
"body": "Terminál zdedí používateľa jednotky systemd (<code>root</code>) a má plné oprávnenia na hostiteľovi Proxmox. Pred sprístupnením mimo miestnej siete nastavte meno, heslo a 2FA v <authLink>Prístup a overenie</authLink>. Pri vypnutom overovaní môže každý s prístupom k portu 8008 otvoriť shell root bez ďalších potvrdení či prihlasovacích údajov SSH. Na prístup zvonka použite <gatewayLink>Secure Gateway</gatewayLink> (Tailscale) alebo reverzný proxy s HTTPS namiesto zverejnenia portu na internete."
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Prístup a overenie",
"href": "/docs/monitor/access-auth",
"tail": " — príklady reverzného proxy s riadkami na upgrade WebSocket potrebnými pre terminál."
},
{
"label": "Architektúra",
"href": "/docs/monitor/architecture",
"tail": " — prenos WebSocket (HTTP cez flask-sock a HTTPS / WSS cez gevent)."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tail": " — koncové body WebSocket /ws/terminal a /ws/script/<sid> spolu so zvyškom API."
},
{
"label": "Integrácia → Bezpečná brána",
"href": "/docs/monitor/integrations",
"tail": " — prístup k terminálu mimo LAN bez sprístupnenia portu 8008."
},
{
"label": "Index panela",
"href": "/docs/monitor/dashboard",
"tail": " — Ostatné karty."
}
]
}
}
@@ -10,7 +10,9 @@
"intro": {
"p1": "Karta <strong>App</strong> zaznamenáva, ktoré aplikácie patria do LXC. Záznam môže obsahovať iba názov a webový odkaz alebo aj detektor nainštalovanej verzie a zdroj dostupnej verzie.",
"p2": "Postup, ktorý mení softvér, sa nastavuje samostatne na <link>karte Aktualizácie</link>. Uloženie aplikácie nikdy nespúšťa inštalátor ani aktualizátor.",
"callout": "Registrácia, sledovanie verzie a aktualizácia sú tri nezávislé možnosti. Každú možno používať bez ostatných dvoch."
"callout": "Registrácia, sledovanie verzie a aktualizácia sú tri nezávislé možnosti. Každú možno používať bez ostatných dvoch.",
"dashboardTitle": "Od registrácie k spúšťaču aplikácií",
"dashboard": "Každý webový odkaz uložený tu sa zobrazí aj ako karta na hlavnej <appsLink>karte Apps</appsLink>. Táto stránka LXC zostáva hlavným zdrojom názvu aplikácie, loga, odkazov a sledovania verzie."
},
"overview": {
"heading": "Čo môže obsahovať záznam aplikácie",
@@ -29,7 +31,7 @@
"lead": "Návrhy aplikácií sú súčasťou vyrovnávacej pamäte modálneho okna každého LXC. Úvodné skenovanie ich pripraví na pozadí, takže karta App môže okamžite zobraziť uložené výsledky.",
"items": [
"Otvorenie karty App <strong>nespustí</strong> nové skenovanie katalógu ani opakované dotazy do LXC.",
"<strong>Hľadať aplikácie</strong> výslovne spustí nové zisťovanie iba pre daný LXC. Používa sa po inštalácii softvéru počas behu ProxMenux.",
"<strong>Hľadať aplikácie</strong> výslovne spustí nové zisťovanie pre daný LXC. Použite po inštalácii softvéru počas behu ProxMenux.",
"Predchádzajúci zoznam zostáva počas hľadania viditeľný. Nové zhody sa pridajú po dokončení.",
"Ak sa nenájde nová zhoda, výsledok sa zobrazí pri akciách a <strong>Registrovať aplikáciu</strong> zostáva dostupné pre manuálne zadanie.",
"Uloženie, odstránenie alebo obnovenie aplikácie okamžite aktualizuje rovnakú pamäť. Štart alebo obnova LXC aktualizuje iba daný systém cez existujúcu udalosť životného cyklu."
@@ -40,10 +42,10 @@
"heading": "Registrácia aplikácie",
"lead": "Zistený návrh aj manuálny záznam používajú rovnaký editor:",
"steps": [
"Stlačte <strong>Registrovať</strong> pri návrhu alebo <strong>Registrovať aplikáciu</strong> a vyberte položku katalógu alebo zadajte vlastný názov.",
"Stlačte <strong>Registrovať</strong> pri návrhu alebo <strong>Registrovať aplikáciu</strong> a vyberte z katalógu či zadajte vlastný názov.",
"Skontrolujte názov a logo navrhnuté katalógom.",
"Pridajte potrebné webové odkazy. Zistené otvorené porty sa ponúknu ako skratky, ale neuložia sa automaticky.",
"Pre záznam iba s odkazom nechajte <strong>Sledovať dostupnú verziu</strong> vypnuté alebo ho zapnite a skontrolujte detektor a zdroj verzie.",
"Pre záznam iba s odkazom nechajte <strong>Sledovať dostupnú verziu</strong> vypnuté alebo ho zapnite a skontrolujte detektor nainštalovanej verzie a zdroj dostupnej verzie.",
"Pri zapnutom sledovaní použite <strong>Otestovať detektor</strong> a potom záznam uložte.",
"Po úpravách stlačte <strong>Hotovo</strong>. Karty App a Aktualizácie použijú aktualizovaný záznam z pamäte."
]
@@ -88,23 +90,48 @@
"colMethod": "Metóda nainštalovanej verzie",
"colUse": "Použitie",
"detectorRows": [
{ "method": "dpkg / apk", "use": "Číta verziu nainštalovaného balíka z metadát Debianu, Ubuntu alebo Alpine." },
{ "method": "binary", "use": "Spustí absolútnu cestu binárneho súboru alebo názov príkazu s parametrami verzie." },
{ "method": "file + regex", "use": "Číta skutočný súbor a extrahuje verziu pomocou jednej zachytávacej skupiny." },
{ "method": "docker label / docker exec", "use": "Číta OCI značku verzie alebo spustí príkaz verzie v Docker kontajneri." },
{ "method": "python distribution", "use": "Používa importlib.metadata cez vybraný interpreter Pythonu." },
{ "method": "command", "use": "Spustí pokročilý príkaz vo formáte argv bez shellu a extrahuje verziu z výstupu." },
{ "method": "manual", "use": "Uloží manuálne zadanú verziu; po aktualizácii aplikácie ju treba zmeniť." }
{
"method": "dpkg / apk",
"use": "Číta verziu nainštalovaného balíka z metadát Debianu, Ubuntu alebo Alpine."
},
{
"method": "binary",
"use": "Spustí absolútnu cestu binárneho súboru alebo názov príkazu s parametrami verzie."
},
{
"method": "file + regex",
"use": "Číta skutočný súbor a extrahuje verziu pomocou jednej zachytávacej skupiny."
},
{
"method": "docker label / docker exec",
"use": "Číta OCI značku verzie alebo spustí príkaz verzie v Docker kontajneri."
},
{
"method": "python distribution",
"use": "Používa importlib.metadata cez vybraný interpreter Pythonu."
},
{
"method": "command",
"use": "Spustí pokročilý príkaz vo formáte argv bez shellu a extrahuje verziu z výstupu."
},
{
"method": "manual",
"use": "Uloží manuálne zadanú verziu; po aktualizácii aplikácie ju treba zmeniť."
},
{
"method": "OCI image",
"use": "Pre kontajnery nainštalované cez OCI manager Apps. Číta verzie aplikácie a obrazu z inštalačného záznamu a porovná nainštalovaný digest s digestom z registra. Nevyžaduje nastavenie."
}
],
"sourcesHeading": "Zdroje dostupnej verzie",
"sources": [
"<strong>GitHub repozitár</strong>: najnovšie vydanie alebo značka verejného repozitára <code>vlastník/názov</code>.",
"<strong>GitHub repozitár</strong>: najnovšie vydanie alebo značka verejného repozitára <code>owner/name</code>.",
"<strong>HTTP JSON</strong>: verejný koncový bod a cesta ako <code>data.version</code> alebo <code>releases[0].tag_name</code>.",
"<strong>Docker Hub</strong>: verzované značky filtrované regulárnym výrazom. Živý náhľad pred uložením ukáže skutočné zodpovedajúce značky.",
"Pohyblivé značky ako <code>latest</code>, <code>stable</code> alebo <code>lts</code> neobsahujú verziu. Tieto obrazy sledujte podľa digestu v aktualizáciách Docker obrazov."
],
"regexHeading": "Zachytávací výraz",
"regexLead": "Regulárny výraz detektora musí vrátiť verziu vo svojej <strong>prvej zachytávacej skupine</strong>.",
"regexLead": "Regulárny výraz musí vrátiť verziu v <strong>prvej zachytávacej skupine</strong>.",
"regexRules": [
"Výraz musí zodpovedať textu vybraného binárneho súboru, súboru, príkazu alebo zdroja značiek; nepoužívajte odhadovanú všeobecnú cestu.",
"Doslovné bodky escapujte ako <code>\\.</code>, aby nezodpovedali ľubovoľnému znaku.",
@@ -132,11 +159,31 @@
"colDisplay": "Zobrazenie",
"colMeaning": "Význam",
"rows": [
{ "state": "Dostupná aktualizácia", "display": "Dostupná verzia fialovo s ikonou šípky nahor", "meaning": "Nainštalovaná a dostupná verzia sa líšia." },
{ "state": "Aktuálne", "display": "Nainštalovaná a dostupná verzia bez fialového upozornenia", "meaning": "Posledná kontrola nenašla novšiu verziu." },
{ "state": "Sledovanie čaká", "display": "Stav kontroly alebo čakania", "meaning": "Záznam je nastavený, ale ešte nedokončil obe kontroly." },
{ "state": "Sledovanie vypnuté", "display": "Iba webové odkazy bez porovnania verzií", "meaning": "Záznam zostáva platný a môže mať aktualizátor." },
{ "state": "Chyba kontroly", "display": "Jantárové vysvetlenie na karte", "meaning": "Predchádzajúci uložený stav zostane viditeľný a zobrazí sa chyba detektora alebo zdroja." }
{
"state": "Dostupná aktualizácia",
"display": "Dostupná verzia fialovo s ikonou šípky nahor",
"meaning": "Nainštalovaná a dostupná verzia sa líšia."
},
{
"state": "Aktuálne",
"display": "Nainštalovaná a dostupná verzia bez fialového upozornenia",
"meaning": "Posledná kontrola nenašla novšiu verziu."
},
{
"state": "Sledovanie čaká",
"display": "Stav kontroly alebo čakania",
"meaning": "Záznam je nastavený, ale ešte nedokončil obe kontroly."
},
{
"state": "Sledovanie vypnuté",
"display": "Iba webové odkazy bez porovnania verzií",
"meaning": "Záznam zostáva platný a môže mať aktualizátor."
},
{
"state": "Chyba kontroly",
"display": "Jantárové vysvetlenie na karte",
"meaning": "Predchádzajúci uložený stav zostane viditeľný a zobrazí sa chyba detektora alebo zdroja."
}
]
},
"management": {
@@ -155,11 +202,26 @@
"colProblem": "Situácia",
"colResolution": "Riešenie",
"rows": [
{ "problem": "Softvér bol nainštalovaný po štarte ProxMenux", "resolution": "Stlačte Hľadať aplikácie. Výslovné skenovanie aktualizuje návrhy v pamäti daného LXC." },
{ "problem": "Aplikácia nebola zistená", "resolution": "Zaregistrujte ju manuálne. Stačí názov a jeden webový odkaz; sledovanie možno pridať neskôr." },
{ "problem": "Navrhnutý detektor vracia nesprávnu verziu", "resolution": "Otvorte Upraviť polia, vyberte skutočný balík, binárny súbor alebo súbor a pred uložením otestujte detektor." },
{ "problem": "Služba Dockeru sa neponúka ako aplikácia LXC", "resolution": "Zaregistrujte Docker a pridajte publikované rozhranie služby ako webový odkaz Dockeru. Aktualizácie obrazov zostanú v sekcii Docker." },
{ "problem": "Uložená aplikácia nemá tlačidlo aktualizácie", "resolution": "Otvorte Aktualizácie a nastavte jej metódu. Samotné sledovanie verzie neurčuje, ako sa aktualizácia nainštaluje." }
{
"problem": "Softvér bol nainštalovaný po štarte ProxMenux",
"resolution": "Stlačte Hľadať aplikácie. Výslovné skenovanie aktualizuje návrhy v pamäti daného LXC."
},
{
"problem": "Aplikácia nebola zistená",
"resolution": "Zaregistrujte ju manuálne. Stačí názov a jeden webový odkaz; sledovanie možno pridať neskôr."
},
{
"problem": "Navrhnutý detektor vracia nesprávnu verziu",
"resolution": "Otvorte Upraviť polia, vyberte skutočný balík, binárny súbor alebo súbor a pred uložením otestujte detektor."
},
{
"problem": "Služba Dockeru sa neponúka ako aplikácia LXC",
"resolution": "Zaregistrujte Docker a pridajte publikované rozhranie služby ako webový odkaz Dockeru. Aktualizácie obrazov zostanú v sekcii Docker."
},
{
"problem": "Uložená aplikácia nemá tlačidlo aktualizácie",
"resolution": "Otvorte Aktualizácie a nastavte jej metódu. Samotné sledovanie verzie neurčuje, ako sa aktualizácia nainštaluje."
}
]
},
"figures": {
@@ -56,7 +56,7 @@
"notes": "Stiahne vybraný obraz a znova vytvorí jeho skupinu služieb Compose alebo chránený samostatný kontajner."
}
],
"callout": "Vlastný príkaz <strong>nahrádza</strong> Helper-Scripts pre danú aplikáciu. Ručné, hromadné aj naplánované spustenia rešpektujú uložený výber. Existujúce príkazy a staršie výslovne uložené výbery v plánoch alebo aktívnych naplánovaných úlohách sa zachovajú; starší plán nikdy neaktivuje aktualizátor novo registrovanej aplikácie."
"callout": "Vlastný príkaz <strong>nahrádza</strong> Helper-Scripts pre danú aplikáciu. Ručné, hromadné aj plánované behy rešpektujú uloženú voľbu. Existujúce príkazy a staršie výslovne uložené výbery v hromadných plánoch či aktívnych úlohách sa zachovajú; starý plán nikdy nezahrnie novo registrovanú aplikáciu."
},
"docker": {
"heading": "Docker Engine a Docker obrazy",
@@ -90,7 +90,7 @@
},
{
"state": "Overene aktuálne",
"appearance": "Zelená kontrola a zelená akcia Aktualizované",
"appearance": "Zelená značka a zelená akcia Aktualizované",
"meaning": "Posledná dokončená kontrola potvrdila, že cieľ je aktuálny."
},
{
@@ -110,7 +110,7 @@
"Nepridávajte <code>pct exec</code>; ProxMenux už vstupuje do kontajnera a príkaz spúšťa ako root."
],
"exampleLead": "Príklad úplného postupu v kontajneri:",
"example": "cd /opt/moja-aplikacia && ./update.sh",
"example": "cd /opt/my-app && ./update.sh",
"callout": "Príkaz ako <code>myapp --version</code> iba číta verziu a nič neaktualizuje. Príkazy sa spúšťajú s oprávneniami správcu a musia sa kontrolovať ako príkazy shellu root."
},
"bulk": {
@@ -120,7 +120,7 @@
"Balíky OS sú povinné. Musí byť vybraná aspoň jedna ďalšia aplikácia, Docker Engine alebo jednotka Docker obrazu.",
"Aplikácie a jednotky Dockeru sa vyberajú samostatne. Hlavná služba Compose zobrazuje závislosti, ktoré sa aktualizujú spolu s ňou.",
"Odstránené alebo nedostupné ciele sa označia ako neaktuálne a pred uložením ich treba odstrániť.",
"Tlačidlo <strong>Použiť aktualizácie</strong> je fialové, ak má niektorý vybraný cieľ overenú aktualizáciu, zelené, ak sú všetky overene aktuálne, a neutrálne pri neznámom výsledku.",
"<strong>Použiť aktualizácie</strong> je fialové, ak má niektorý cieľ overenú aktualizáciu, zelené, ak sú všetky overene aktuálne, a neutrálne pri neznámom výsledku.",
"Odstránenie hromadnej konfigurácie neodstráni samostatné metódy ani plánovanie."
],
"callout": "Hromadná aktualizácia nenahrádza samostatné tlačidlá. Je to voliteľná skratka pre výber, ktorý sa má spustiť spolu."
@@ -140,8 +140,11 @@
"items": [
"Vyberte predvoľbu alebo cron výraz a potom presné ciele: balíky OS, jednotlivé aplikácie, Docker Engine, samostatné jednotky Dockeru alebo skupiny služieb Compose.",
"Oneskorenie po vydaní platí iba pre vybrané aplikácie so sledovaním verzie. Aplikácie bez sledovania spustia aktualizátor pri každom termíne.",
"Stav posledného behu rozlišuje úspech, čiastočné dokončenie, zlyhanie, bezpečnostné pozdržanie a stav bez čakajúcich aktualizácií.",
"Zistené externé plány Proxmox VE Helper-Scripts sa zobrazia samostatne, aby bola viditeľná prekrývajúca sa automatizácia."
"Stav posledného behu rozlišuje úspech, čiastočné dokončenie, zlyhanie, bezpečnostné pozastavenie a žiadne čakajúce aktualizácie. Po prvom plánovanom behu otvorí <strong>Aktualizácie → Plánované aktualizácie → Zobraziť záznam</strong> celý výstup aktualizátora a podradených skriptov.",
"Po každom spustení ProxMenux skontroluje štandardnú značku Debianu oznamujúcu potrebu reštartu. Ak je reštart potrebný, karta Aktualizácie aj záverečné upozornenie to oznámia. Varovanie sa zruší pri spustení alebo reštarte daného LXC.",
"Na počítači Proxmox sa v <code>/usr/local/share/proxmenux/logs/lxc-updates/</code> ukladajú záznamy plánovaného priebehu pomocou mena <code>&lt;VMID&gt;-scheduled-&lt;run-id&gt;.log</code>. Posledných desať protokolov je zachovaných na LXC a staršie súbory sú automaticky odstránené.",
"Táto zachovaná história sa vzťahuje na plánované aktualizácie. Manuálna aktualizácia zobrazuje svoj výstup naživo v okne vykonávania monitora a v tomto adresári nevytvára plánovaný záznam.",
"Externé plány na hostiteľovi zistené z Proxmox VE Helper-Scripts sa zobrazujú samostatne, aby bolo vidieť prekrývajúce sa automatizácie."
],
"callout": "Pred zapnutím plánu otestujte každú vybranú metódu manuálne. Plánovaný príkaz nemôže odpovedať na interaktívne otázky."
},
@@ -150,9 +153,10 @@
"lead": "Aktualizácia sa nepovažuje za dokončenú iba preto, že príkaz v termináli skončil.",
"items": [
"Rovnaký beh uloží konečný výsledok a podľa potreby obnoví stav balíkov OS, verzie aplikácií a inventár Dockeru.",
"Vyrovnávacia pamäť LXC sa nahradí overeným stavom po aktualizácii, takže odznaky a tlačidlá nezostanú v starom stave.",
"Po spustení zastaveného alebo obnoveného LXC existujúca udalosť životného cyklu znova obnoví tento LXC. Inventár Dockeru čaká na pripravenosť démona a dočasne prázdny výsledok nepovažuje za konečný.",
"Povolené upozornenia sa odošlú z dokončeného behu vrátane čiastočných zlyhaní a zoskupených výsledkov Docker obrazov."
"Plánované behy uchovávajú výstup terminálu a oznamujú, či je na dokončenie zmien balíkov ešte potrebný reštart.",
"Vyrovnávacia pamäť LXC sa nahradí overeným stavom po aktualizácii, aby označenia a tlačidlá nezostali v pôvodnom stave.",
"Ak sa spustí zastavený alebo obnovený LXC, existujúca udalosť životného cyklu znova obnoví jeho údaje. Inventarizácia Dockeru počká na pripravenosť démona, aby sa prázdny výsledok pri štarte neuložil ako konečný.",
"Zapnuté oznámenia sa odosielajú po dokončení behu vrátane čiastočných zlyhaní a zoskupených výsledkov Docker obrazov."
]
},
"troubleshooting": {
@@ -179,6 +183,10 @@
{
"problem": "Vlastný príkaz zlyhá",
"resolution": "Spustite ho v termináli LXC a skontrolujte cestu, závislosti, neinteraktívne parametre a návratový kód."
},
{
"problem": "Plánovaná aktualizácia hovorí, že je potrebné reštartovať",
"resolution": "Otvorte Zobraziť záznam, skontrolujte dokončený beh a reštartujte daný LXC. ProxMenux vymaže upozornenie, keď udalosť životného cyklu zaznamená nový štart."
}
]
},
@@ -0,0 +1,244 @@
{
"meta": {
"title": "ProxMenux Monitor — Panel: VM a LXC | Dokumentácia ProxMenux",
"description": "Inventár hosťovských systémov so živými údajmi CPU, pamäte a disku. Podrobnosti obsahujú konfiguráciu, zdroje, zálohy, nedávne výsledky záznamu Proxmox, poznámky a Spustiť / Vypnúť / Reštartovať / Vynútiť vypnutie."
},
"header": {
"title": "Panel: VM a LXC",
"description": "Úplný inventár hosťovských systémov uzla: štyri metriky hore, triediteľný zoznam VM a LXC a podrobnosti s konfiguráciou, zdrojmi, zálohami, záznamami a ovládaním Spustiť / Vypnúť / Reštartovať / Vynútiť vypnutie.",
"section": "ProxMenux Monitor · Prehľad"
},
"intro": {
"title": "Ovládanie hosťovských systémov",
"body": "Táto karta ovláda životný cyklus hosťovských systémov. Akcie idú cez <code>POST /api/vms/&lt;vmid&gt;/control</code> s výslovným potvrdením a aktualizujú riadok systému. Nútené vypnutie vyžaduje samostatné tlačidlo Vynútiť vypnutie."
},
"topRow": {
"heading": "Horný riadok: štyri štatistické karty",
"intro": "Štyri karty sumarizujú stav systémov: celkové počty, využitie CPU, pridelenú pamäť oproti kapacite hostiteľa a pridelený diskový priestor.",
"imageAlt": "VMs & LXCs záložka Vrchný rad štyroch stat kariet: Celkom VMs & LXCs, Spolu CPU, celková pamäť, celkový disk",
"imageCaption": "Horný riadok: celkové počty a stavy Spustené / Zastavené, využitie CPU, použitá pamäť / pridelená bežiacim systémom / celkovo pridelená pamäť s označením V rámci limitov a pridelené miesto na disku.",
"headerCard": "Karta",
"headerWhat": "Čo ukazuje",
"totalLabel": "VM a LXC spolu",
"totalWhat": "Celkový počet s dvoma odznakmi <em>X Beh</em> (zelená) a <em>Y zastavená</em> (červená, len ak > 0). Číslo, ktoré pozeráš, keď sa po reštarte niečo nevrátilo.",
"cpuLabel": "CPU celkom",
"cpuWhat": "Celkové živé využitie CPU všetkých systémov ako percento fyzického CPU hostiteľa s textom <em>„Využitie pridelenej CPU“</em>.",
"memoryLabel": "Pamäť spolu",
"memoryIntro": "Tri hodnoty nastavené vertikálne:",
"memoryItems": [
"<strong>Aktuálne použitá</strong> — hlavná hodnota, napríklad <em>15.4 GB</em>, a <em>X.X % z Y GB</em> vzhľadom na RAM hostiteľa. Modrý ukazovateľ zobrazuje percento.",
"<strong>Pridelená bežiacim</strong> + <strong>Celkovo pridelená</strong> — súčet <code>maxmem</code> pre <em>bežiace</em> systémy a pre <em>všetky</em> vrátane zastavených. Prvý je dôležitý teraz, druhý pri spustení všetkých naraz.",
"<strong>V rámci limitov</strong>, zelené, sa zmení na <em>Nadmerne pridelené</em>, ak súčet prekročí RAM hostiteľa. Kontrolované nadmerné prideľovanie môže fungovať s KSM; označenie včas upozorní na malú rezervu."
],
"diskLabel": "Disk spolu",
"diskWhat": "Súčet miesta na disku prideleného všetkým systémom v GB alebo TB s textom <em>„Pridelené miesto na disku“</em>."
},
"inventory": {
"heading": "Zoznam virtuálnych strojov a kontajnerov",
"intro": "Jeden riadok na systém. Zoznam pochádza z <code>/api/vms</code>, ktoré spája <code>qm list</code> + <code>pct list</code> + <code>pvesh /cluster/resources</code> na hostiteľovi.",
"imageAlt": "Virtuálne stroje & Kontajnery Zoznam 1 riadok na hosťa so statusom, typovým odznakom, menom, ID a inline CPU / pamäť / percento disku",
"imageCaption": "Rozloženie inventára optimalizované pre mobilné zariadenia – rovnaké údaje, aké zobrazuje zobrazenie na počítači, preskupené do jedného stĺpca, pričom percentá a indikátory stavu sú kompaktné.",
"rowsIntro": "Každý riadok zobrazuje:",
"rows": [
"<strong>Ikona stavu</strong> — zelený trojuholník pri spustenom systéme alebo červený štvorec pri zastavenom. Zvyšok riadka zastaveného systému sa stlmí.",
"<strong>Typ</strong> — <em>LXC</em> azúrovou pre kontajnery, <em>VM</em> fialovou pre virtuálne stroje.",
"<strong>Názov</strong> — názov hostiteľa alebo zobrazovaný názov hosťovského systému.",
"<strong>VMID</strong> — číselné ID Proxmox pod názvom.",
"<strong>Vložené metriky</strong> 3 percentá s ikonou (CPU %, % pamäte, % disku). Každá ikona sa zmení na oranžovú, keď metrika prekročí prah pozornosti (napr. pamäť nad 90 %), takže rýchly sken vám povie, ktorý hosť je pod tlakom bez otvorenia."
],
"clickHint": "Kliknutie na riadok otvorí podrobnosti, či systém beží alebo je zastavený.",
"mobileTitle": "Zoznam navrhnutý pre mobilné zariadenia",
"mobileBody": "Na telefónoch a v úzkych oknách sa typ, názov, ID a tri percentá ukladajú do jedného stĺpca ako na snímke. Široké zobrazenie ich rozloží vodorovne. V oboch prípadoch celý riadok otvorí podrobnosti."
},
"drillIn": {
"heading": "Okno podrobností hosťovského systému",
"intro": "Detail sa otvorí s názvom hosťovského systému, VMID, typom, stavom a dobou prevádzky. Karty sa prispôsobujú jeho typu: <strong>Stav</strong>, <strong>Aplikácia</strong> a <strong>Aktualizácie</strong> pre správu aplikácií LXC, <strong>Pripojenia</strong> pri LXC s bodmi pripojenia, <strong>Záznamy</strong> pri kontajneroch nainštalovaných cez OCI manager Apps a ďalej <strong>Zálohy</strong> a <strong>Firewall</strong>. Pevný panel akcií sprístupňuje ovládanie prevádzky a terminál LXC na každej karte.",
"statusTitle": "Karta 1 — Stav",
"statusImageAlt": "Podrobnosti systému — Stav so živými údajmi CPU, pamäte a disku, diskovým a sieťovým I/O, logom systému a blokom Zdroje / IP adresy",
"statusImageCaption": "Stav: CPU, pamäť a disk s ukazovateľmi hore; celkové I/O (disk čítanie/zápis, sieť príjem/odoslanie); potom Zdroje s Poznámkami, + Info a zoznamom IP adries.",
"statusIntro": "Predvolená karta na overenie stavu systému. Tri bloky:",
"liveTitle": "1. Riadok živých metrík",
"liveItems": [
"<strong>Využitie CPU (X jadier)</strong> — percento s ukazovateľom. Nastavený počet jadier v hlavičke vysvetľuje, čo znamená 100 %.",
"<strong>Pamäť</strong> — <em>použitá / maximum</em> v GB s ukazovateľom.",
"<strong>Disk</strong> — <em>použité / maximum</em> pre hlavný obraz disku v rovnakom formáte."
],
"ioTitle": "2. I/O celkový počet + logo OS",
"ioItems": [
"<strong>Diskové I/O</strong> — celkové čítanie (↓) a zápis (↑) od štartu. Pomáha odhaliť náhly nárast I/O oproti bežnej aktivite systému.",
"<strong>Sieťové I/O</strong> — celkové prijaté (↓) a odoslané (↑) dáta, na rovnakom princípe.",
"<strong>Logo systému</strong> — ikona Debian / Ubuntu / Alpine / Windows / atď. podľa zisteného systému. Pomáha pri rozlišovaní otvorených okien."
],
"resourcesTitle": "3. Blok zdrojov",
"resourcesIntro": "Konfigurácia podľa Proxmoxu: jadrá CPU, pamäť (nastavené <code>maxmem</code>) a swap. Dve rozbaľovacie sekcie v hlavičke:",
"resourcesItems": [
"<strong>Poznámky</strong> — upraviteľný popis systému. Uloženie zavolá <code>PUT /api/vms/&lt;vmid&gt;/config</code> a zapíše do <code>/etc/pve/qemu-server/&lt;vmid&gt;.conf</code> alebo <code>/etc/pve/lxc/&lt;vmid&gt;.conf</code>.",
"<strong>+ Info</strong> — režim BIOS, typ stroja, stav agenta, položky passthrough hostpci, body pripojenia CT a poradie štartu."
],
"ipsTitle": "4. IP adresy",
"ipsBody": "Každá adresa IPv4 alebo IPv6 má zelené označenie. Zoznam je prázdny pri zastavenom systéme alebo VM bez agenta QEMU; LXC hlásia adresy priamo.",
"appTitle": "Karta 2 — App (iba LXC)",
"appIntro": "Registruje aplikácie LXC, ukladá webové odkazy a voliteľne porovnáva verzie. Návrhy pochádzajú zo štartovacej pamäte; <strong>Hľadať aplikácie</strong> zopakuje zisťovanie v tomto LXC po novej inštalácii.",
"appLinkLead": "Pozrite si",
"appLinkLabel": "vyhradená stránka aplikácie",
"appLinkTail": "pre zisťovanie v pamäti, registráciu s pomocou katalógu, webové odkazy Dockeru a detektory verzie.",
"updatesTitle": "Karta 3 — Aktualizácie (iba LXC)",
"updatesIntro": "Oddeľuje <strong>balíky OS</strong>, aplikácie, <strong>Docker Engine</strong> a Docker obrazy. Každý cieľ sa spúšťa samostatne alebo sa presne vyberie pre hromadnú či plánovanú akciu.",
"updatesLinkLead": "Pozrite si",
"updatesLinkLabel": "podrobná stránka Aktualizácie",
"updatesLinkTail": "pre integrované a vlastné aktualizátory, opätovné vytvorenie Docker kontajnerov, hromadný výber, bezpečnostné možnosti a plánovanie.",
"mountsTitle": "Karta 4 — Pripojenia (iba LXC, ak existujú)",
"mountsImageAlt": "Podrobnosti LXC, Pripojenia: zväzky PVE, bind mounty hostiteľa či úložiska PVE a NFS/CIFS pripojené v CT. Karta obsahuje typ, kapacitu, použité/celkové bajty, možnosti a stav: zelený funkčný, jantárový iba čítanie/odchýlka, červený nedostupný.",
"mountsImageCaption": "Karta Pripojenia sa zobrazuje iba pri kontajneroch LXC s aspoň jedným bodom pripojenia alebo dodatočne pripojeným vzdialeným súborovým systémom. CT bez pripojení túto kartu nemá.",
"mountsIntro": "Proxmox zobrazuje pripojenia nakonfigurované ako <code>mpX</code>, nie však pridané neskôr v CT cez <code>mount.cifs</code>, NFS cez <code>autofs</code> a podobne. Karta spája <strong>oba pohľady</strong>: nakonfigurované pripojenia <strong>a</strong> pripojenia zistené v kontajneri, so stavom a kapacitou, ak ju server vie získať.",
"mountTypesTitle": "Typy zisteného pripojenia",
"mountTypesItems": [
"<strong>Zväzok PVE</strong> — úložisko spravované Proxmoxom, napríklad podzväzok ZFS, adresár alebo Ceph RBD. Kapacita pochádza zo štatistík PVE a zodpovedá Proxmoxu.",
"<strong>Bind z úložiska PVE</strong> — položka <code>mpX</code> smerujúca na cestu úložiska známeho PVE.",
"<strong>Bind z hostiteľa</strong> — položka <code>mpX</code> s ľubovoľnou cestou hostiteľa (<code>/mnt/something</code>). Kapacitu poskytuje <code>df</code> pre túto cestu.",
"<strong>Pripojenie pridané v CT</strong> — existuje <em>iba</em> v mennom priestore kontajnera, napríklad NFS zdieľanie pripojené samotným CT. Kapacita sa číta cez <code>pct exec &lt;vmid&gt; df</code>; <code>/proc/&lt;pid&gt;/root</code> z hostiteľa neukazuje skutočné štatistiky vzdialeného pripojenia."
],
"mountStateTitle": "Bodka na karte a upozornenia",
"mountStateItems": [
"<green/> <strong>Zelená</strong> — pripojenie je funkčné a dostupné.",
"<amber/> <strong>Jantárová</strong> — nastavené, ale nepripojené, iba na čítanie alebo <em>zombie bind</em>. Zdroj na hostiteľovi bol odstránený, ale CT ho stále vidí pripojený, napríklad po odpojení USB disku alebo <code>umount</code> na hostiteľovi.",
"<red/> <strong>Červená</strong> — nedostupné: kontrola sa nedostala k pripojeniu, napríklad NFS zdieľanie s vypnutým serverom."
],
"mountsCalloutTitle": "Ďalšie informácie oproti Proxmoxu",
"mountsCalloutBody": "Prehľad všetkých miest, z ktorých kontajner číta alebo do ktorých zapisuje, vrátane ich kapacity. Zdieľania NFS alebo CIFS pripojené zvnútra CT, ktoré webové rozhranie Proxmox nevidí, sa tu zobrazujú s rovnakým vzhľadom a kontrolou stavu ako nakonfigurované prípojné body. Nefunkčné vzdialené pripojenia a neplatné bind mounty sa označia skôr, než spôsobia problém pri zálohovaní.",
"logsTitle": "Karta 5 — Záznamy (iba kontajnery OCI)",
"logsBody": "Iba pre kontajnery OCI manager Apps. Ukazuje konzolu hlavného procesu obrazu z <code>/var/log/proxmenux/oci/VMID.console.log</code>: posledných 100, 500 alebo 1000 riadkov, živé sledovanie počas behu, filter a stiahnutie. Súbor znovu načíta pri otvorení aj pri zastavenom kontajneri. Podrobnosti: <ociLink>Kontajnery OCI v ProxMenux Monitor</ociLink>.",
"backupsTitle": "Karta 6 — Zálohy",
"backupsImageAlt": "Podrobnosti systému — karta Zálohy so zoznamom dostupných záloh, cieľmi, veľkosťami a tlačidlom Vytvoriť zálohu",
"backupsImageCaption": "Všetky zálohy systému na nastavených úložiskách Proxmox, od najnovšej. Hlavička uvádza ich počet.",
"backupsIntro": "Uvádza zálohy systému na úložiskách Proxmox, od najnovšej. Počítadlo v názve ukazuje, či zálohy existujú. Každý riadok obsahuje:",
"backupsItems": [
"<strong>Časová pečiatka</strong> — dátum a čas behu.",
"<strong>Cieľ</strong> — úložisko (PBS-Cloud, PBS-Local, NFS-Backup, …), farebne podľa stavu.",
"<strong>Veľkosť</strong> — konečná veľkosť zálohy na disku."
],
"backupsOutro": "<strong>+ Vytvoriť zálohu</strong> spustí zálohu na úložisku označenom „Backup target“ v Proxmoxe. Obnova sa vykonáva vo webovom rozhraní Proxmox; Monitor ukazuje nedávne zálohy systému a umožňuje vytvoriť nové.",
"firewallTitle": "Karta 7 — Firewall",
"firewallIntro": "Číta záznam firewallu Proxmox daného systému priamo z hostiteľa, bez ďalšej služby a pravidelných dotazov. Karta je vždy prítomná; obsah závisí od zapnutia firewallu a od toho, či pravidlo zaznamenáva pakety.",
"firewallItems": [
"<strong>Firewall je vypnutý</strong> — oranžové upozornenie ukáže, kde ho zapnúť v Proxmoxe (<em>&lt;Container|VM&gt; → Firewall → Options</em>), a pripomenie, že aspoň jedno pravidlo musí mať <code>log: info</code> alebo vyššiu úroveň, aby sa pakety zobrazovali.",
"<strong>Firewall povolený, zatiaľ žiadne udalosti</strong> — nápoveda v prázdnom stave s rovnakou požiadavkou na protokolovanie, užitočná, keď ste práve zapli bránu firewall.",
"<strong>Udalosti sú dostupné</strong> — posúvateľný panel s neproporcionálnym písmom a pôvodnými položkami podľa akcie: <green>ACCEPT</green> zelená, <orange>REJECT</orange> oranžová, <red>DROP</red> červená. Počítadlo v hlavičke ukazuje počet načítaných položiek."
],
"firewallRefresh": "<em>Obnoviť</em> načíta najnovšie položky na požiadanie. Automatické obnovenie neprebieha; zoznam zachytáva otvorenie alebo posledné obnovenie. Zdroj je <code>/var/log/pve-firewall.log</code>, filtrovaný podľa VMID cez <code>GET /api/vms/&lt;vmid&gt;/firewall/log</code>.",
"firewallCalloutTitle": "Prečo ho tu máme, keď ho už ukazuje UI Proxmox?",
"firewallCalloutBody": "Odpadá prepínanie do Proxmoxu a pohľad zostáva na rovnakom VMID: spustite systém, skontrolujte pripojenia a udalosti firewallu a znova ho zastavte v paneli. Pravidlá sa upravujú v Proxmoxe; Monitor ich nemení.",
"actionBarTitle": "Akčný panel dole",
"actionBarIntro": "Vždy viditeľné dole v okne bez ohľadu na aktívnu kartu:",
"consoleItem": "<strong>Konzola</strong>, iba pre bežiace LXC, otvorí <code>pct enter &lt;vmid&gt;</code> v kontajneri. Používa xterm.js a WebSocket ako <link>karta Terminál</link> s <strong>mobilným panelom nástrojov</strong>: ESC, TAB, šípky, Enter a Ctrl+C / Ctrl+X / Ctrl+R. Funguje z telefónu či tabletu. Pre VM použite konzolu Proxmox noVNC.",
"lifecycleIntro": "Štyri tlačidlá v mriežke 2×2 posielajú <code>POST /api/vms/&lt;vmid&gt;/control</code> s príslušnou <code>action</code>. Dostupnosť závisí od stavu systému.",
"headerButton": "Tlačidlo",
"headerEnabled": "Povolené, keď",
"headerAction": "Akcia zaslaná hostiteľovi",
"lifecycleRows": [
{
"button": "Spustiť",
"color": "green",
"enabled": "Hosť je zastavený.",
"action": "qm start / pct start"
},
{
"button": "Vypnúť",
"color": "blue",
"enabled": "Hosťovský systém beží.",
"action": "qm shutdown / pct shutdown — riadne vypnutie, ACPI"
},
{
"button": "Reštartovať",
"color": "blue",
"enabled": "Hosťovský systém beží.",
"action": "qm reboot / pct reboot — riadny reštart"
},
{
"button": "Vynútiť vypnutie",
"color": "red",
"enabled": "Hosťovský systém beží.",
"action": "qm stop / pct stop — vynútené vypnutie"
}
],
"forceStopTitle": "Vynútené vypnutie okamžite ukončí beh",
"forceStopBody": "<strong>Vynútiť vypnutie</strong> obíde vypínanie ako odpojenie napájania. Použite <strong>Vypnúť</strong>, ak systém reaguje. Vynútenie použite len pri zablokovanom vypínaní a ak prijímate riziko straty dát. Červená farba a označenie bránia náhodnému kliknutiu."
},
"dataCollected": {
"heading": "Spôsob zberu údajov",
"headerSection": "Sekcia karty",
"headerEndpoint": "Koncový bod",
"headerSource": "Zdroj",
"rows": [
{
"section": "Zoznam inventára",
"endpoint": "/api/vms",
"source": "<code>pvesh get /cluster/resources --type vm</code> pre VM a CT."
},
{
"section": "Detailný panel (config, sieť, disky)",
"endpoint": "/api/vms/<vmid>",
"source": "<code>qm config &lt;id&gt;</code> pre VM / <code>pct config &lt;id&gt;</code> pre CT."
},
{
"section": "Graf metrík hosťovského systému",
"endpoint": "/api/vms/<vmid>/metrics",
"source": "Dáta RRD PVE (<code>pvesh get /nodes/&lt;node&gt;/qemu/&lt;id&gt;/rrddata</code>) upravené do formátu pre graf."
},
{
"section": "Nedávne výsledky záznamu Proxmox",
"endpoint": "/api/vms/<vmid>/logs",
"source": "<code>pvesh get /nodes/&lt;node&gt;/&lt;qemu|lxc&gt;/&lt;vmid&gt;/log --start 0 --limit 1000</code>. Pri zlyhaní príkazu vráti prázdny zoznam; nejde o úplné systémové záznamy vnútri hosťovského systému."
},
{
"section": "Zálohy k dispozícii pre hostí",
"endpoint": "/api/vms/<vmid>/backups",
"source": "<code>pvesm list &lt;storage&gt;</code> filtrované VMID."
},
{
"section": "Záznam firewallu hosťovského systému (karta Firewall)",
"endpoint": "/api/vms/<vmid>/firewall/log",
"source": "<code>/var/log/pve-firewall.log</code> filtrované VMID."
},
{
"section": "Ovládanie napájania (Spustiť / Vynútiť vypnutie / Reštartovať / Vypnúť)",
"endpoint": "/api/vms/<vmid>/control",
"source": "ekvivalenty <code>qm start|stop|reboot|shutdown</code> alebo <code>pct</code>."
}
],
"codeComment1": "# Porovnať údaje panela s PVE",
"codeComment2": "# Skontrolovať konfiguráciu systému presne ako v okne podrobností",
"codeComment3": "# VM",
"codeComment4": "# CT"
},
"whereNext": {
"heading": "Kam ďalej",
"items": [
{
"label": "Monitor zdravia",
"href": "/docs/monitor/health-monitor",
"tailRich": " — Kategória VMs & Containers (neúspešné spustenie, timeouty QMP, zlyhania vypnutia CT)."
},
{
"label": "Oznámenia",
"href": "/docs/monitor/notifications",
"tailRich": " — čo následne spúšťajú udalosti <code>vm_*</code>, <code>ct_*</code>, <code>migration_*</code> a <code>backup_*</code>."
},
{
"label": "Referenčná príručka API",
"href": "/docs/monitor/api",
"tailRich": " — koncové body VM a záloh."
},
{
"label": "Index panela",
"href": "/docs/monitor/dashboard",
"tailRich": " — Ostatné karty."
},
{
"label": "ProxMenux → Vytvoriť VM",
"href": "/docs/create-vm",
"tailRich": " — vytváranie systémov: šablóny NAS (Synology a ďalšie), VM Linux/Windows a predvoľby prispôsobené Proxmoxu."
}
]
}
}