PS PrestaShop Początkujący

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.

Zaktualizowano Wersja modułu 2.0.0

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.

Panel: trwający problem krytyczny, otwarte alerty i wskaźniki sklepu
Panel: trwający problem krytyczny, otwarte alerty i wskaźniki sklepu

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

  1. W panelu otwórz Moduły > Menedżer modułów, kliknij Załaduj moduł i wyślij plik dfmonitor-2.0.0.zip.
  2. Moduł tworzy swoje tabele i zakładkę Zaawansowane > Monitoring i alerty. Przycisk Konfiguruj modułu prowadzi bezpośrednio do niej.
  3. 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.

Dostępność z 24 godzin i monitorowane strony z oczekiwanym tekstem, kodem HTTP i czasem odpowiedzi
Dostępność z 24 godzin i monitorowane strony z oczekiwanym tekstem, kodem HTTP i czasem odpowiedzi

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.

Wykresy czasu odpowiedzi (średnia i p95) oraz błędów PHP na godzinę, najwolniejsze typy stron
Wykresy czasu odpowiedzi (średnia i p95) oraz błędów PHP na godzinę, 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.

Zaplanowane kontrole: cron serwera, adres crona chroniony tokenem, zewnętrzny heartbeat i retencja
Zaplanowane kontrole: cron serwera, adres crona chroniony tokenem, zewnętrzny heartbeat i retencja

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.

Kanały alertów: e-mail, Telegram, Slack, Discord i webhook, tokeny zapisane i ukryte
Kanały alertów: e-mail, Telegram, Slack, Discord i webhook, tokeny zapisane i ukryte

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ń.

E-mail

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.

E-mail z alertem o błędzie krytycznym PHP z prawdopodobnym źródłem i przyciskiem potwierdzenia
E-mail z alertem o błędzie krytycznym PHP z prawdopodobnym źródłem i przyciskiem potwierdzenia

Telegram

  1. W Telegramie otwórz @BotFather, wyślij /newbot i postępuj zgodnie z instrukcjami.
  2. Wklej otrzymany token w polu Token bota.
  3. 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.
Reguły alertów: przypomnienie, limit godzinowy, rozwiązanie po kilku kontrolach, prywatność i godziny ciszy
Reguły alertów: przypomnienie, limit godzinowy, rozwiązanie po kilku kontrolach, prywatność i godziny ciszy

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.

Kontrola dostępności: strona główna z oczekiwanym tekstem i do 5 stron sklepu
Kontrola dostępności: strona główna z oczekiwanym tekstem i do 5 stron sklepu

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.
Płatności i zamówienia: statusy nieudanej płatności, konwersja przy płatności i spadek zamówień
Płatności i zamówienia: statusy nieudanej płatności, konwersja przy płatności i spadek zamówień

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.
Stan serwera: wygaśnięcie certyfikatu SSL, miejsce na dysku i nadzór zadania cron
Stan serwera: wygaśnięcie certyfikatu SSL, miejsce na dysku i nadzór zadania cron

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.

Historia alertów z podsumowaniem 30 dni i średnim czasem rozwiązania
Historia alertów z podsumowaniem 30 dni i średnim czasem rozwiązania
  • 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.
Dziennik powiadomień wysłanych e-mailem, przez Slack i Telegram, z wynikiem każdej wysyłki
Dziennik powiadomień wysłanych e-mailem, przez Slack i Telegram, z wynikiem każdej wysyłki

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 potwierdzenia otwarta na telefonie: zatrzymanie przypomnień bez logowania
Strona potwierdzenia otwarta na telefonie: zatrzymanie przypomnień bez logowania

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.

Dziennik błędów PHP: odpowiedzialny moduł, stos wywołań i raport do skopiowania dla programisty
Dziennik błędów PHP: odpowiedzialny moduł, stos wywołań i raport do skopiowania dla programisty

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.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia