Uptime Kuma: monitorizarea disponibilității pe propriul server
Un monitor găzduit de tine, care îți verifică site-urile și serviciile în fiecare minut și îți spune imediat când unul dintre ele nu mai răspunde.
Despre Uptime Kuma
Uptime Kuma este un instrument open-source de monitorizare, pornit de dezvoltatorul Louis Lam și ajuns unul dintre proiectele găzduite de utilizatori cu cele mai multe stele pe GitHub. Verifică dacă lucrurile răspund: site-uri prin HTTP(S), cuvinte cheie pe o pagină, porturi TCP, ping, înregistrări DNS, baze de date și altele.
Când o verificare eșuează, trimite o notificare pe unul dintre zecile de canale acceptate, printre care Telegram, Discord, Slack, e-mail și webhookuri. Urmărește și timpii de răspuns, te avertizează înainte să expire certificatele TLS și îți permite să construiești pagini publice de status pentru clienți.
Oamenii îl găzduiesc singuri pentru că e ușor, gratuit și are o interfață curată, care se configurează în câteva minute. Detaliul esențial este să-l rulezi pe un server separat: un monitor care stă pe aceeași mașină cu site-ul nu te poate anunța când mașina cade.
La ce o folosesc oamenii
Alerte când un site cade
Verifică site-ul și API-ul în fiecare minut și primește un mesaj pe Telegram sau pe e-mail imediat ce nu mai răspund.
Avertismente la expirarea certificatelor
Primește un memento cu zile înainte să expire un certificat HTTPS, în loc să afli de la clienți.
O pagină publică de status
Arată-le clienților starea actuală a serviciilor tale, pe o pagină pe care o controlezi.
După comandă
La prima pornire a serverului se instalează Uptime Kuma și se deschide portul 3001 în firewall, așa că monitorul este accesibil la http://adresa-serverului:3001/. La prima vizită creezi contul de administrator, așa că deschide adresa imediat ce serverul este gata. Apoi adaugă primul monitor și conectează un canal de notificare.
Unde să-l rulezi
Uptime Kuma verifică de acolo de unde rulează. Un monitor aflat pe același server cu serviciile pe care le urmărește cade odată cu ele și nu te poate avertiza, așa că ține-l pe alt server decât ce monitorizează.
Propriul domeniu și HTTPS pentru Uptime Kuma
Din start, Uptime Kuma răspunde pe adresa IP a serverului, prin HTTP simplu. Ca să-i dai un nume ca status.example.com, cu certificat, creează în DNS o înregistrare A pentru acel nume care să indice adresa IPv4 a serverului, apoi pune Caddy în fața lui: Caddy obține singur un certificat Let's Encrypt gratuit și îl reînnoiește. Comenzile de mai jos sunt pentru Ubuntu 24.04, sistemul pe care rulează serverele noastre de aplicații.
În panou, deschide porturile TCP 80 și 443 în firewallul serverului: Caddy are nevoie de ele ca să obțină certificatul Let's Encrypt și să servească site-ul.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyCu un domeniu în față, paginile de status ale Uptime Kuma pot fi partajate cu clienții: creează o pagină de status, alege ce monitoare arată și dă adresa https://status.example.com/status/pagina-ta. Poți atașa domeniul și direct unei pagini de status, din setările ei.
Când domeniul funcționează, nimeni nu mai are nevoie de portul 3001 direct: în /opt/uptime-kuma/compose.yml schimbă "3001:…" în "127.0.0.1:3001:…", rulează docker compose up -d și scoate portul 3001 din firewall. Apoi Uptime Kuma este accesibil doar prin HTTPS.
Actualizarea Uptime Kuma
Imaginile din /opt/uptime-kuma/compose.yml sunt fixate pe versiuni exacte, așa că un simplu docker compose pull aduce din nou aceeași versiune. Ca să actualizezi, schimbă versiunea din linia image: cu cea dorită (citește mai întâi notele de lansare), apoi descarcă imaginile și recreează containerele. Datele stau în volume Docker și se păstrează.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dBackupul pentru Uptime Kuma
În panou poți activa backupuri zilnice ale întregului server (+20% din prețul planului, se păstrează ultimele 7 copii) și poți restaura serverul din oricare dintre ele. Merită totuși să ai și o copie a datelor aplicației într-un fișier: o poți muta pe alt server sau o poți restaura fără să dai înapoi tot restul.
Monitoarele, setările de notificare și istoricul verificărilor se află în volumul uptime-kuma_uptime_kuma (/app/data). Oprește aplicația pentru un moment, ca fișierul bazei de date să fie copiat într-o stare consistentă:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startCum funcționează
- Alege Uptime Kuma pe pagina de comandă a serverului și un plan cu suficientă memorie.
- Aplicația se instalează pe server la prima pornire, de obicei în câteva minute.
- Deschide serverul în panou: acolo găsești adresa și datele de autentificare.