Uptime Kuma nie wysyła powiadomień: przyczyny i rozwiązania

Gdy Uptime Kuma nie wysyła powiadomieńProblem nie zawsze leży po stronie Telegrama, serwera poczty czy webhooka. Może się również zdarzyć, że kanał nie jest powiązany z monitorem, nie nastąpiła jeszcze żadna zmiana statusu lub że ponowne próby opóźniają wysłanie alertu.

Najlepszym sposobem rozwiązania tego problemu jest sprawdzenie każdej części łańcucha osobno: najpierw kanału, następnie jego powiązania z monitorem, a na końcu łączności z serwerem lub kontenerem, na którym działa Uptime Kuma. Jeśli nadal konfigurujesz monitory, możesz zapoznać się z tym. Ogólny przewodnik Uptime Kuma.

Zacznij od zidentyfikowania miejsca, w którym powiadomienie nie dociera.

Przed zmianą haseł, portów lub certyfikatów sprawdź dokładnie, co się dzieje. Oto najczęstsze scenariusze:

Objaw	Prawdopodobna przyczyna	Pierwsza kontrola
Test ręczny nie powiódł się	Poświadczenia, adres, sieć lub TLS	Sprawdź konfigurację dostawcy
Test działa, ale prawdziwy alert nie przychodzi.	Kanał nie jest powiązany lub monitor nie zmienia statusu	Edytuj monitor i przejrzyj swoje powiadomienia
Tylko jeden monitor jest uszkodzony.	Nieprawidłowa konfiguracja indywidualna	Porównaj go z innym monitorem, który ostrzega
Alert trwa zbyt długo.	Ponowne próby lub zbyt długi odstęp czasu	Sprawdź ustawienia monitora
Uptime Kuma wskazuje na powodzenie, ale nie widzisz komunikatu	Spam, zły odbiorca lub wyciszona aplikacja	Sprawdź usługę odbioru

Taka klasyfikacja pozwala uniknąć konieczności jednoczesnej zmiany wielu opcji i ułatwia lokalizację błędu bez uszkadzania konfiguracji, która już działa częściowo.

Jak przetestować kanał powiadomień

Otwarte Ustawienia > PowiadomieniaWybierz problematyczny kanał i naciśnij przycisk TestUptime Kuma spróbuje wysłać wiadomość, używając wprowadzonej konfiguracji.

Jeśli test się nie powiedzie, wyświetlony komunikat zazwyczaj zawiera wskazówkę:

• Nieautoryzowane lub 401: Token, nazwa użytkownika lub hasło są nieprawidłowe.
• Zabronione lub 403: Dane uwierzytelniające istnieją, ale nie mają uprawnień.
• Nie znaleziono lub 404: Adres webhooka lub zasobu jest nieprawidłowy.
• Zbyt wiele żądań lub 429: Dostawca zastosował ograniczenie czasowe.
• ZNALEZIONO: Serwer nie może rozwiązać domeny za pomocą DNS.
• PRZEKROCZONY CZAS: Połączenie jest blokowane lub nie otrzymuje odpowiedzi.
• Błąd certyfikatu: Certyfikat jest nieprawidłowy, wygasł lub nie pasuje do domeny.

Udany test potwierdza, że ​​Uptime Kuma może w tym czasie skontaktować się z dostawcą. Jednakże, Nie dowodzi to, że powiadomienie jest włączone na monitorze ani że wygenerowano faktyczne zdarzenie `DOWN` lub `UP`.

Sprawdź, czy powiadomienie jest powiązane z monitorem

To jeden z najczęstszych błędów. Kanał może być idealnie skonfigurowany i przejść test, ale nic nie robić, ponieważ żaden monitor go nie używa.

1. Otwórz monitor, który nie wysyła alertów.
2. Naciskać Redagować.
3. Poszukaj sekcji Powiadomienia.
4. Aktywuj kanał, którego chcesz używać.
5. Zapisz zmiany.

Opcja Domyślnie włączone Umożliwia to domyślne wybranie powiadomienia podczas tworzenia nowych monitorów. Tymczasem Zastosuj na wszystkich istniejących monitorach Można go zastosować do istniejących monitorów.

