Monitoring i Alerty PrestaShop (DataFirefly Monitor)
Instalacja DataFirefly Monitor 2.0.0 w PrestaShop od 1.7.8 do 9, harmonogram crona, kanały alertów, monitorowane strony i reguły oraz opis każdej detekcji.
DataFirefly Monitor stale pilnuje Twojego sklepu PrestaShop i ostrzega, gdy przestaje działać, zgłasza błędy, zwalnia albo nie przyjmuje płatności. Wskazuje moduł, który najprawdopodobniej jest przyczyną, wysyła jeden alert na problem i informuje, gdy wszystko wróci do normy. Ta dokumentacja dotyczy wersji 2.0.0.

Instalacja i aktualizacja
Wymagania
- PrestaShop od 1.7.8 do 9.x, multistore i wielojęzyczność
- PHP od 7.1 do 8.5, z cURL (zalecane)
- Zadanie cron co 5 minut (zalecane, zob. niżej)
Instalacja
- W panelu otwórz Moduły > Menedżer modułów, kliknij Załaduj moduł i wyślij plik
dfmonitor-2.0.0.zip. - Moduł tworzy swoje tabele i zakładkę Zaawansowane > Monitoring i alerty. Przycisk Konfiguruj modułu prowadzi bezpośrednio do niej.
- Podczas instalacji adres e-mail sklepu jest ustawiany jako odbiorca, a status Błąd płatności jako status nieudanej płatności. Logi PrestaShop zapisane przed instalacją nie są importowane.
Aktualizacja z wersji 1.x
Wgraj nowy plik zip na stary: skrypt aktualizacji dodaje nowe kolumny i ustawienia, nie naruszając Twoich danych. Historia błędów, alerty, powiadomienia, ustawienia i token crona zostają zachowane, więc używany adres URL crona nadal działa.
Pulpit
Nagłówek streszcza stan sklepu w jednym zdaniu: Wszystko działa, ostrzeżenie albo problem krytyczny. Poniżej są otwarte alerty z przyciskami Potwierdź i Zamknij, a dalej sześć wskaźników: dostępność z 24 godzin, czas odpowiedzi z ostatniej godziny (p95), błędy PHP z 24 godzin, nieudane płatności, dzisiejsze zamówienia w porównaniu ze zwykłą aktywnością oraz serwer.
Pasek dostępności pokazuje ostatnie 24 godziny w odcinkach po 15 minut. Karta Monitorowane strony pokazuje stronę główną i dodatkowe strony z ostatnim kodem HTTP, czasem odpowiedzi i dostępnością z 24 godzin.

Dwa wykresy pokazują czas odpowiedzi (średnia i p95) oraz błędy PHP na godzinę z 24 godzin, a pod nimi ostatnie błędy i najwolniejsze typy stron.

Zadanie cron
Błędy krytyczne i nieudane płatności są zgłaszane w czasie rzeczywistym. Cała reszta (dostępność, czas odpowiedzi, zamówienia, stan serwera, raport) jest sprawdzana przez zaplanowane zadanie uruchamiane co 5 minut.
Cron serwera (zalecane)
*/5 * * * * php /sciezka/do/prestashop/modules/dfmonitor/cron.php
Dokładne polecenie, ze ścieżką Twojego serwera, jest widoczne w Ustawienia > Zaplanowane sprawdzanie wraz z przyciskiem Kopiuj. Uruchamiaj je jako użytkownik serwera WWW. cron.php odrzuca każde wywołanie, które nie pochodzi z wiersza poleceń.
Cron przez adres URL
Jeśli hosting pozwala tylko na crony WWW, wywołuj adres URL podany w tej samej zakładce z panelu hostingu albo przez usługę taką jak cron-job.org. Token można też przesłać w nagłówku X-Dfmonitor-Token. Bez właściwego tokenu adres odpowiada 403 i niczego nie ujawnia. Z tokenem odpowiedź zawiera tylko status, czas trwania i liczbę otwartych alertów: żadnej ścieżki, wersji ani komunikatu o błędzie. Przez ten adres kontrole uruchamiają się najwyżej raz na minutę, a Wygeneruj nowy token unieważnia poprzedni.

