Dodawanie monitora w Uptime Kuma – konfiguracja HTTP, TCP, Heartbeat
Szczegółowy przewodnik konfiguracji monitora w Uptime Kuma: typ monitora, interwał sprawdzania, próby ponowienia, timeout i zaawansowane opcje dla stron HTTPS i API.
Spis treści
- Formularz dodawania monitora – przegląd pól
- Konfiguracja monitora HTTP/HTTPS – krok po kroku
- Parametry interwału, retry i timeout
- Zaawansowane opcje – Keyword, certyfikat SSL, kody statusu
- Tagi i grupowanie monitorów
- Często zadawane pytania
Formularz dodawania monitora – przegląd pól
Dodawanie monitora w Uptime Kuma odbywa się przez panel boczny — kliknij + Add New Monitor. Formularz konfiguracji monitora zawiera sekcje: General, Heartbeat, Advanced i Notifications. Poniżej opisano najważniejsze pola.
Pola obowiązkowe (sekcja General):
- Monitor Type — typ monitora: HTTP(s), TCP, Ping, DNS, Docker, Keyword, JSON Query, Heartbeat i inne (szczegóły w artykule o typach monitorów)
- Friendly Name — własna nazwa monitora widoczna w dashboardzie, np. „Sklep produkcja" lub „API płatności"
- URL — pełny adres URL z protokołem, np. https://mojafirma.pl lub https://api.mojafirma.pl/health
Pola sekcji Heartbeat:
- Heartbeat Interval — co ile sekund Uptime Kuma sprawdza serwis (domyślnie: 60)
- Retries — ile razy ponowić sprawdzanie przed oznaczeniem jako DOWN (domyślnie: 1)
- Heartbeat Retry Interval — odstęp między próbami ponowienia (domyślnie: 60 sekund)
- Request Timeout — maksymalny czas oczekiwania na odpowiedź (domyślnie: 48 sekund)
Konfiguracja monitora HTTP/HTTPS – krok po kroku
Monitor HTTP/HTTPS jest najczęściej używanym typem w Uptime Kuma — służy do monitorowania stron WWW, sklepów e-commerce, API REST i innych usług webowych.
W lewym pasku bocznym dashboardu kliknij przycisk + Add New Monitor. Otworzy się panel konfiguracji z prawej strony ekranu.
W polu Monitor Type wybierz HTTP(s). Ten typ wysyła żądanie GET (lub inne) do podanego URL-a i sprawdza kod odpowiedzi HTTP.
W polu Friendly Name wpisz czytelną nazwę (np. „Strona główna" lub „Sklep online"). W polu URL wpisz pełny adres z protokołem HTTPS, np. https://twojsklep.pl.
W sekcji Heartbeat zmień Heartbeat Interval na żądaną wartość w sekundach. Dla sklepów e-commerce zalecane 60 sekund (1 minuta). Dla krytycznych API płatności — 30 sekund.
Przewiń do sekcji Notifications i zaznacz wcześniej skonfigurowany kanał powiadomień (np. e-mail lub Telegram). Jeśli jeszcze nie masz kanału, możesz go dodać w Ustawieniach → Notifications i wrócić tu później.
Kliknij przycisk Save. Monitor pojawi się w pasku bocznym i wykona pierwsze sprawdzenie w ciągu minuty (lub szybciej, jeśli ustawiono krótszy interwał). Status zmieni się na zielony (UP) lub czerwony (DOWN).
Parametry interwału, retry i timeout
Prawidłowe ustawienie interwału, retry i timeout jest kluczowe dla eliminacji fałszywych alarmów i zapewnienia szybkiego wykrycia realnych awarii.
Heartbeat Interval (interwał): Jak często Uptime Kuma sprawdza serwis. Zbyt krótki (5–10 s) przy wielu monitorach może generować duży ruch; zbyt długi (300 s) opóźni wykrycie awarii. Zalecane wartości:
- Sklep e-commerce, API płatności: 30–60 sekund
- Strona firmowa, landing page: 60–120 sekund
- Mniej krytyczne usługi: 120–300 sekund
Retries (próby ponowienia): Ile razy Uptime Kuma ponowi próbę przed uznaniem serwisu za DOWN. Wartość 0 = alarm po pierwszej nieudanej próbie. Wartość 2 = alarm po 3 nieudanych próbach.
Request Timeout (timeout): Jak długo Uptime Kuma czeka na odpowiedź serwera. Domyślnie 48 sekund — wystarczające dla większości serwisów. Dla szybkich API ustaw 10–15 sekund, aby wykrywać problemy z wydajnością.
Zaawansowane opcje – Keyword, certyfikat SSL, kody statusu
Sekcja Advanced w formularzu monitora HTTP/HTTPS zawiera dodatkowe opcje, które zwiększają precyzję monitorowania.
- Keyword — wpisz słowo lub frazę, która musi znajdować się w treści odpowiedzi HTTP. Uptime Kuma oznaczy monitor jako DOWN jeśli fraza nie zostanie znaleziona, nawet przy kodzie 200 OK. Przydatne do wykrywania stron z błędem wyświetlającym się bez zmiany kodu HTTP
- Ignore TLS/SSL error — włącz, jeśli monitorujesz serwis z samopodpisanym certyfikatem SSL lub certyfikatem wewnętrznym. Domyślnie wyłączone — zalecane zostawić wyłączone dla publicznych serwisów
- Max redirects — ile przekierowań HTTP (301, 302) Uptime Kuma może śledzić. Domyślnie 10. Ustaw 0, jeśli chcesz alarmować przy każdym przekierowaniu
- Accepted Status Codes — jakie kody HTTP są traktowane jako sukces. Domyślnie 200–299. Możesz dodać 301 lub 302 jeśli oczekujesz przekierowań
- Certificate Expiry Notification — dni przed wygaśnięciem certyfikatu SSL, kiedy Uptime Kuma wyśle ostrzeżenie (np. 30 i 14 dni)
Tagi i grupowanie monitorów
Gdy masz wiele monitorów, tagi (Tags) pomagają je organizować i szybko filtrować w dashboardzie. Możesz przypisać jeden lub wiele tagów do każdego monitora.
Przejdź do Ustawienia → Tags (lub kliknij ikonę tagu w górnym menu). Kliknij Add Tag, wpisz nazwę (np. „Klienci", „Produkcja", „API") i wybierz kolor. Zapisz.
W formularzu dodawania lub edytowania monitora znajdź pole Tags. Zacznij wpisywać nazwę tagu i wybierz go z listy. Możesz przypisać wiele tagów do jednego monitora.
W pasku bocznym kliknij nazwę tagu, aby wyświetlić tylko monitory z tym tagiem. Kliknij All, aby wrócić do pełnej listy.
Często zadawane pytania
Jaki interwał sprawdzania ustawić w Uptime Kuma?
Domyślny interwał to 60 sekund i jest odpowiedni dla większości zastosowań. Dla usług krytycznych (sklep e-commerce, API płatności) możesz ustawić 30 sekund. Dla mniej istotnych zasobów wystarczy 120–300 sekund. Pamiętaj, że im krótszy interwał, tym więcej żądań wysyła Uptime Kuma — przy dziesiątkach monitorów z interwałem 10 sekund serwer może być obciążony ruchem sprawdzającym.
Ile prób ponowienia (retry) ustawić w Uptime Kuma?
Domyślna wartość to 1 próba, co oznacza, że jedna nieudana odpowiedź wystarczy do zmiany statusu na DOWN. Dla usług z chwilowymi przerwami (np. serwery z automatycznym restartem) ustaw retry na 2–3 — Uptime Kuma wyśle alert dopiero po 2–3 kolejnych nieudanych próbach, eliminując fałszywe alarmy.
Czy Uptime Kuma sprawdza treść odpowiedzi, nie tylko kod HTTP?
Tak, Uptime Kuma może sprawdzać treść odpowiedzi przez funkcję Keyword. W konfiguracji monitora HTTP wpisz słowo lub frazę w polu Keyword — Uptime Kuma uzna monitor za DOWN jeśli odpowiedź nie zawiera tej frazy, nawet jeśli zwróci kod 200. Przydatne do wykrywania stron błędów zwracających kod 200 zamiast 500.
Zobacz też
Potrzebujesz gotowej instancji Uptime Kuma?
Uruchom monitorowanie stron i usług za 5 PLN/mies. w smartxhosting.pl — nieograniczona liczba monitorów, SSL i własna subdomena uptimekuma.eu.
Uruchom Uptime Kuma
