Monitoring pomocí uptime-kuma

uptime-kuma je software napsaný pro uptime monitoring služeb, tedy jestli běží. Nejedná se o monitoring jako Zabbix, Prometheus apod. které řeší metriky z operačního systému, logy atd.

S použitím dockeru lze počítat že takový běžný Debian bude potřebovat kolem 1GB RAM, ideálně 2GB. non-docker metodu ještě prozkoumáme, v základu si ukážeme jak použít tu docker verzi.

Instalace

• Nainstalovat docker.io:

   apt -yq update 
   apt -yq install docker.io
  

• Vytvořit disk (volume) pro data monitoringu:

  docker volume create kuma_data
  

  💡 Na disku kuma_data se bude nacházet veškeré nastavení a posbírané metriky (kuma.db).

• Spustit kontejner uptime-kuma s naším diskem kuma_data na portu 80 (nebo libovolném):

  docker run -d --restart=always -p 80:3001 -v kuma_data:/app/data/ --name kuma louislam/uptime-kuma:2
  

• Otevřít si webovou adresu serveru na který jsme kumu nainstalovali, třeba kuma.cvut.it

• Zvolit si nějaké fajné administrátorské jméno a heslo a hlavně jej nezapomenout.

Aktualizace

• Stáhnout nejnovější image z DockerHubu

  docker pull louislam/uptime-kuma:2
  

• Zastavit a odstranit servisní kontejner (ten kde běží software, ne ten kde jsou data.. data jsou na kuma_data)

  docker container rm --volumes kuma --force
  

• Spustit novou verzi uptime-kuma s diskem kuma_data opět na portu 80 (nebo libovolném):

  docker run -d --restart=always -p 80:3001 -v kuma_data:/app/data/ --name kuma louislam/uptime-kuma:2
  

Údržba

Zálohování

• Zastavit kontejner:

  docker stop kuma
  

• Vytvořit archiv z disku kuma_data:

  tar czvpf kuma_data.tar.gz /var/lib/docker/volumes/kuma_data
  

• Spustit kontejner

  docker start kuma
  

💡 Není špatný nápad archiv ukládat někde mimo server..

Obnova

• Dle úrovně rozbití existují dvě možnosti

  • Málo rozbité (smazal jsem monitor a nevím jak ho nastavit znova) - pokračujeme dál.
  • Hodně rozbité (síťování, docker, idk..) - odstranit veškeré volumes i kontejnery a to i kuma_data.

• Nainstalovat celé znova.

• Nakopírovat si zálohu kuma_data.tar.gz na server.

• Zastavit kontejner:

  docker stop kuma
  

• Rozbalit obsah archivu na disk kuma_data:

  tar -C /var/lib/docker/volumes/kuma_data/ --strip-components=5 -xpvf kuma_data.tar.gz
  

• Spustit kontejner

  docker start kuma