Uptime Kuma: monitoring dostupnosti na vlastním serveru
Vlastní monitoring, který každou minutu kontroluje vaše weby a služby a dá vám vědět ve chvíli, kdy některá z nich přestane odpovídat.
O aplikaci Uptime Kuma
Uptime Kuma je open-source nástroj pro monitoring, který založil vývojář Louis Lam a který dnes patří k self-hosted projektům s nejvíce hvězdičkami na GitHubu. Kontroluje, zda věci odpovídají: weby přes HTTP(S), klíčová slova na stránce, TCP porty, ping, DNS záznamy, databáze a další.
Když kontrola selže, pošle upozornění jedním z desítek podporovaných kanálů, mimo jiné přes Telegram, Discord, Slack, e-mail a webhooky. Sleduje také doby odezvy, upozorní před vypršením TLS certifikátů a umožní vytvořit veřejné stavové stránky pro vaše zákazníky.
Lidé si ho hostují sami, protože je nenáročný, zdarma a má přehledné rozhraní, které nastavíte za pár minut. Klíčové je provozovat ho na samostatném serveru: monitoring na stejném stroji jako váš web vám nemůže oznámit, že tento stroj spadl.
K čemu ji lidé používají
Upozornění při výpadku webu
Kontrolujte web a API každou minutu a dostaňte zprávu do Telegramu nebo e-mailem, jakmile přestanou odpovídat.
Varování před vypršením certifikátu
Nechte si připomenout několik dní předem, že HTTPS certifikát vyprší, místo abyste se to dozvěděli od zákazníků.
Veřejná stavová stránka
Ukažte zákazníkům aktuální stav svých služeb na stránce pod vaší kontrolou.
Po objednání
Při prvním spuštění serveru se nainstaluje Uptime Kuma a ve firewallu se otevře port 3001, takže monitoring je dostupný na adrese http://adresa-serveru:3001/. Při první návštěvě vytvoříte účet správce, proto adresu otevřete hned, jak bude server připravený. Potom přidejte první monitor a připojte kanál pro upozornění.
Kde ho provozovat
Uptime Kuma kontroluje z místa, kde běží. Monitoring na stejném serveru jako služby, které hlídá, spadne spolu s nimi a nemůže vás varovat, proto ho mějte na jiném serveru, než je to, co monitoruje.
Vlastní doména a HTTPS pro Uptime Kuma
Po instalaci Uptime Kuma odpovídá na IP adrese serveru přes obyčejné HTTP. Pokud mu chcete dát název jako status.example.com s certifikátem, vytvořte v DNS pro tento název záznam A, který ukazuje na IPv4 adresu serveru, a předřaďte mu Caddy: Caddy si sám získá bezplatný certifikát Let's Encrypt a sám ho prodlužuje. Příkazy níže jsou pro Ubuntu 24.04, na kterém běží naše aplikační servery.
V panelu otevřete ve firewallu serveru TCP porty 80 a 443: Caddy je potřebuje k získání certifikátu Let's Encrypt a k obsluze 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 před sebou můžete stavové stránky Uptime Kuma sdílet se zákazníky: vytvořte stavovou stránku, vyberte, které monitory zobrazí, a rozdávejte adresu https://status.example.com/status/vase-stranka. Doménu můžete také připojit přímo ke stavové stránce v jejím nastavení.
Jakmile doména funguje, holý port 3001 už nikdo nepotřebuje: v /opt/uptime-kuma/compose.yml změňte "3001:…" na "127.0.0.1:3001:…", spusťte docker compose up -d a port 3001 z firewallu odeberte. Uptime Kuma pak bude dostupné jen přes HTTPS.
Aktualizace Uptime Kuma
Image v /opt/uptime-kuma/compose.yml jsou připnuté na konkrétní verze, takže samotné docker compose pull stáhne znovu stejnou verzi. Při aktualizaci změňte verzi na řádku image: na požadovanou (nejdřív si přečtěte poznámky k vydání), pak image stáhněte a kontejnery znovu vytvořte. Data jsou ve volumes Dockeru a zůstanou zachována.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dZálohování Uptime Kuma
V panelu můžete zapnout denní zálohy celého serveru (+20 % ceny tarifu, uchovává se posledních 7 kopií) a server z kterékoli z nich obnovit. Kopie vlastních dat aplikace v souboru se přesto vyplatí: dá se přenést na jiný server nebo obnovit, aniž byste vraceli zpět všechno ostatní.
Monitory, nastavení upozornění a historie kontrol jsou ve volume uptime-kuma_uptime_kuma (/app/data). Aplikaci na chvíli zastavte, aby se soubor databáze zkopíroval v konzistentním stavu:
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 startJak to funguje
- Na stránce objednávky serveru zvolte Uptime Kuma a vyberte tarif s dostatkem paměti.
- Aplikace se na server nainstaluje při prvním spuštění, obvykle během několika minut.
- Otevřete server ve svém panelu: najdete tam adresu i přihlašovací údaje.