Uptime Kuma è uno strumento di monitoraggio autonomo che consente di tracciare lo stato e il tempo di uptime di siti Web, server e servizi. La gestione di Uptime Kuma su un Raspberry Pi offre una soluzione leggera ed economica per il monitoraggio dell'infrastruttura. Questa guida ti guiderà attraverso l'installazione e la configurazione di Uptime Kuma su un Raspberry Pi.
Cosa avrai bisogno
- Raspberry Pi (Qualsiasi modello con supporto GPIO, ad esempio PI 3, PI 4)
- Scheda microSD (almeno 8 GB, classe 10 o migliore)
- Alimentazione elettrica (5V, 2,5a minimo per PI 3; 5V, 3A per PI 4)
- Raspberry Pi OS (Versione lite o desktop)
- Connessione Internet
Passaggio 1: preparare il Raspberry Pi
-
Aggiorna il tuo Raspberry Pi:
sudo apt update && sudo apt upgrade -y
-
Installa gli strumenti necessari:
sudo apt install -y curl git
-
Installa Docker (se non già installato):
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER
Riavvia il tuo Raspberry Pi per applicare le modifiche:
sudo reboot
Passaggio 2: installa Kuma Uptime utilizzando Docker
Uptime Kuma può essere distribuito rapidamente usando Docker. Segui questi passaggi per configurarlo:
-
Estratto l'immagine di Kuma Docker Uptime:
sudo docker pull louislam/uptime-kuma:latest
-
Crea una directory per dati persistenti:
mkdir -p ~/uptime-kuma/data
-
Esegui il contenitore Kuma Uptime:
sudo docker run -d \ -p 3001:3001 \ -v ~/uptime-kuma/data:/app/data \ --name uptime-kuma \ louislam/uptime-kuma
-
Accedi a Uptime Kuma nel tuo browser: Navigare a
http://<raspberry-pi-ip>:3001
Per accedere all'interfaccia Web Kuma di uptime.
Passaggio 3: configurare uptime kuma
-
Imposta un account amministratore:
- Al primo login, crea un nome utente e una password di amministrazione.
-
Aggiungi servizi per monitorare:
- Fare clic su Aggiungi nuovo monitor pulsante.
- Configurare i dettagli del servizio, come ad esempio:
- Tipo di monitoraggio (HTTP (S), Ping, TCP, ecc.)
- URL di servizio o indirizzo IP
- Intervallo per i controlli (ad esempio, ogni 5 minuti)
-
Salva le impostazioni del monitor E inizia a monitorare i tuoi servizi.
Passaggio 4: miglioramenti opzionali
-
Abilita https: Utilizzare un proxy inverso come Nginx o Traefik per proteggere Kuma uptime con HTTPS.
-
Esegui Kuma di uptime su una porta personalizzata: Modificare la mappatura delle porte quando si esegue il contenitore Docker:
sudo docker run -d -p 8080:3001 ...
-
Avvio automatico su avvio: Assicurarsi che il contenitore inizi automaticamente al riavvio:
sudo docker update --restart unless-stopped uptime-kuma
-
Aggiungi notifiche:
- Integra Kuma Uptime con servizi di notifica come Telegram, Slack o Email.
- Configurare le notifiche in Impostazioni> Notifica sezione della dashboard.
Passaggio 5: monitorare la tua infrastruttura
-
Visualizza le metriche:
- Accedi alle statistiche di uptime, ai tempi di risposta e ai registri di errore dalla dashboard.
-
Imposta avvisi:
- Configurare avvisi per ricevere notifiche se un servizio scende.
-
Visualizza le tendenze:
- Usa i registri di cronologia dettagliati per identificare i modelli e ottimizzare i tuoi servizi.
Risoluzione dei problemi
-
Uptime Kuma non accessibile:
- Verificare che il contenitore sia in esecuzione:
sudo docker ps
- Controlla gli errori nei registri del contenitore:
sudo docker logs uptime-kuma
- Verificare che il contenitore sia in esecuzione:
-
Un alto utilizzo delle risorse:
- Ridurre la frequenza di monitoraggio per servizi meno critici.
- Prendi in considerazione l'aggiornamento a un Raspberry Pi 4 per prestazioni migliori.
-
Impossibile ricevere notifiche:
- Credenziali e configurazioni del servizio di notifica a doppio controllo.
Applicazioni di uptime kuma
- Monitorare il tempo di attività di siti Web e server personali.
- Traccia i dispositivi IoT o i sistemi di automazione domestica.
- Garantire che i servizi cloud e le API siano operativi.
- Ricevi avvisi per interruzioni di rete o problemi di prestazioni.
Conclusione
Uptime Kuma è uno strumento di monitoraggio potente ma leggero che funziona perfettamente su un Raspberry Pi. Con la sua interfaccia intuitiva e robusto set di funzionalità, è possibile monitorare facilmente la tua infrastruttura e assicurarsi che tutto funzioni senza intoppi. Segui questa guida per impostare Kuma uptime e ottenere la piena visibilità nella tua rete e servizi!