Nawet korzystając z tych opcji, zaleca się otwarcie jednego z monitorów, których dotyczy problem, i ręczne sprawdzenie, czy kanał jest wybrany. Jest to szczególnie ważne w przypadku wielu powiadomień o podobnych nazwach.

Sprawdź, czy nastąpiła rzeczywista zmiana stanu

Uptime Kuma wysyła kluczowe alerty, gdy monitor zmienia status. Jeśli monitor pozostaje stale w stanie „UP” lub „DOWN”, dalsze alerty nie będą wysyłane, chyba że ustawisz przypomnienia lub przekierowania.

Należy również sprawdzić liczbę ponownych prób przed oznaczeniem usługi jako wyłączonejJeśli monitor sprawdza usługę co 60 sekund i podejmuje trzy próby, alert nie zostanie wygenerowany przez pierwszą awarię. Uptime Kuma zaczeka, aż zostaną spełnione niezbędne warunki, aby zmienić status na „NIECZYNNY”.

Aby zweryfikować cały przepływ bez przerywania usługi na żywo, możesz utworzyć tymczasowy monitor wskazujący na zamknięty port. Poczekaj, aż zmieni się on na „NIECZYNNY”, potwierdź otrzymanie powiadomienia, a następnie zmodyfikuj monitor tak, aby korzystał z dostępnej usługi. Powinieneś również otrzymać komunikat o odzyskiwaniu „UP”.

Jeśli chcesz monitorować zawartość, a nie tylko kod HTTP, możesz Monitoruj witrynę za pomocą Uptime Kuma stosując odpowiednią weryfikację.

Uptime Kuma nie wysyła wiadomości e-mail przez SMTP

W przypadku awarii poczty e-mail należy najpierw sprawdzić kombinację między port i szyfrowanieNieprawidłowa konfiguracja może uniemożliwić nawiązanie połączenia, nawet jeśli nazwa użytkownika i hasło są prawidłowe.

Port	Konfiguracja standardowa
465	TLS domyślnie od początku połączenia
587	Początkowe połączenie, a następnie STARTTLS
25	Zależy to od serwera, może być on blokowany przez dostawcę.

Sprawdź również następujące elementy:

• El Nazwa serwera SMTP Musi dokładnie odpowiadać temu, co oferuje usługa.
• Nazwą użytkownika jest zazwyczaj pełny adres e-mail, choć zależy to od dostawcy.
• Konta chronione za pomocą uwierzytelniania wieloskładnikowego (MFA) mogą wymagać hasło aplikacji.
• Adres nadawcy musi zostać autoryzowany przez serwer.
• Adresat musi być poprawnie napisany.
• Jeśli zdecydujesz się na użycie dodatkowych nagłówków, muszą one zawierać prawidłowy kod JSON.
• Certyfikat musi być ważny i pasować do skonfigurowanej domeny.

Nie zaleca się trwałego aktywowania opcji Ignoruj ​​błędy TLSMoże on posłużyć jako jednorazowy test mający na celu zidentyfikowanie nieprawidłowo skonfigurowanego certyfikatu wewnętrznego, ale obniża bezpieczeństwo i nie rozwiązuje przyczyny problemu.

Jeśli Uptime Kuma wskazuje, że wiadomość została wysłana, sprawdza folder ze spamem, reguły skrzynki pocztowej i logi serwera pocztowego. Niektóre usługi początkowo akceptują wiadomość, a następnie blokują ją, ponieważ nadawca narusza ich zasady.

Uptime Kuma nie wysyła wiadomości przez Telegram

Aby poprawnie skonfigurować Uptime Kuma wysyła alerty za pośrednictwem Telegramu Potrzebny jest ważny token bota i dokładny identyfikator czatu.

• Sprawdź, czy token nie zawiera spacji ani dodatkowych znaków.
• Przed wypróbowaniem botu rozpocznij rozmowę i wyślij mu wiadomość.
• Jeśli korzystasz z grupy, dodaj bota i udziel mu uprawnień do publikowania.
• Pamiętaj, że identyfikatory grup zwykle mają wartość ujemną.
• Jeżeli grupa korzysta z motywów, skonfiguruj Identyfikator wątku wiadomości odpowiedni.
• Sprawdź czy opcja cichych wiadomości jest włączona.

Możliwe jest również, że Telegram jest wyciszony w telefonie. W takim przypadku wiadomość dociera poprawnie, ale urządzenie nie wyświetla dźwięku ani powiadomienia.

