Come aggiornare Uptime Kuma 2.3: guida completa alle novità

Uptime Kuma è uno strumento di monitoraggio self-hosted che consente di tenere traccia dello stato e della disponibilità di servizi, siti web e applicazioni. La versione 2.3 introduce diverse novità e miglioramenti che ampliano le sue capacità di monitoraggio e notifica.

Questa guida è utile per amministratori di sistema, sviluppatori e utenti tecnici che desiderano monitorare i propri servizi in modo efficiente e ricevere notifiche tempestive su eventuali problemi. Con le nuove funzionalità introdotte nella versione 2.3, Uptime Kuma diventa ancora più potente e flessibile.

• Monitoraggio esteso: La nuova OracleDB monitor estende le capacità di monitoraggio delle basi di dati.
• Miglioramenti delle notifiche: Supporto per Telnyx messaging, VK notifications, MAX Messenger notifications e template personalizzati per Evolution.
• Organizzazione migliorata: Gruppi collassibili nella pagina di stato per una migliore organizzazione.
• Risoluzione dei bug: Correzione di vari problemi, tra cui il calcolo dell'uptime, i controlli di scadenza del dominio e la gestione delle metriche Prometheus.

Prerequisiti

• Hardware: Un dispositivo compatibile con Uptime Kuma, come un Raspberry Pi o un server dedicato.
• Software: Docker installato sul dispositivo.
• Versione: Uptime Kuma 2.3.

Procedura di aggiornamento a Uptime Kuma 2.3

Seguendo questa guida, aggiornerai Uptime Kuma alla versione 2.3, beneficiando delle nuove funzionalità e correzioni.

• Accedi al server che ospita Uptime Kuma.
• Esegui un backup completo del database e della configurazione attuale.
• Aggiorna Uptime Kuma utilizzando il metodo di installazione originale (es. Docker, npm, ecc.).
• Se utilizzi un Raspberry Pi, modifica il file di configurazione per aggiungere l'opzione UPTIMEKUMASQLITESINGLECONNECTION e impostala su true.
• Riavvia il servizio Uptime Kuma per applicare le modifiche.
• Verifica che tutte le funzionalità critiche siano operative.

Per ulteriori dettagli, consulta il changelog ufficiale.

Verifica e Troubleshooting

Dopo aver aggiornato Uptime Kuma alla versione 2.3, è importante verificare il corretto funzionamento del sistema e risolvere eventuali problemi. Segui questi passaggi per testare il sistema e affrontare le problematiche comuni.

Test di Funzionamento

• Verifica i monitor: Accedi all'interfaccia di Uptime Kuma e controlla che tutti i monitor siano attivi e funzionanti. Assicurati che i nuovi monitor OracleDB siano configurati correttamente.
• Controlla le notifiche: Verifica che le notifiche siano configurate e funzionanti. Prova a inviare un test di notifica per ciascun provider, inclusi Telnyx, VK, MAX Messenger e Home Assistant.
• Esamina la pagina dello stato: Controlla che le pagine dello stato siano organizzate correttamente e che i gruppi collassabili funzionino come previsto.
• Controlla le metriche Prometheus: Verifica che le metriche Prometheus siano corrette e che non ci siano serie duplicate per i monitor con tag.

Risoluzione dei Problemi

• Problemi di SQLite su Raspberry Pi: Se utilizzi un Raspberry Pi, imposta l'opzione UPTIMEKUMASQLITESINGLECONNECTION su true per evitare problemi di blocco del database.
• Ordine delle pagine dello stato: Se hai utilizzato la funzionalità di ordinamento delle pagine dello stato, tieni presente che è stata rimossa a causa di problemi di performance.
• Problemi di notifica: Se riscontri problemi con le notifiche, verifica la configurazione dei provider e assicurati che i template di messaggio personalizzati siano corretti.
• Problemi di uptime: Se noti discrepanze nei calcoli di uptime, assicurati che i bucket di tempo mancanti siano gestiti correttamente.
• Problemi di scadenza del dominio: Se i controlli di scadenza del dominio non si aggiornano correttamente, verifica la configurazione del monitor.
• Problemi di metriche Prometheus: Se le metriche Prometheus producono serie duplicate, verifica che i tag siano configurati correttamente.
• Problemi di creazione del monitor: Se riscontri errori durante la creazione di un monitor, assicurati che tutti i parametri richiesti siano impostati correttamente.

Alla fine di questa guida, avrai una panoramica completa delle novità introdotte in Uptime Kuma 2.3 e saprai come sfruttare al meglio le sue funzionalità aggiornate.

Sintesi didattica

• WebSocket handling: Migliorato con supporto per l'autenticazione.
• Status page: Gruppi collassabili per una migliore organizzazione, ma rimosso il sorting per motivi di performance.
• Bug fixes: Correzioni per uptime calculations, domain expiry checks, SSL handling, Prometheus metrics e altro.

Invito alla pratica

Se non hai ancora provato Uptime Kuma, segui la guida dettagliata per l'installazione rapida con Docker qui.