Uptime Kuma: monitoring dostupnosti na vlastnom serveri
Monitoring na vlastnom serveri, ktorý každú minútu kontroluje vaše weby a služby a hneď vám dá vedieť, keď niektorá prestane odpovedať.
O aplikácii Uptime Kuma
Uptime Kuma je open-source nástroj na monitoring, ktorý založil vývojár Louis Lam a ktorý dnes patrí k self-hosted projektom s najväčším počtom hviezdičiek na GitHube. Kontroluje, či veci odpovedajú: weby cez HTTP(S), kľúčové slová na stránke, TCP porty, ping, DNS záznamy, databázy a ďalšie.
Keď kontrola zlyhá, pošle upozornenie jedným z desiatok podporovaných kanálov vrátane Telegramu, Discordu, Slacku, e-mailu a webhookov. Sleduje aj časy odozvy, upozorní pred vypršaním TLS certifikátov a umožní vytvoriť verejné stavové stránky pre zákazníkov.
Ľudia si ho prevádzkujú sami, pretože je nenáročný, bezplatný a má prehľadné rozhranie, ktoré nastavíte za pár minút. Podstatné je mať ho na samostatnom serveri: monitoring na tom istom stroji ako váš web vám neoznámi, že tento stroj spadol.
Na čo ju ľudia používajú
Upozornenia, keď web nefunguje
Kontrolujte web a API každú minútu a dostaňte správu do Telegramu alebo e-mail, hneď ako prestanú odpovedať.
Upozornenia na vypršanie certifikátu
Dostaňte pripomienku niekoľko dní pred vypršaním HTTPS certifikátu, namiesto toho, aby ste sa to dozvedeli od zákazníkov.
Verejná stavová stránka
Ukážte zákazníkom aktuálny stav svojich služieb na stránke, ktorú máte pod kontrolou.
Po objednaní
Pri prvom spustení servera sa nainštaluje Uptime Kuma a vo firewalle sa otvorí port 3001, takže monitoring je dostupný na adrese http://adresa-servera:3001/. Pri prvej návšteve vytvoríte účet administrátora, preto adresu otvorte hneď, ako je server pripravený. Potom pridajte prvý monitor a pripojte kanál pre upozornenia.
Kde ho prevádzkovať
Uptime Kuma kontroluje z miesta, kde beží. Monitoring na tom istom serveri ako služby, ktoré sleduje, spadne spolu s nimi a nemôže vás upozorniť, preto ho majte na inom serveri, než aký monitoruje.
Vlastná doména a HTTPS pre Uptime Kuma
Po inštalácii Uptime Kuma odpovedá na IP adrese servera cez obyčajné HTTP. Ak mu chcete dať názov, napríklad status.example.com, s certifikátom, vytvorte vo svojom DNS pre tento názov záznam A smerujúci na IPv4 adresu servera a potom pred Uptime Kuma postavte Caddy: Caddy si sám získa bezplatný certifikát Let's Encrypt a sám ho predlžuje. Príkazy nižšie sú pre Ubuntu 24.04, na ktorom bežia naše aplikačné servery.
V paneli otvorte vo firewalle servera TCP porty 80 a 443: Caddy ich potrebuje na získanie certifikátu Let's Encrypt a na obsluhu webu.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyS doménou môžete stavové stránky Uptime Kuma zdieľať so zákazníkmi: vytvorte stavovú stránku, vyberte, ktoré monitory zobrazí, a rozdajte adresu https://status.example.com/status/vasa-stranka. Doménu môžete priradiť aj priamo stavovej stránke v jej nastaveniach.
Keď doména funguje, priamy port 3001 už nikto nepotrebuje: v /opt/uptime-kuma/compose.yml zmeňte "3001:…" na "127.0.0.1:3001:…", spustite docker compose up -d a port 3001 odstráňte z firewallu. Uptime Kuma je potom dostupné len cez HTTPS.
Aktualizácia Uptime Kuma
Obrazy v /opt/uptime-kuma/compose.yml sú pripnuté na presné verzie, takže obyčajný docker compose pull stiahne znova tú istú verziu. Pri aktualizácii zmeňte verziu v riadku image: na požadovanú (najprv si prečítajte poznámky k vydaniu), potom obrazy stiahnite a kontajnery vytvorte znova. Dáta sú v Docker zväzkoch a zostanú zachované.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dZálohovanie Uptime Kuma
V paneli môžete zapnúť denné zálohy celého servera (+20 % z ceny balíka, uchováva sa posledných 7 kópií) a server z ktorejkoľvek z nich obnoviť. Kópia vlastných dát aplikácie v súbore sa však oplatí: dá sa presunúť na iný server alebo obnoviť bez vrátenia všetkého ostatného.
Monitory, nastavenia upozornení a história kontrol sú vo zväzku uptime-kuma_uptime_kuma (/app/data). Aplikáciu na chvíľu zastavte, aby sa súbor databázy skopíroval v konzistentnom stave:
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 startAko to funguje
- Na stránke objednávky servera vyberte Uptime Kuma a zvoľte balík s dostatkom pamäte.
- Aplikácia sa na server nainštaluje pri prvom spustení, zvyčajne do niekoľkých minút.
- Otvorte server vo svojom paneli: nájdete tam adresu aj prihlasovacie údaje.