Jeśli chcesz oddzielić powiadomienia krytyczne od zwykłych alertów, istnieje inna możliwość: skonfiguruj NTFS jako dodatkowy kanał i mieć trasę zapasową.

Webhooki Discord, Slack lub innych usług nie działają

Webhook powinien wskazywać na punkt końcowy odbioru dostarczany przez usługęNie zadziała, jeśli wpiszesz zwykły adres kanału, stronę ustawień lub adres URL skopiowany z przeglądarki.

Jeżeli przesyłka się nie powiedzie, sprawdź:

• Że webhook nie został usunięty, odwołany lub wygenerowany ponownie.
• Upewnij się, że adres URL jest kompletny i nie zawiera spacji.
• Serwer powinien akceptować żądania z adresu Uptime Kuma.
• Sprawdź, czy nagłówki uwierzytelniania są poprawne.
• Upewnij się, że wysyłana treść ma oczekiwany format JSON.
• Nie ma ograniczeń czasowych co do składania wniosków.

Używając webhooka w automatyzacji, najpierw przetestuj punkt końcowy za pomocą prostego obciążenia. Następnie możesz go użyć do bardziej zaawansowanych działań, takich jak: automatyczne ponowne uruchomienie kontenera Docker po potwierdzonym upadku.

Sprawdź sieć z kontenera Uptime Kuma

To, że Telegram, Gmail lub webhook działają na Twoim komputerze, nie oznacza, że ​​można uzyskać do nich dostęp z poziomu kontenera. Uptime Kuma, który musi rozwiązać domenę i nawiązać połączenie wychodzące.

Najpierw zlokalizuj nazwę kontenera:

docker ps

Jeśli to się nazywa uptime-kumaMożesz sprawdzić rozdzielczość DNS za pomocą:

docker exec uptime-kuma node -e "require('dns').lookup('api.telegram.org', console.log)"

Aby przetestować połączenie HTTPS z tego samego kontenera:

docker exec uptime-kuma node -e "fetch('https://api.telegram.org').then(r => console.log(r.status)).catch(console.error)"

Zastąp domenę serwerem SMTP, webhookiem lub API, które diagnozujesz. Najczęstsze błędy wskazują na następujące problemy:

• ZNALEZIONO: Nieprawidłowa konfiguracja DNS.
• EHOSTUNREACH: Nie ma drogi do celu.
• PRZEKROCZONY CZAS: Zapora sieciowa, serwer proxy lub usługa zdalna blokuje połączenie.
• ODMOWA EKONOMIKI: Port jest zamknięty lub usługa nie nasłuchuje.
• Certyfikat wygasł: Certyfikat serwera wygasł.

W sieciach korporacyjnych może być również konieczne skonfigurowanie Serwer proxy wyjściowy Dockera lub zainstaluj wewnętrzny urząd certyfikacji w środowisku, w którym działa Uptime Kuma.

Sprawdź serwer proxy, DNS, certyfikaty i czas

Nieprawidłowy czas systemowy może spowodować unieważnienie tymczasowych certyfikatów lub tokenów. Sprawdź, czy host synchronizuje swój zegar za pomocą protokołu NTP i czy kontener dziedziczy spójną konfigurację czasu.

Jeśli korzystasz z korporacyjnego serwera proxy, sprawdź, czy zezwala on na połączenia z domenami i portami używanymi przez powiadomienia. Niektóre serwery proxy akceptują normalny ruch sieciowy, ale blokują połączenia SMTP lub webhooki do nieautoryzowanych adresów docelowych.

W instalacjach z certyfikatami wewnętrznymi Uptime Kuma musi ufać instytucji wystawiającej certyfikaty. Bezmyślne wyłączanie weryfikacji certyfikatów jedynie maskuje problem i może ułatwiać ataki typu man-in-the-middle.

Ponowne próby, przerwy i konserwacja mogą ukrywać alerty.

Wstrzymany monitor nie wykonuje kontroli, więc nie może wygenerować zmiany stanu. Przed przystąpieniem do dalszych czynności sprawdź, czy monitor jest aktywny.

Ten okna konserwacyjne Mają one na celu zapobieganie alertom podczas planowanych przerw w dostawie prądu. Sprawdź, czy monitor nie jest objęty aktywną lub planowaną konserwacją z nieprawidłową strefą czasową.