Bez crona
Przy PHP-FPM opcja Rozwiązanie zapasowe bez crona uruchamia kontrole z ruchu odwiedzających, gdy przez 10 minut nie działał żaden cron, już po wysłaniu strony. Test dostępności i heartbeat nie działają w tym trybie. Przy Apache mod_php cron jest niezbędny.
Zewnętrzny heartbeat
Moduł nie zgłosi całkowitej awarii serwera. Utwórz kontrolę w Healthchecks.io lub Better Stack i wklej jej adres w polu Adres URL heartbeat: jest wywoływany przy każdym uruchomieniu crona, a usługa ostrzega Cię, gdy wywołania ustaną.
Kanały powiadomień
Włącz dowolną liczbę kanałów w Ustawienia > Kanały powiadomień. Każdy kanał ma minimalny poziom ważności (ostrzeżenie i krytyczny albo tylko krytyczny) oraz przycisk Zapisz i wyślij test. Wynik ostatniej wysyłki widać pod nazwą kanału.

Sekrety nigdy nie są ponownie wyświetlane. Po zapisaniu webhooki Slack i Discord, token Telegram, adres i sekret webhooka oraz adres heartbeat są ukryte: pole pozostaje puste z podpowiedzią w rodzaju https://hooks.slack.com/...7f3a. Zostaw je puste, aby zachować wartość, wpisz nową, aby ją zastąpić, albo kliknij Usuń.
Wpisz jednego lub kilku odbiorców rozdzielonych przecinkami. E-maile korzystają z konfiguracji poczty PrestaShop (Zaawansowane > E-mail). Język alertów obowiązuje we wszystkich kanałach; domyślnie jest to język sklepu. E-maile są dostępne po polsku, angielsku, francusku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku.

Telegram
- W Telegramie otwórz @BotFather, wyślij
/newboti postępuj zgodnie z instrukcjami. - Wklej otrzymany token w polu Token bota.
- Wyślij wiadomość do bota albo dodaj go do grupy i kliknij Wykryj mój czat: ID czatu uzupełni się samo.
Slack i Discord
Slack: Apps > Incoming Webhooks > Add to Slack, wybierz kanał i skopiuj adres zaczynający się od https://hooks.slack.com/. Discord: Ustawienia serwera > Integracje > Webhooki > Nowy webhook, a potem Kopiuj adres URL webhooka.
Webhook
Dla Zapier, Make, n8n, systemu dyżurów albo własnego skryptu. Dla każdego nowego alertu, przypomnienia i rozwiązania wysyłany jest POST JSON z nagłówkiem X-DataFirefly-Event (open, repeat, resolved, test). Treść zawiera event, alert (id, key, type, severity, title, message, occurrences, first_at, last_at, ack_url), shop i sent_at. Gdy ustawisz sekret podpisu, każde żądanie zawiera X-DataFirefly-Signature: sha256=…, czyli HMAC SHA-256 surowej treści.
Ze względów bezpieczeństwa adresy sieci prywatnej, samego serwera i usług metadanych chmury są odrzucane, a przekierowania nie są wykonywane. Jeśli Twoje narzędzie działa we własnej sieci, włącz Zezwól na webhook w sieci prywatnej; adresy metadanych chmury pozostają odrzucane.
Reguły alertów
- Przypomnienie o trwającym alercie: odstęp między dwoma powiadomieniami o tym samym problemie (domyślnie 60 minut). Problem, który się pogarsza z ostrzeżenia do krytycznego, jest zgłaszany od razu.
- Maksymalna liczba powiadomień na godzinę: domyślnie 20, 0 bez limitu. Alert wysłany do kilku kanałów liczy się raz. Wstrzymana wiadomość widnieje w dzienniku jako Wstrzymano i zostaje wysłana później.
- Rozwiąż po: liczba poprawnych kontroli z rzędu przed zamknięciem alertu (domyślnie 2), aby wartość oscylująca wokół progu nie wysyłała w kółko wiadomości o otwarciu i rozwiązaniu.
- Komunikat o rozwiązaniu: wiadomość wychodzi, gdy zgłoszony problem znika.
- Prywatność: adresy e-mail w komunikatach o błędach są maskowane w Slacku, Telegramie, Discordzie i webhooku (domyślnie włączone).
- Godziny ciszy: w wybranym przedziale wysyłane są tylko alerty krytyczne; ostrzeżenia czekają do końca przedziału.
- Raport podsumowujący e-mailem: wyłączony, codzienny albo w każdy poniedziałek o wybranej godzinie.

