mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 19:02:31 +00:00
docs: review Monitor documentation in all seven translations
This commit is contained in:
@@ -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/<slot>/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 <version>, <Gb/s> (current: ...)</em>; NVMe ako <em><PCIe gen> x<width></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/<interface>/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/<interface>/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/<node>/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/<cluster|host>.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-<short-id>.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/<node>/storage</code> s aktívnym/online stavom každého."
|
||||
},
|
||||
{
|
||||
"section": "Aktuálne hodnoty SMART",
|
||||
"endpoint": "/api/storage/smart/<disk>",
|
||||
"source": "<code>smartctl -A <dev></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/<disk>/</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=<N></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/<upid></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 <range></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/<upid>",
|
||||
"source": "Plný textový záznam úloh čítaný z <code>/var/log/pve/tasks/<index>/<upid></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@<host></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 <vmid></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 <vmid></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/<command></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><VMID>-scheduled-<run-id>.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/<vmid>/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/<vmid>/config</code> a zapíše do <code>/etc/pve/qemu-server/<vmid>.conf</code> alebo <code>/etc/pve/lxc/<vmid>.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 <vmid> df</code>; <code>/proc/<pid>/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><Container|VM> → 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/<vmid>/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 <vmid></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/<vmid>/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 <id></code> pre VM / <code>pct config <id></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/<node>/qemu/<id>/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/<node>/<qemu|lxc>/<vmid>/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 <storage></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."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user