"description":"Monitoraggio proattivo di Proxmox VE: dieci categorie ogni cinque minuti (CPU e temperatura, memoria e swap, archiviazione, dischi/SMART, rete, VM, servizi, log, aggiornamenti e sicurezza), quattro livelli di gravità, silenziamento per categoria, pulizia degli errori risolti, cronologia permanente dei dischi e notifiche Telegram, Discord, Gotify o e-mail.",
"ogDescription":"Monitoraggio proattivo di Proxmox VE in dieci categorie, con livelli di gravità, durata del silenziamento e notifiche per evento.",
"twitterTitle":"Monitoraggio dello stato di Proxmox | ProxMenux",
"twitterDescription":"Monitoraggio proattivo di Proxmox VE in dieci categorie, con livelli di gravità e notifiche."
},
"header":{
"title":"Monitoraggio integrità",
"description":"Il controllo continuo esamina dieci categorie dello stato dell’host ogni cinque minuti, raccoglie misure tra i cicli, deduplica i rilevamenti in eventi strutturati e alimenta dashboard, notifiche e riscrittura IA facoltativa da un’unica fonte.",
"section":"Monitor di ProxMenux"
},
"intro":{
"title":"Uno scanner, tre consumatori",
"body":"Un thread in background esegue il ciclo completo ogni cinque minuti e salva ogni rilevamento in SQLite con un <code>error_key</code> stabile. Così <strong>(1)</strong> la dashboard mostra lo stato attuale, <strong>(2)</strong> il sistema di notifiche distribuisce i nuovi eventi e <strong>(3)</strong> l’assistente IA facoltativo riscrive gli avvisi in linguaggio semplice. Un’unica configurazione alimenta tutti questi componenti."
},
"howItWorks":{
"heading":"Come funziona",
"intro":"Il monitor usa due thread paralleli. Un <strong>campionatore di metriche</strong> leggero riempie i buffer di CPU, memoria e temperatura. Il <strong>ciclo completo di controllo</strong> legge i buffer, valuta le condizioni prolungate ed esegue gli altri controlli circa ogni cinque minuti, poi salva i rilevamenti in SQLite per dashboard e notifiche.",
"scannerTitle":"Dal campione al ritrovamento memorizzato",
"scannerCaption":"Il campionatore riempie i buffer tra i cicli: CPU ogni 5 s, memoria ogni 30 s e temperatura ogni 15 s. Non valuta gli avvisi. Il ciclo completo analizza i buffer ed esegue i controlli più pesanti su SMART, ZFS, log e servizi prima di salvare i rilevamenti in SQLite.",
"scannerArrowLabel":"passo",
"scannerNodes":{
"samplerLabel":"Campionatore di metriche",
"samplerDetail":"Uso CPU 5 s\nMemoria 30 s\nTemperatura 15 s\n→ buffer storici",
"cycleLabel":"ciclo completo di salute",
"cycleDetail":"Ogni 5 min\nLegge i buffer\n+ controlli diretti\n(SMART, ZFS,\nservizi, log…)",
"notifCaption":"Percorso delle notifiche. La stessa tabella degli errori alimenta anche la dashboard (elenchi degli avvisi attivi e silenziati) e la pulizia a fine ciclo che risolve automaticamente le voci obsolete. Entrambe leggono i dati direttamente, senza passare dal dispatcher.",
"imageAlt":"Vista del monitor di stato con le dieci categorie e i relativi stati: CPU, memoria, archiviazione, dischi, rete, VM, servizi, log, aggiornamenti e sicurezza",
"imageCaption":"Salute Monitor vista — le dieci categorie con il loro stato attuale. Le categorie su un host sano mostrano tutto OK; gli avvisi e gli eventi critici appaiono in linea con le righe che li hanno prodotti.",
"intro":"Ogni ciclo esegue dieci controlli indipendenti. Ciascuno restituisce uno dei quattro stati (<strong>OK</strong>, <strong>INFO</strong>, <strong>WARNING</strong>, <strong>CRITICAL</strong>) e dati strutturati, come nomi dei dispositivi, estratti dei log e soglie precise, mostrati nella dashboard e nelle notifiche.",
"headerCategory":"Categoria",
"headerChecks":"Sottocontrolli",
"headerEvents":"Eventi tipici",
"rows":[
{
"category":"CPU e temperatura",
"checks":"CPU utilizzo con isteresi, temperatura del sensore",
"events":"Uso elevato e prolungato della CPU; avvisi di temperatura basati sulle letture campionate."
},
{
"category":"Memoria e swap",
"checks":"RAM utilizzo, utilizzo swap",
"events":"Pressione prolungata sulla memoria; attività dell’OOM-killer; esaurimento dello swap."
"events":"Soglie di spazio superate sulla radice o su altri filesystem monitorati (85% avviso / 95% critico per impostazione predefinita); storage PVE non disponibili; montaggi NFS/CIFS bloccati o inaspettatamente in sola lettura; storage LVM-thin e altri pool che superano le stesse soglie."
"events":"Aggiornamenti di sicurezza o del kernel in uso in attesa; sistema non aggiornato da molto tempo. La categoria Aggiornamenti della finestra Stato di salute mostra il pulsante <em>Aggiorna ora</em> quando ci sono aggiornamenti in attesa. Avvia l’intera procedura di aggiornamento ProxMenux nella finestra stessa; alla chiusura aggiorna lo stato con <code>?refresh=1</code>, così l’indicatore riflette il nuovo stato senza attendere il ciclo successivo."
"checks":"Tentativi di accesso, certificati in scadenza, stato delle jail Fail2Ban se installato",
"events":"Ripetuti errori di autenticazione SSH o web; certificato PVE in scadenza tra meno di 30 giorni; blocchi Fail2Ban attivi."
}
]
},
"severity":{
"heading":"Modello di gravità",
"headerStatus":"Stato",
"headerColour":"Colore",
"headerMeaning":"Significato",
"headerNotification":"Notifica",
"rows":[
{
"status":"OK",
"colour":"Verde",
"meaning":"Stato regolare. Nessun rilevamento in questa categoria.",
"notification":"Silenzioso."
},
{
"status":"INFO",
"colour":"Blu",
"meaning":"Condizione transitoria o già risolta degna di nota una volta. Utilizzato anche per le categorie che hanno <em>solo</em> elementi abbandonati rimasti.",
"notification":"Facoltativa. Ogni tipo di evento può essere attivato o disattivato per ciascun canale."
},
{
"status":"WARNING",
"colour":"Giallo",
"meaning":"L'attenzione è necessaria ma l'host è ancora funzionale. Causa non banale — leggere i dettagli.",
"notification":"Inviata quando il tipo di evento è attivo per il canale."
},
{
"status":"CRITICAL",
"colour":"Rosso",
"meaning":"Funzionalità rotta o perdita di dati possibile. Azione richiesta.",
"notification":"Inviata se il tipo di evento è attivo per il canale. Un avviso di temperatura CPU CRITICAL si riattiva per sicurezza anche se era stato silenziato."
}
],
"infoNote":"Una categoria <strong>OK</strong> con eventi ancora nel periodo di silenziamento appare come <strong>INFO</strong>, per ricordare che alcuni avvisi sono stati silenziati.",
"unknownTitle":"UNKNOWN quando un controllo non può essere completato",
"unknownBody":"Un controllo non disponibile restituisce <code>UNKNOWN</code>; dopo tre cicli consecutivi viene salvato un rilevamento persistente. La dashboard lo mostra in giallo. Lo stato complessivo limita <code>UNKNOWN</code> a <strong>WARNING</strong>: il solo controllo non disponibile non rende critico l’host."
},
"dashboardView":{
"heading":"La vista del cruscotto",
"intro":"Il monitor si trova nella scheda <strong>Panoramica</strong>. L’indicatore nell’intestazione (Regolare / Avviso / Critico) apre una finestra con due elenchi:",
"items":[
"<strong>Attivi</strong> — categorie con rilevamenti irrisolti. Espandendo una riga si vedono i controlli coinvolti, il testo originale <code>reason</code>, l’ID del dispositivo o della VM e, se disponibile, un collegamento ad Archiviazione, Rete, VM, Log o Hardware.",
"<strong>Silenziati</strong> — elementi riconosciuti dall’utente e ancora nel periodo di silenziamento. Ogni riga mostra tempo restante e durata scelta. Alla scadenza esce dall’elenco; se la causa persiste e la categoria lo supporta, torna tra gli <em>Attivi</em>."
],
"pillTitle":"L’indicatore riflette la categoria più grave",
"pillBody":"Il colore dell’intestazione riflette la gravità massima: CRITICAL → rosso, altrimenti WARNING → giallo, altrimenti INFO → blu, altrimenti verde. La stessa logica controlla il punto della favicon e il badge PWA.",
"updateNowTitle":"Pulsante Aggiorna ora nell’intestazione della panoramica",
"updateNowBody1":"Se <em>Aggiornamenti di sistema</em> segnala aggiornamenti in attesa, appare <strong>Aggiorna ora</strong> accanto all’indicatore. La finestra esegue la procedura di <em>ProxMenux → Settings post-install Proxmox → Proxmox System Update</em>: pulizia dei repository, <code>apt full-upgrade</code> tramite <code>update-pve-safe.sh</code>, ricompilazione DKMS dei driver gestiti con un nuovo kernel, autoremove/autoclean e richiesta di riavvio se cambia il kernel. La finestra mostra l’avanzamento in tempo reale.",
"updateNowBody2":"Al termine, chiudere la finestra richiama <code>GET /api/health/details?refresh=1</code> e invalida la cache dell’endpoint. Aggiornamenti in attesa e gravità vengono ricalcolati dal nuovo stato dei pacchetti: il badge scompare senza attendere il ciclo successivo. Se l’host è già aggiornato, il pulsante resta nascosto."
},
"dismiss":{
"heading":"Silenziare gli avvisi e scegliere la durata",
"intro":"Alcuni eventi persistono per natura, come <em>Aggiornamenti di sistema: aggiornamenti disponibili</em> finché non aggiorni l’host, e una notifica ogni cinque minuti per una settimana non serve. Il pulsante <em>Aggiorna ora</em> nella categoria Aggiornamenti della finestra Stato di salute risolve direttamente questo caso. Per gli altri casi o gli aggiornamenti rimandati il monitor offre anche due meccanismi collegati per silenziare gli avvisi:",
"step1":"<strong>Silenziare un singolo evento</strong> nella finestra. Il menu offre <strong>24 ore</strong>, <strong>7 giorni</strong> o <strong>Permanentemente</strong>, indipendentemente dalla categoria. La scelta invia <code>POST /api/health/acknowledge</code> con <code>error_key</code> e <code>suppression_hours</code> (<code>-1</code> per permanente). L’evento passa tra i silenziati con data <code>acknowledged_at</code>.",
"dropdownImageAlt":"Menu per silenziare un avviso: 24 ore, 7 giorni o permanentemente",
"dropdownImageCaption":"La durata scelta vale solo per questo avviso; senza scelta individuale si usa il valore della categoria. Gli avvisi silenziati permanentemente hanno un’etichetta ambra <em>Permanente</em> e normalmente non si riattivano. La temperatura critica della CPU è l’eccezione descritta sotto.",
"step2":"<strong>Durata del silenziamento per categoria</strong>. In Impostazioni → Monitoraggio, o tramite <code>POST /api/health/settings</code>, ciascuna delle dieci categorie ha una durata predefinita usata senza scelta individuale:",
"imageAlt":"Durata del silenziamento per categoria in Impostazioni → Monitoraggio",
"imageCaption":"Un menu per categoria. Scegli una durata lunga per eventi ripetitivi, come aggiornamenti in attesa, e breve per quelli da rivalutare presto. Sotto sono elencati i silenziamenti attivi.",
"outro":"Durante il silenziamento il controllo continua e aggiorna <code>last_seen</code>, senza nuove notifiche. Alla scadenza il ciclo successivo rivaluta la causa: l’avviso può riattivarsi oppure sparire se il problema è risolto.",
"activeSuppressionsTitle":"Rivedere e annullare i silenziamenti attivi",
"activeSuppressionsBody":"Gli avvisi silenziati, temporanei o permanenti, sono in <strong>Impostazioni → Monitoraggio → Silenziamenti attivi</strong>. Ogni riga mostra identificatore, categoria, gravità, data e tempo restante. <strong>Riattiva</strong> rimuove il riconoscimento per il prossimo controllo. Da qui si annullano i silenziamenti permanenti e si interrompono quelli temporanei. Attiva <em>Modifica</em>, scegli le righe da riattivare (bordo verde e testo barrato), poi salva. Annulla svuota la selezione.",
"autoTitle":"Silenziamento automatico al cambiare la durata",
"autoBody":"Scegliere una durata diversa dalle 24 ore predefinite ha un secondo effetto: <strong>i nuovi rilevamenti della categoria vengono salvati già riconosciuti</strong>. Una settimana scelta per i dischi vale quindi anche per i nuovi avvisi, senza silenziarli singolarmente. Appaiono direttamente tra i silenziati con la durata scelta. Le categorie lasciate a 24 ore mantengono il comportamento normale: i nuovi rilevamenti restano attivi finché intervieni.",
"tempTitle":"Eccezione per temperatura CPU CRITICAL",
"tempBody":"La persistenza prevede una regola speciale per <strong>Temperatura CPU CRITICAL</strong>: un tale record ignora il riconoscimento precedente e il silenziamento automatico. Ciò non significa che ogni controllo di temperatura generi un record critico al superamento di una soglia configurata.",
"nonDismissableTitle":"Quali rilevamenti si possono silenziare?",
"nonDismissableBody":"La finestra mostra Silenzia solo se il controllo restituisce esplicitamente dismissable = true. Un valore falso o assente nasconde il pulsante. La gravità non determina questo permesso: diversi controlli critici consentono il riconoscimento. Gli esempi descrivono i dati attuali; silenziare un avviso non ne risolve la causa.",
"headerFinding":"Rilevamento",
"headerWhy":"Comportamento del silenziamento",
"rows":[
{
"finding":"Temperatura CPU: avviso / critica",
"why":"L’avviso basato sui campioni di temperatura consente esplicitamente il silenziamento. Una regola separata ignora il riconoscimento se arriva un record di temperatura CPU con gravità CRITICAL."
},
{
"finding":"Spazio critico del filesystem radice",
"why":"I controlli dello spazio consentono il silenziamento anche con utilizzo critico. Riconoscere l’avviso non libera spazio né elimina il rischio di scritture fallite."
"why":"I rilevamenti sullo stato dei pool ZFS (DEGRADED, FAULTED, UNAVAIL) consentono esplicitamente il silenziamento, così come i controlli di capacità dei pool. Il riconoscimento non ripara un pool degradato o guasto."
"finding":"Errori del disco I/O con SMART FAILED",
"why":"I rilevamenti del disco salvati dal journal possono consentire il silenziamento. SMART FAILED richiede comunque un’indagine; il pulsante dipende dall’indicatore del controllo, non dal solo testo dell’avviso."
},
{
"finding":"Interfaccia di rete DOWN",
"why":"I controlli persistenti di interfaccia DOWN consentono il silenziamento. Questo non ripristina bridge, bond, collegamento fisico o accesso remoto."
},
{
"finding":"Eventi I/O su dischi sani (INFO)",
"why":"Gli eventi ATA o dmesg transitori con SMART sano possono essere informativi e risolversi da soli. Le righe informative possono non offrire Silenzia; il controllo stabilisce quando la condizione è risolta."
}
],
"principle":"Usa il pulsante mostrato per il rilevamento effettivo, senza dedurne la disponibilità dalla categoria o gravità. Il riconoscimento controlla presentazione e notifiche. I controlli di ripristino e la cronologia del disco restano separati."
},
"autoresolve":{
"heading":"Autorisoluzione e pulizia",
"intro":"Molti avvisi devono sparire quando cessa la causa: una VM torna ad avviarsi, un disco viene rimosso o la temperatura torna normale. La pulizia alla fine di ogni ciclo di cinque minuti applica queste regole:",
"headerTrigger":"Trigger",
"headerAction":"Azione",
"rows":[
{
"trigger":"Uso CPU o temperatura tornati alla normalità.",
"action":"Segnato risolto. Esce dalla lista attiva."
},
{
"trigger":"Pressione di memoria indietro sotto la soglia di avvertimento dopo un OOM / avviso di memoria.",
"action":"Segnato risolto."
},
{
"trigger":"VM / CT richiamato dall'errore non esiste più (<code>qm status</code> / <code>pct status</code> non zero).",
"action":"Segnato risolto come risorsa rimosso."
},
{
"trigger":"Il disco richiamato dall'errore non è più presente in <code>/dev/</code>.",
"action":"Segnato risolto come dispositivo rimosso. La storia dell'osservazione permanente è conservata (vedi sezione successiva)."
},
{
"trigger":"Rilevamenti dal journal di sistema (categoria <code>logs</code>, voci SMART, errori ATA o I/O) alla scadenza del silenziamento.",
"action":"Vengono rimossi. Ogni scansione esamina le nuove voci del journal da quel momento; la stessa vecchia riga non viene emessa di nuovo."
},
{
"trigger":"Errori risolti da oltre sette giorni.",
"action":"Eliminati dal database per contenere la tabella. La cronologia delle notifiche è indipendente e viene conservata più a lungo."
}
],
"permanentTitle":"Silenziare permanentemente non significa risolvere",
"permanentBody":"Una durata di categoria pari a <code>-1</code> (<em>permanente</em>) silenzia i futuri avvisi degli elementi riconosciuti, senza saltare il controllo di risoluzione automatica. Se la causa scompare, per esempio dopo la rimozione della risorsa o il rientro sotto soglia, l’elemento viene comunque ripulito automaticamente."
},
"observations":{
"heading":"Osservazioni dei dischi — la cronologia permanente",
"intro":"Gli eventi dei dischi meritano di essere conservati. Un avviso SMART su <code>/dev/sdh</code> alle 02:14 resta utile dopo la fine della raffica di I/O e la risoluzione automatica: il disco ha ormai dei precedenti. Per questo il monitor mantiene una tabella <strong>permanente</strong> separata: <code>disk_observations</code>.",
"obs":"<code>(disk_registry_id, error_type, error_signature)</code> con firme stabili spogliate di dati volatili."
},
{
"property":"Dove appare",
"errors":"Finestra del monitor (elenchi Attivi / Silenziati).",
"obs":"Scheda del disco nella sezione <strong>Archiviazione</strong>, con un indicatore «X obs.» per disco."
},
{
"property":"Cosa registra",
"errors":"Qualunque cosa stia attualmente fallendo.",
"obs":"Avvisi SMART (settori, temperatura, CRC, test automatici falliti), errori I/O (ATA / NVMe / dm), errori del filesystem ed eventi dei pool ZFS."
}
],
"outro":"Un avviso può sparire dalla dashboard mentre l’incidente resta nella cronologia del disco. Aprendo il disco in Archiviazione, la scheda mostra il numero di osservazioni pendenti con date, gravità e messaggi originali non elaborati. Aiuta a decidere se sostituire l’unità.",
"renameTitle":"Le variazioni del nome del dispositivo vengono unite automaticamente",
"renameBody":"I dischi possono apparire inizialmente con nomi provvisori come <code>ata8</code> o <code>nvme0n1p3</code>. Le osservazioni vengono raggruppate per numero di serie noto: se un evento è registrato come <code>ata8</code> e il disco poi identificato come <code>sdh</code>, al ciclo seguente le vecchie osservazioni vengono associate a <code>sdh</code>, mantenendo unita la cronologia."
},
"notification":{
"heading":"Dal rilevamento alla notifica",
"intro":"Ogni errore attivo può anche generare una notifica. Il percorso:",
"items":[
"Lo scanner registra il risultato con la categoria + gravità + dettagli strutturati.",
"Se il tipo di evento è <strong>attivo</strong> nelle notifiche globali e il canale non ha silenziato la categoria, l’evento viene messo in coda.",
"Il motore dei modelli produce titolo e corpo dai dati strutturati. Se la riscrittura IA è attiva, la coppia passa anche al fornitore configurato per una versione in linguaggio semplice.",
"Il canale invia un messaggio Telegram, un embed Discord, una notifica push Gotify o un’e-mail. L’esito è salvato in <code>notification_history</code>.",
"Silenziare un avviso avvia il periodo di sospensione. Durante quel periodo nuove rilevazioni dello stesso <code>error_key</code> normalmente non generano notifiche né vengono accodate per la scadenza. Resta l’eccezione per la temperatura critica della CPU."
],
"outro":"La configurazione dei canali — token del bot Telegram, URL webhook, chiavi IA, opzioni per evento e per canale — è descritta in <notifLink>Notifiche</notifLink> e <aiLink>Assistente IA</aiLink>."
"intro":"Le azioni della finestra sono disponibili anche via API per script, dashboard personalizzate o bot. Le chiamate richiedono un token Bearer valido, ottenuto con l’accesso o nella schermata dei token API. Le modifiche, come riconoscere avvisi, salvare le impostazioni di soppressione o pulire errori orfani, richiedono l’ambito full_admin; read_only riceve 403.",
"use":"Controllo leggero che restituisce JSON con <code>status</code>, <code>timestamp</code> e <code>version</code>. Adatto ai controlli per parola chiave Uptime Kuma; il client deve inviare un’intestazione Bearer."
"use":"Stato complessivo: un livello di gravità e una sintesi. Richiede autenticazione."
},
{
"endpoint":"/api/health/details",
"method":"GET",
"use":"Tutte le dieci categorie con i rispettivi stati e i dati strutturati che li hanno prodotti."
},
{
"endpoint":"/api/health/full",
"method":"GET",
"use":"Vista completa: categorie, errori attivi, silenziati e impostazioni personalizzate. Alimenta la finestra con una sola richiesta e usa una cache in background di sei minuti per risposte rapide."
},
{
"endpoint":"/api/health/active-errors",
"method":"GET",
"use":"Solo la lista attiva. Filtrabile da <code>?category=<name></code>."
},
{
"endpoint":"/api/health/dismissed",
"method":"GET",
"use":"Solo l’elenco dei silenziati, con le ore restanti."
},
{
"endpoint":"/api/health/acknowledge",
"method":"POST",
"use":"Corpo: <code>'{'\"error_key\":\"smart_sdh\"'}'</code>. Silenzia un avviso per la durata configurata della categoria."
},
{
"endpoint":"/api/health/settings",
"method":"GET / POST",
"use":"Leggere o salvare la durata del silenziamento per categoria."
},
{
"endpoint":"/api/health/cleanup-orphans",
"method":"POST",
"use":"Pulizia manuale degli errori di dispositivi o VM rimossi. Idempotente."
}
],
"codeComment1":"# Ottenere lo stato attuale per uno script",
"codeComment2":"# Silenziare un errore specifico",
"codeComment3":"# Imposta a una settimana la sospensione della categoria dischi"
},
"whereNext":{
"heading":"Come proseguire",
"items":[
{
"label":"Dashboard",
"href":"/docs/monitor/dashboard",
"tail":" — da qui si apre la finestra del monitor nell’interfaccia."
},
{
"label":"Notifiche",
"href":"/docs/monitor/notifications",
"tail":" — canali, opzioni per evento, riscrittura IA e cronologia."
},
{
"label":"Assistente AI",
"href":"/docs/monitor/ai-assistant",
"tail":" — fornitore (OpenAI / Anthropic / Gemini / Groq / Ollama / OpenRouter), modalità del prompt, dettaglio per canale e lingua."
},
{
"label":"Architettura",
"href":"/docs/monitor/architecture",
"tailRich":" — schema SQLite (<code>errors</code>, <code>disk_observations</code>, <code>events</code>) e frequenza dei thread in background."