Wstrzymanie
Przycisk Wstrzymaj zawiesza powiadomienia na 30 minut, 2 godziny, 8 godzin albo 24 godziny, na przykład w czasie aktualizacji. Problemy są nadal wykrywane i zapisywane; te, które są otwarte po zakończeniu przerwy, zostają zgłoszone.
Co wykrywa moduł
Błędy PHP
Moduł przechwytuje błędy krytyczne i ostrzeżenia (opcjonalnie także notices i deprecations) w sklepie oraz, jeśli opcja jest włączona, w panelu administracyjnym. Identyczne błędy są grupowane. Nowy błąd krytyczny od razu wywołuje alert krytyczny; wygasa on bez komunikatu po 24 godzinach bez nowego wystąpienia. Alert o skoku pojawia się powyżej 100 błędów i ostrzeżeń w 15 minut (regulowane, 0 wyłącza). Logi PrestaShop o ważności 3 i 4 są importowane przy każdym uruchomieniu crona. Każdy błąd otrzymuje prawdopodobne źródło: moduł, motyw, override, skompilowany szablon albo rdzeń; gdy błąd powstaje w rdzeniu, przyjmowany jest pierwszy moduł ze stosu wywołań.
Czas odpowiedzi
Czas odpowiedzi jest mierzony podczas prawdziwych wizyt. Odsetek mierzonych stron wynosi od 1 do 100 %; każda mierzona strona to jeden zapis w bazie danych. Alert pojawia się, gdy 95. percentyl z 15 minut przekracza próg (domyślnie 3000 ms), od 20 zmierzonych stron, i zostaje rozwiązany, gdy p95 spadnie 10 % poniżej progu. Alert krytyczny pojawia się, gdy ponad 5 % żądań w ciągu 15 minut kończy się błędem serwera, przy co najmniej 5 błędach.
Dostępność i monitorowane strony
Przy każdym uruchomieniu crona serwera moduł wczytuje stronę główną i do 5 wybranych stron: kategorię, produkt, koszyk, stronę kontaktową… Strona jest dostępna, gdy odpowiada HTTP 2xx lub 3xx (po najwyżej 3 przekierowaniach), 401 albo 429. Jest niedostępna, gdy nie odpowiada, zwraca 5xx lub inny 4xx, nie zawiera ustawionego oczekiwanego tekstu albo, w przypadku strony głównej, jest pusta. Po 2 niepowodzeniach z rzędu (regulowane) otwiera się alert krytyczny. W trybie konserwacji kontrola jest zawieszona.

Akceptowane są tylko adresy w domenach Twojego sklepu: przy tej kontroli moduł nigdy nie łączy się z inną witryną. Użyj Zapisz i przetestuj strony teraz, aby sprawdzić je od razu. Jeśli serwer nie może połączyć się z własnym adresem publicznym (niektóre hostingi, Docker, proxy), wpisz lokalny adres serwera WWW w polu Adres połączenia, na przykład 127.0.0.1:80: adres strony i nagłówek Host pozostają bez zmian.
Płatności i zamówienia
- Nieudane płatności: zamówienia, które w ostatniej godzinie przeszły do jednego z wybranych statusów, według modułu płatności (domyślny próg 3). Kontrola uruchamia się też od razu, gdy zamówienie zmienia status, po wysłaniu odpowiedzi: nigdy nie spowalnia zamówienia.
- Konwersja zamówień: odsetek koszyków, które doszły do kroku płatności i stały się zamówieniami, w oknie 2 godzin, w porównaniu ze zwykłym odsetkiem z 28 dni. Zaczyna działać po około 40 koszykach historii.
- Spadek zamówień: zamówienia z ostatnich 3 godzin (regulowane) w porównaniu z tym samym przedziałem z 4 poprzednich tygodni. Pomijany, gdy oczekuje się mniej niż 4 zamówień.
- Czułość: niska, średnia (zalecana) lub wysoka.

Stan serwera
- Certyfikat SSL: odczytywany co 6 godzin. Ostrzeżenie 14 dni przed wygaśnięciem (regulowane), krytyczny przy 3 dniach.
- Miejsce na dysku: ostrzeżenie poniżej 2048 MB wolnego miejsca (regulowane), krytyczny poniżej jednej czwartej tego progu.
- Nadzór crona: po pierwszym uruchomieniu crona serwera alert pojawia się po 30 minutach bez uruchomienia.

