Crash Snapshot Lite

Crash Snapshot Lite – Kostenlose Produktionsfehler-Erfassung für PrestaShop 9

Crash Snapshot Lite ist ein kostenloses Diagnosemodul für PrestaShop 9, das unterstützte PHP-, Symfony- und PrestaShop-Fehler auf Anwendungsebene in der Produktion erfasst, ohne den Shop in einen vollständigen Debug-Bildschirm zu verwandeln. Es speichert einen bereinigten Incident-Snapshot im Back Office, sodass ein zufällig auftretender Fehler nachträglich untersucht werden kann.

Anwendungsfehler erfassen, ohne vollständiges Debugging zu aktivieren

Nachdem die Crash-Snapshot-Laufzeit geladen wurde, können unterstützte Exceptions automatisch erfasst werden. Fatale Fehler und Shutdown-Fehler verwenden zunächst einen privaten Datei-Spool als Fallback; anschließend können eine normale Anfrage oder der Wartungs-Cron diese Incidents in die Datenbank importieren.

Die für die Untersuchung benötigten Informationen sehen

Jeder Incident kann eine bereinigte Fehlermeldung, Fehler- oder Exception-Typ, Datei und Zeile, einen sicheren Stack Trace, Front-Office-/Back-Office-/API-Kontext, Anfrageinformationen und Umgebungsdetails wie PrestaShop-Version, PHP-Version, Theme, Shop-ID und Speichernutzung enthalten.

Sensible Anfragedaten schützen

Crash Snapshot geht bewusst konservativ mit erfassten Daten um. Bekannte Secrets, Cookies, Authorization-Header, rohe Request-Bodies und Stack-Argumente werden standardmäßig nicht gespeichert. Ein Datenschutzfilter entfernt außerdem sensible Werte aus Diagnosezeichenketten, bevor sie gespeichert werden.

Wiederholte Fehler per Fingerprint gruppieren

Wiederholte Vorkommen desselben Problems werden unter einem Incident-Fingerprint zusammengefasst. Statt das Dashboard mit doppelten Zeilen zu füllen, erhöht Crash Snapshot den Vorkommenszähler und aktualisiert den Zeitpunkt des letzten Auftretens.

Incident-Workflow im Back Office

• Incidents nach Incident-Code, Meldung, Datei oder Route durchsuchen.
• Nach Front-Office-, Back-Office- oder API-Kontext filtern.
• Nach geprüft / ungeprüft und grundlegenden Diagnosefeldern filtern.
• Eine detaillierte Incident-Ansicht mit bereinigten Diagnosedaten öffnen.
• Einen Diagnose-Snapshot zur Fehleranalyse kopieren.
• Incidents als geprüft markieren oder einzelne Incidents löschen.
• Shopbezogene Incident-Ansichten in Multistore-Umgebungen verwenden.

Integrierter Capture-Health-Check und sicherer Selbsttest

Das Diagnosepanel prüft Exception-Listener, Shutdown-Handler, privates Spool-Verzeichnis, Datenbankspeicherung, Datenschutzfilter und Retention-Bereinigung. Ein sicherer Selbsttest erzeugt bewusst klar gekennzeichnete synthetische Incidents, damit Capture-Pipeline, Spool-Import und Datenschutzbereinigung überprüft werden können.

Wartungs-Cron für vorhersehbare Verarbeitung des Fatal-Spools

Das Modul erzeugt eine private, tokenisierte Cron-URL. Wird sie ungefähr alle fünf Minuten ausgeführt, importiert sie Fatal-/Shutdown-Incidents aus dem privaten Spool und führt die Retention-Bereinigung durch. Normale Anwendungsexceptions werden sofort gespeichert, wenn die Datenbank verfügbar ist; der Cron durchsucht daher nicht den normalen Shop-Traffic nach Fehlern.

Was in Lite bewusst nicht enthalten ist

Lite versucht nicht, das wahrscheinlichste Modul, Theme oder die wahrscheinlichste Datenbankquelle zu identifizieren, einen Incident mit jüngsten Modul-/Cache-Änderungen zu korrelieren, SQLSTATE-Details zu klassifizieren, herunterladbare Support-Bundles zu erstellen oder E-Mail-/Webhook-Alerts zu senden. Diese Workflows sind Crash Snapshot Pro vorbehalten.

Kompatibilität und wichtige Einschränkungen

• Entwickelt für PrestaShop 9.
• Erfordert PHP 8.1+.
• Es wird kein PrestaShop-Core-Override verwendet.
• Erfasste Incidents sind Diagnosen auf Anwendungsebene und kein Ersatz für Webserver-, PHP-FPM- oder Betriebssystem-Logs.
• Fehler vor dem PHP-/PrestaShop-/Modul-Bootstrap, harte PHP-FPM-Abstürze, Out-of-Memory-Kills des Betriebssystems und vorgeschaltete 502/503-Fehler können auftreten, bevor Crash Snapshot sie erfassen kann.
• Bei der Deinstallation bleiben erfasste Incident-Daten erhalten; eine destruktive Bereinigung ist eine separate, ausdrücklich ausgelöste Aktion.

Häufig gestellte Fragen

Erfasst Crash Snapshot jeden HTTP-500-Fehler?

Nein. Es erfasst unterstützte Fehler auf Anwendungsebene, nachdem seine Laufzeit geladen wurde. Ein Fehler, der auftritt, bevor PrestaShop oder das Modul startet, kann nicht garantiert in Crash Snapshot erscheinen.

Speichert es Passwörter, Cookies oder Request-Bodies?

Bekannte Secrets, Cookies, Authorization-Header, rohe Request-Bodies und Stack-Argumente werden standardmäßig nicht gespeichert. Der Datenschutzfilter bereinigt Diagnosezeichenketten zusätzlich vor der Speicherung.

Warum hat das Modul eine Cron-URL?

Der Cron ist ein Wartungspfad. Er importiert Fatal-/Shutdown-Incidents, die zuerst in den privaten Spool geschrieben wurden, und führt die Retention-Bereinigung aus. Er durchsucht keine normalen Seiten nach Fehlern.

Kann ich später von Lite auf Pro wechseln?

Ja. Lite und Pro verwenden dasselbe Crash-Snapshot-Speichermodell für Incidents. Pro erweitert das Diagnoseschema und wird zur aktiven Edition, ohne eine separate Incident-Historie zu benötigen.