Příručka

Rychlý start

Tento průvodce vám pomůže zprovoznit kompletní monitorovací systém během několika minut.

Krok 1: Spuštění Serveru

Centrální server Blood Kings se nejjednodušeji spouští pomocí Docker Compose. Vytvořte si prázdnou složku a vložte do ní následující konfiguraci:

# docker-compose.yml
version: '3.8'
services:
  bloodkings:
    image: bkpepe/bloodkings:latest
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/html/data
    restart: always

Spusťte server příkazem:

docker compose up -d

Po dokončení stahování otevřete prohlížeč na adrese http://localhost:8080 a postupujte podle pokynů na obrazovce k vytvoření administrátorského účtu.

Krok 2: Přidání nového monitoru

Po přihlášení do administrace přejděte na záložku Monitors a klikněte na Add Monitor. Můžete přidat standardní HTTPS kontroly, ping na IP adresy nebo kontroly SSL certifikátů.

Systémové požadavky

Blood Kings Monitoring je navržen tak, aby běžel na jakémkoliv hardwaru.

Centrální Server:

  • Procesor: 1 vCPU (x86_64 nebo ARM64)
  • Operační paměť: 128 MB RAM (doporučeno 256 MB)
  • Místo na disku: 50 MB pro aplikaci + místo pro historii databází (cca 100 MB na rok běžného provozu)
  • Software: Docker & Docker Compose nebo PHP 8.2+ s webovým serverem (Apache/Nginx) a MySQL databází

Vzdálený Agent:

  • OS: Linux (libovolná distribuce s Bash a Curl), Windows 10/11/Server, macOS, Raspberry Pi OS
  • Paměť: méně než 10 MB RAM
  • Síť: Odchozí HTTPS (port 443) přístup k centrálnímu serveru

Architektura systému

Blood Kings Monitoring využívá hybridní architekturu spojující aktivní piny a pasivní agenty.

Vzdálený Agent(Linux/Windows/Docker)↓ HTTPS POST (Metrics)
Centrální Server(PHP / SQLite nebo MySQL)↓ Render
Veřejná Status Stránka(HTML / cached JSON)

Pasivní monitoring (Agenti): Agenti běží na vašich cílových strojích. V pravidelných intervalech (např. 60 sekund) shromažďují lokální data (CPU, RAM, disky) a zasílají je pomocí HTTPS POST požadavků na centrální server. Tento přístup nevyžaduje otevírání žádných příchozích portů na monitorovaných serverech.

Aktivní monitoring (Pinger): Centrální server spouští cron skripty, které provádějí HTTP/HTTPS, TCP a ICMP ping požadavky na vámi zadané vzdálené cíle.