Obsługa alertów
Problem otwiera jeden alert, aktualizowany tak długo, jak trwa. Zakładka Alerty pokazuje podsumowanie z 30 dni (alerty, alerty krytyczne, średni czas rozwiązania, wysłane wiadomości), historię z czasem trwania każdego incydentu i dziennik każdej wysyłki.

- Potwierdź: zatrzymuje przypomnienia. Komunikat o rozwiązaniu i tak zostanie wysłany.
- Zamknij: zamyka alert. Jeśli problem nadal występuje, przy następnej kontroli otworzy się nowy alert.

Potwierdzanie z telefonu
Każde powiadomienie o alercie zawiera podpisany dla tego alertu link Potwierdź i zatrzymaj przypomnienia. Otwiera on w sklepie stronę potwierdzenia zaprojektowaną dla telefonu, a alert zostaje potwierdzony dopiero po Twojej akceptacji: skanery poczty, które otwierają linki, nie mogą więc potwierdzić go za Ciebie.

Strona błędów PHP
Filtruj według ważności lub źródła i szukaj komunikatu, pliku albo strony. Rozwinięty błąd pokazuje stronę, kontroler, daty, pełny komunikat i stos wywołań. Kopiuj raport dla programisty kopiuje tekst z wersjami PrestaShop i PHP, plikiem, źródłem, stroną, liczbą wystąpień, komunikatem i stosem wywołań. Wycisz nadal liczy błąd, ale już nigdy o nim nie alarmuje.

Uprawnienia
Pracownik, którego profil ma tylko uprawnienie wyświetlanie do Monitoring i alerty, widzi wszystkie ekrany w trybie tylko do odczytu: pola są wyłączone, a akcje (uruchomienie, wstrzymanie, potwierdzenie, ustawienia) są odrzucane.
Dane i prywatność
- Adresy stron są zapisywane bez parametrów URL, a stos wywołań bez argumentów funkcji.
- Ścieżka serwera i nazwa folderu administracyjnego są usuwane z każdego zapisanego lub wysłanego tekstu.
- Tokeny botów i ścieżki webhooków są maskowane w dzienniku powiadomień.
- Historia jest domyślnie czyszczona po 30 dniach (od 7 do 365 dni), małymi porcjami; zamknięte alerty są przechowywane co najmniej 90 dni.
Znane ograniczenia
- Test dostępności wychodzi z samego serwera: nie widzi zewnętrznej awarii sieci ani DNS. Ten przypadek obejmuje zewnętrzny heartbeat.
- Błąd krytyczny, który wystąpi przed załadowaniem modułów, nie zostanie przechwycony; zgłosi go test dostępności i odsetek błędów 5xx.
- Strony Symfony w panelu nie przechodzą przez hook, który przechwytuje błędy panelu administracyjnego.
- Konwersja zamówień opiera się na hooku
displayPaymentTop. Jeśli Twój jednostronicowy checkout go nie wywołuje, wyłącz tę kontrolę: spadek zamówień nadal działa.
Rozwiązywanie problemów
Test e-mail nie działa
Sprawdź konfigurację w Zaawansowane > E-mail i wyślij test z tej strony. Dokładny błąd pojawia się po teście i w zakładce Alerty.
Strona główna jest oznaczona jako niedostępna, choć sklep działa
Serwer prawdopodobnie nie może połączyć się z własnym adresem publicznym. Uzupełnij Adres połączenia (na przykład 127.0.0.1:80) i kliknij Zapisz i przetestuj strony teraz.
Komunikat „Nie wykryto crona serwera” nie znika
Liczy się tylko cron z wiersza poleceń i adres URL crona. Uruchom polecenie ręcznie przez SSH: wyświetli raport JSON. Jeśli się nie powiedzie, sprawdź ścieżkę PHP CLI u dostawcy hostingu.
Test webhooka odpowiada „adres odrzucony”
Adres URL wskazuje na sieć prywatną albo na sam serwer. Użyj adresu publicznego albo włącz Zezwól na webhook w sieci prywatnej, jeśli Twoje narzędzie działa we własnej sieci.