Ponowne próby mogą również sprawiać wrażenie, że powiadomienie nie dotarło. W rzeczywistości Uptime Kuma nadal czeka na dalsze kontrole przed zgłoszeniem awarii. Dostosuj tę wartość, aby znaleźć równowagę między szybkością a ochroną przed fałszywymi alarmami.

Jak przeglądać dzienniki Kuma Uptime

Jeśli interfejs nie wyjaśnia wystarczająco błędu, sprawdź logi kontenera:

docker logs --tail 200 uptime-kuma

Aby wyświetlić nowe wiadomości podczas przeprowadzania testu:

docker logs --follow --tail 200 uptime-kuma

Jeśli używasz Docker Compose i usługa nazywa się uptime-kumaMożesz także uruchomić:

docker compose logs --tail=200 uptime-kuma

Szukaj odniesień do nazwy dostawcy, kodów HTTP, błędów uwierzytelniania, problemów z DNS, przekroczeń limitu czasu lub odrzuconych certyfikatów. Nie publikuj pełnych logów bez ich sprawdzenia: mogą zawierać adresy wewnętrzne, odbiorcy lub części danych uwierzytelniających.

Typowe błędy przy konfigurowaniu powiadomień

Test działa, ale upadek nie generuje żadnego ostrzeżenia.

Kanał prawdopodobnie nie jest włączony na tym monitorze lub nie wyczerpano jeszcze limitu prób. Edytuj monitor, sprawdź wybrane powiadomienia i poczekaj na rzeczywistą zmianę na „WYŁĄCZONY”.

Otrzymujesz powiadomienie o odzyskaniu sprawności, ale nie powiadomienie o upadku.

Sprawdź włączone zdarzenia, filtry usługi odbiorczej oraz logi odpowiadające dokładnemu czasowi awarii. Pierwsza wiadomość mogła również zostać odfiltrowana jako spam lub tymczasowo zablokowana.

Tylko jeden monitor jest uszkodzony.

Porównaj jego konfigurację z konfiguracją innego, działającego urządzenia. Sprawdź powiązany kanał, liczbę ponownych prób, okna konserwacyjne i czy monitor jest wstrzymany.

Powiadomienia przestały działać po aktualizacji

Uruchom test ponownie, sprawdź logi i upewnij się, że dane uwierzytelniające, zmienne i certyfikaty są nadal dostępne w kontenerze. Przed zmianą konfiguracji sprawdź również informacje o wydaniu.

Wiadomości e-mail zostają wysłane, ale nie zawierają oczekiwanego tematu.

Najlepiej skorzystać z natywnego dostawcy SMTP i sprawdzić szablon tematu wiadomości. Jeśli dodałeś niestandardowe nagłówki, upewnij się, że tworzą one poprawny obiekt JSON i nie nadpisują ważnych pól.

Zalecana kolejność rozwiązywania problemu

1. Naciśnij Test w ustawieniach kanału.
2. Popraw dane uwierzytelniające, punkt końcowy lub szyfrowanie. jeśli test się nie powiedzie.
3. Sprawdź, czy kanał jest aktywowany na uszkodzonym monitorze.
4. Sprawdź ponowne próby, przerwy i zaplanowaną konserwację.
5. Wyzwala kontrolowany spadek w celu sprawdzenia zdarzeń `DOWN` i `UP`.
6. Sprawdź DNS i łączność z kontenerem.
7. Sprawdź logi podczas nowego testu.
8. Skonfiguruj drugi kanał, aby otrzymywać redundantne alerty.

Gdy Uptime Kuma nie wysyła powiadomieńRozwiązanie polega na ustaleniu, czy usterka leży po stronie dostawcy, powiązania z monitorem, generowania zdarzeń, czy sieci kontenerów. Pomyślny test ręczny to dopiero pierwszy krok: należy również potwierdzić, że monitor zmienia stan oraz że usługa odbierająca akceptuje i wyświetla komunikat.

Po przywróceniu alertów zaleca się utrzymanie co najmniej dwóch oddzielnych kanałów, takich jak Telegram i e-mail. Dzięki temu jednorazowy problem z dostawcą nie sprawi, że będziesz całkowicie nieprzygotowany na przerwę w działaniu usługi.