Vlastný monitoring: Uptime Kuma

Ovládací panel tvojho stroja zobrazuje grafy CPU, prevádzky a pamäte, ale nemá ani potuchy, či tvoja stránka odpovedá alebo či databáza žije. Na to potrebuješ vlastného strážcu. Uptime Kuma je najjednoduchšia možnosť: jeden kontajner, webové rozhranie, desiatky spôsobov notifikácií.

Inštalácia

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

Port je zámerne naviazaný na lokálne rozhranie: monitorovací panel by nemal byť vystavený navonok. Otvor ho buď cez webový server s certifikátom a heslom, alebo cez SSH tunel:

ssh -L 3001:127.0.0.1:3001 root@<machine-address>

Potom v prehliadači prejdi na http://localhost:3001; prvý používateľ sa stane administrátorom.

Čo monitorovať

Začni v malom, inak sa utopíš v šume:

• HTTP kontrola domovskej stránky každého webu — návratový kód a čas.
• HTTP kontrola kľúčového API s kontrolou kľúčového slova v odpovedi. Stránka môže vrátiť 200 a napriek tomu zobrazovať chybu.
• TCP port databázy alebo herného servera.
• Expirácia certifikátu — Kuma ťa upozorní N dní pred jeho vypršaním.
• Push kontrola pre naplánované úlohy: po úspešnom spustení skript zavolá jedinečnú adresu, a ak tak neurobí, dostaneš upozornenie. Dobre sa kombinuje s naplánovanými úlohami.

Interval 60 sekúnd stačí takmer vždy. Opakovania — 2-3, inak jediný stratený sieťový paket vyvolá falošný poplach.

Neklaď monitorovanie stránky na ten istý stroj, kde tá stránka žije. Ak stroj padne, padne s ním aj strážca a ty sa to nikdy nedozvieš. Pre externé stránky maj Kumu na samostatnom stroji a na tomto — len kontroly interných služieb.

Notifikácie

Nastav si Telegram bota alebo Discord webhook a pridaj ho v sekcii notifikácií. Nepoužívaj e-mailový kanál: odchádzajúce spojenia stroja na porty 25, 465 a 587 sú zatvorené, kým ich neotvoríš na požiadanie, a e-maily z Kumy jednoducho neodoídu — pozri Mail server.

Užitočné návyky:

• Oddelené kanály pre „výpadok" a „certifikát čoskoro vyprší". Prvý potrebuje reakciu hneď, druhý — do týždňa.
• Zapnuté notifikácie o obnovení. Bez nich nevieš povedať, či výpadok skončil.
• Testovacia správa odoslaná počas nastavovania. Polovica všetkých problémov je nesprávny token a to zistíš až počas skutočného výpadku.

Zdroje a údržba

Kontajner sa zmestí do 150-250 MB pamäte a pohodlne beží na VDS-1. Databáza rastie s históriou kontrol: nastav v nastaveniach uchovávanie na 90-180 dní, inak za rok súbor narastie na gigabajty — pozri miesto na disku.

Adresár ./data obsahuje celý stav služby. Zahrň ho do svojej zálohy: obnovovať tri desiatky kontrol ručne nie je žiadna zábava.

Časté chyby

• Kontrola podľa IP adresy namiesto domény. Certifikát a virtuálny host sa nekontrolujú a výpadok DNS zostane nepovšimnutý.
• Príliš citlivé prahy. Upozornenie na každé 2-sekundové prekročenie znamená, že ľudia prestanú notifikácie čítať.
• Panel vystavený navonok bez hesla. Ukazuje celú tvoju infraštruktúru: adresy, porty, názvy služieb.