Kompletny przegląd typów monitorów dostępnych w Uptime Kuma: kiedy używać każdego z nich i jak je skonfigurować do monitorowania różnych usług.
Typy monitorów w Uptime Kuma pokrywają szeroki zakres usług — od stron WWW przez bazy danych po kontenery Docker. Wybór odpowiedniego typu monitora jest kluczowy dla skutecznego monitorowania i eliminacji fałszywych alarmów.
Podstawowy typ — wysyła żądanie HTTP GET (lub inne: POST, PUT, HEAD) do podanego URL-a i sprawdza kod odpowiedzi. Serwis jest UP jeśli kod mieści się w zakresie akceptowanych kodów (domyślnie 200–299). Używaj dla stron WWW, sklepów e-commerce, paneli CMS i endpointów API.
Rozszerzony HTTP(s) z dodatkowym sprawdzaniem treści odpowiedzi. Uptime Kuma szuka zdefiniowanej frazy w body odpowiedzi — DOWN jeśli fraza nie zostanie znaleziona. Przykładowe zastosowanie: wpisz frazę „Dodaj do koszyka" — jeśli strona sklepu nie zawiera tej frazy, prawdopodobnie wyświetla stronę błędu. Dostępny też wariant Keyword (Inverse) — DOWN jeśli fraza JEST obecna w odpowiedzi (np. wykrywanie komunikatów o błędach).
Zaawansowany monitor dla API REST — pobiera odpowiedź JSON i sprawdza wartość konkretnego pola. Przykład: sprawdź, czy $.status ma wartość "ok" w odpowiedzi z endpointu health check. Idealny dla mikroserwisów z dedykowanymi endpointami healthcheck.
Sprawdza, czy konkretny port TCP jest otwarty i dostępny. Używaj do monitorowania serwerów SMTP (port 25/465/587), IMAP (993), POP3 (995), FTP (21), SSH (22), baz danych (MySQL: 3306, PostgreSQL: 5432) i innych usług nasłuchujących na określonym porcie. Konfiguracja: wpisz hostname/IP i numer portu.
Analogiczny do TCP, ale dla protokołu UDP. Używany rzadziej — głównie dla serwerów DNS (port 53/UDP), serwerów gier i VPN (np. WireGuard, OpenVPN UDP).
Wysyła pakiety ICMP ping do podanego hosta i mierzy czas odpowiedzi (latencję). Sprawdza dostępność serwera na poziomie sieciowym. Uwaga: wiele serwerów produkcyjnych blokuje ping ze względów bezpieczeństwa — brak odpowiedzi na ping nie zawsze oznacza niedostępność serwisu.
Sprawdza, czy serwer DNS poprawnie rozwiązuje podaną nazwę domenową. Możesz weryfikować rekordy A, AAAA, MX, CNAME, TXT i inne. Przydatny do monitorowania własnych serwerów DNS i wykrywania problemów z propagacją DNS po zmianach konfiguracji.
Monitor Heartbeat działa w odwrotny sposób niż pozostałe typy — to nie Uptime Kuma odpytuje serwis, lecz serwis sam cyklicznie wysyła żądanie HTTP GET do unikalnego URL-a Uptime Kuma. Jeśli sygnał nie przyjdzie w ustalonym czasie, Uptime Kuma uznaje serwis za DOWN.
Heartbeat jest idealny do monitorowania:
Kliknij + Add New Monitor, wybierz typ Push. Ustaw Friendly Name (np. „Backup nocny DB") i Heartbeat Interval (np. 86400 sekund = 24 godziny). Kliknij Save.
Po zapisaniu monitora wyświetli się unikalny URL push w formacie https://twoja-instancja.uptimekuma.eu/api/push/[unikalny_kod]. Skopiuj go.
Na końcu swojego skryptu bash lub zadania cron dodaj: curl -fsS "https://twoja-instancja.uptimekuma.eu/api/push/[unikalny_kod]" > /dev/null. Skrypt wywoła ten URL po każdym pomyślnym uruchomieniu.
Monitor Docker sprawdza stan działania kontenera Docker na wskazanym hoście. Uptime Kuma łączy się z Docker API (przez socket /var/run/docker.sock lub zdalny API) i sprawdza, czy kontener o podanej nazwie lub ID jest w stanie running.
Konfiguracja: wybierz typ Docker Container, wskaż host Docker (najczęściej local dla tej samej maszyny lub zdalny endpoint), wpisz nazwę kontenera. Uptime Kuma ostrzeże gdy kontener zatrzyma się lub wejdzie w stan exited/crashed.
Uptime Kuma obsługuje natywne monitory dla popularnych baz danych — łączy się bezpośrednio z bazą, wykonuje proste zapytanie i weryfikuje odpowiedź:
Konfiguracja: wybierz typ bazy, podaj host, port, użytkownika, hasło i nazwę bazy. Zalecane jest użycie osobnego użytkownika read-only z minimalnymi uprawnieniami — wyłącznie dla celów healthcheck.