Weryfikacja i typowe problemy - PrestaShop

Zdarzenie testowe

Na ekranie konfiguracji kliknij Wyślij zdarzenie testowe. Moduł wysyła je synchronicznie i pokazuje wynik razem z identyfikatorem, bez przeładowania strony; rezultat i data zostają na ekranie jako pigułka statusu. Zdarzenie powinno pojawić się w panelu w sekcji Błędy projektu wskazanego przez token.

Weryfikacja na prawdziwym wyjątku

Test z ekranu potwierdza połączenie, nie automatyczne przechwytywanie. Na sklepie testowym wywołaj nieobsłużony wyjątek - na przykład z tymczasowego Reporter::report() w kodzie własnego modułu - i sprawdź, czy zdarzenie ma środowisko, czas i kontekst żądania. Po teście usuń ten kod.

Typowe problemy

Moduł instaluje się, ale nic nie raportuje

Wyczyść cache. PrestaShop trzyma listę podpiętych hooków w kontenerze usług, więc świeżo zainstalowany moduł bywa niewidoczny do pierwszego przebudowania kontenera: php bin/console cache:clear albo Parametry zaawansowane → Wydajność.

Sklep testowy raportuje do projektu produkcyjnego

Kopia sklepu zabrała ze sobą bazę, a w niej poświadczenia. Nadpisz klucz stałą _DOCKRAY_PRIVATE_KEY_ w app/config/parameters.php albo przestaw źródło konfiguracji na Tylko stałe. Plik parametrów nie jest częścią zrzutu bazy, więc następna kopia niczego nie nadpisze.

Wpisałem klucz w formularzu, a moduł używa innego

Zwykle w app/config/parameters.php stoi stała, a źródło konfiguracji jest ustawione na Auto. Obszar statusu wypisuje, które stałe są aktywne.

Błędy JavaScriptu nie docierają

Kolektor jest domyślnie wyłączony - włącz Zbieraj błędy JavaScript w konfiguracji modułu. Jeżeli po włączeniu nadal nic nie przychodzi, pamiętaj, że front controller odpowiada 202 także wtedy, gdy zgłoszenie odrzucił: bramkami są token PrestaShopu, limit 16 kB i 20 zgłoszeń na adres IP na minutę.

Brakuje transakcji, choć błędy docierają

Pomiar czasu żądań jest sterowany osobno. Przy próbkowaniu transakcji równym 0 nie powstaje ani jedna transakcja - to nie awaria, tylko ustawienie.

Ten sam błąd rozbija się na wiele wpisów

Panel grupuje błędy po odcisku sha256(token projektu + typ + komunikat). Jeśli komunikat zawiera numer zamówienia, identyfikator koszyka albo znacznik czasu, każde wystąpienie jest dla panelu innym błędem. Zmienną część przenieś z komunikatu do kontekstu.

Panel odpowiada 200, ale zdarzenia nie ma

Odpowiedź 200 {"success": false} znaczy, że konto wyczerpało miesięczny limit błędów. Integracja nie traktuje tego jak awarii - i słusznie. Limit widzisz na pulpicie konta; do końca miesiąca liczy się z zapisanego zużycia, więc nie zresetuje go usunięcie błędów.

Nadal nie działa

Przejdź przez listę kontrolną braku danych w panelu, a jeśli to nie pomoże - napisz do nas. Podaj nazwę projektu, wersję integracji i przybliżoną godzinę testu: to skraca drogę do odpowiedzi.