Crash Snapshot Lite

Crash Snapshot Lite – Darmowe przechwytywanie błędów produkcyjnych dla PrestaShop 9

Crash Snapshot Lite to darmowy moduł diagnostyczny dla PrestaShop 9, który przechwytuje obsługiwane błędy PHP, Symfony i PrestaShop na poziomie aplikacji w środowisku produkcyjnym bez zamieniania sklepu w pełny ekran debugowania. Zapisuje w Back Office oczyszczony z danych wrażliwych zrzut incydentu, dzięki czemu losowy błąd można przeanalizować już po jego wystąpieniu.

Przechwytuj błędy aplikacji bez włączania pełnego debugowania

Po załadowaniu runtime Crash Snapshot obsługiwane wyjątki mogą być przechwytywane automatycznie. Błędy krytyczne i błędy zamknięcia najpierw korzystają z prywatnego spoolu plikowego, a następnie zwykłe żądanie lub cron konserwacyjny może zaimportować te incydenty do bazy danych.

Zobacz informacje potrzebne do analizy

Każdy incydent może zawierać oczyszczony komunikat błędu, typ błędu lub wyjątku, plik i linię, bezpieczny stack trace, kontekst Front Office / Back Office / API, informacje o żądaniu oraz dane środowiska, takie jak wersja PrestaShop, wersja PHP, motyw, ID sklepu i użycie pamięci.

Chroń wrażliwe dane żądań

Crash Snapshot celowo zachowuje ostrożność w zakresie przechwytywanych danych. Znane sekrety, cookies, nagłówki autoryzacyjne, surowe body żądań i argumenty stosu nie są domyślnie zapisywane. Filtr prywatności usuwa również wrażliwe wartości z ciągów diagnostycznych przed ich zapisaniem.

Grupuj powtarzające się awarie według odcisku

Powtarzające się wystąpienia tego samego problemu są grupowane pod jednym odciskiem incydentu. Zamiast zapełniać panel zduplikowanymi wierszami, Crash Snapshot zwiększa licznik wystąpień i aktualizuje czas ostatniego wystąpienia.

Obsługa incydentów w Back Office

• Wyszukiwanie incydentów według kodu incydentu, komunikatu, pliku lub trasy.
• Filtrowanie według kontekstu Front Office, Back Office lub API.
• Filtrowanie według statusu przejrzany / nieprzejrzany i podstawowych pól diagnostycznych.
• Otwieranie szczegółowego widoku incydentu z oczyszczoną diagnostyką.
• Kopiowanie zrzutu diagnostycznego do rozwiązywania problemów.
• Oznaczanie incydentów jako przejrzane lub usuwanie pojedynczych incydentów.
• Widoki incydentów zależne od sklepu w środowiskach multistore.

Wbudowana kontrola stanu przechwytywania i bezpieczny autotest

Panel diagnostyczny sprawdza listener wyjątków, handler zamknięcia, prywatny katalog spoolu, zapis do bazy danych, filtr prywatności oraz czyszczenie retencji. Bezpieczny autotest celowo tworzy wyraźnie oznaczone syntetyczne incydenty, aby zweryfikować pipeline przechwytywania, import spoolu i usuwanie danych wrażliwych.

Cron konserwacyjny do przewidywalnego przetwarzania spoolu błędów krytycznych

Moduł generuje prywatny adres cron zabezpieczony tokenem. Uruchamianie go mniej więcej co pięć minut importuje incydenty krytyczne/zamknięcia z prywatnego spoolu i wykonuje czyszczenie retencji. Zwykłe wyjątki aplikacji są zapisywane natychmiast, gdy baza danych jest dostępna, więc cron nie skanuje normalnego ruchu sklepu w poszukiwaniu błędów.

Czego celowo nie ma w Lite?

Lite nie próbuje wskazywać najbardziej prawdopodobnego modułu, motywu lub źródła bazodanowego, korelować incydentu z ostatnimi zmianami modułów/cache, klasyfikować szczegółów SQLSTATE, tworzyć pakietów wsparcia do pobrania ani wysyłać alertów e-mail/webhook. Te workflow są zarezerwowane dla Crash Snapshot Pro.

Zgodność i ważne ograniczenia

• Zaprojektowany dla PrestaShop 9.
• Wymaga PHP 8.1+.
• Nie używa override'ów rdzenia PrestaShop.
• Przechwycone incydenty są diagnostyką na poziomie aplikacji, a nie zamiennikiem logów serwera WWW, PHP-FPM czy systemu operacyjnego.
• Błędy występujące przed bootstrapem PHP/PrestaShop/modułu, twarde awarie PHP-FPM, ubicia procesu przez system z powodu braku pamięci oraz upstreamowe błędy 502/503 mogą wystąpić zanim Crash Snapshot będzie mógł je przechwycić.
• Odinstalowanie zachowuje przechwycone dane incydentów; destrukcyjne czyszczenie jest osobną, wyraźnie uruchamianą akcją.

Najczęściej zadawane pytania

Czy Crash Snapshot przechwyci każdy błąd HTTP 500?

Nie. Przechwytuje obsługiwane awarie na poziomie aplikacji po załadowaniu swojego runtime. Nie można zagwarantować przechwycenia błędu, który wystąpi zanim uruchomi się PrestaShop lub moduł.

Czy zapisuje hasła, cookies lub body żądań?

Znane sekrety, cookies, nagłówki autoryzacyjne, surowe body żądań i argumenty stosu nie są domyślnie zapisywane. Filtr prywatności dodatkowo oczyszcza ciągi diagnostyczne przed zapisem.

Dlaczego moduł ma adres cron?

Cron jest ścieżką konserwacyjną. Importuje incydenty fatal/shutdown, które zostały najpierw zapisane w prywatnym spoolu, i uruchamia czyszczenie retencji. Nie przegląda normalnych stron sklepu w poszukiwaniu błędów.

Czy mogę później przejść z Lite na Pro?

Tak. Lite i Pro używają tego samego modelu przechowywania incydentów Crash Snapshot. Pro rozszerza schemat diagnostyczny i staje się aktywną edycją bez potrzeby tworzenia oddzielnej historii incydentów.