Überprüfung und typische Probleme - PrestaShop

Das Testereignis

Klicke im Konfigurationsbildschirm auf Testereignis senden. Das Modul sendet es synchron und zeigt das Ergebnis samt ID, ohne die Seite neu zu laden; Ergebnis und Zeitstempel bleiben als Status-Pille stehen. Das Ereignis sollte im Panel unter Fehler des Projekts erscheinen, auf das der Token zeigt.

Prüfung an einer echten Ausnahme

Der Test vom Bildschirm bestätigt die Verbindung, nicht das automatische Erfassen. Löse in einem Test-Shop eine unbehandelte Ausnahme aus - etwa über ein temporäres Reporter::report() in einem eigenen Modul - und prüfe, ob das Ereignis Umgebung, Zeit und Anfragekontext trägt. Entferne den Code danach.

Typische Probleme

Das Modul installiert sich, meldet aber nichts

Leere den Cache. PrestaShop hält die Liste der eingehängten Hooks im Service-Container, ein frisch installiertes Modul kann also unsichtbar bleiben, bis der Container neu gebaut wird: php bin/console cache:clear oder Erweiterte Parameter → Leistung.

Der Test-Shop berichtet in das Produktionsprojekt

Der kopierte Shop hat seine Datenbank und damit die Zugangsdaten mitgebracht. Überschreibe den Schlüssel mit der Konstante _DOCKRAY_PRIVATE_KEY_ in app/config/parameters.php, oder stelle die Konfigurationsquelle auf Nur Konstanten. Die Parameterdatei ist kein Teil eines Datenbank-Dumps, die nächste Kopie überschreibt sie also nicht.

Ich habe einen Schlüssel im Formular eingetragen, das Modul nutzt einen anderen

Meist ist in app/config/parameters.php eine Konstante definiert, während die Konfigurationsquelle auf Auto steht. Der Statusbereich listet die aktiven Konstanten auf.

JavaScript-Fehler kommen nicht an

Der Kollektor ist standardmäßig aus - aktiviere JavaScript-Fehler sammeln in der Modulkonfiguration. Kommt danach trotzdem nichts, denke daran, dass der Front-Controller auch bei abgelehnter Meldung mit 202 antwortet: die Schranken sind der PrestaShop-Token, das Limit von 16 kB und 20 Meldungen pro IP-Adresse und Minute.

Transaktionen fehlen, obwohl Fehler ankommen

Die Zeitmessung wird getrennt gesteuert. Bei einer Transaktions-Stichprobenrate von 0 entsteht keine einzige Transaktion - das ist eine Einstellung, keine Störung.

Ein Fehler zerfällt in viele Einträge

Das Panel gruppiert Fehler über den Fingerabdruck sha256(Projekt-Token + Typ + Meldung). Enthält die Meldung eine Bestellnummer, eine Warenkorb-ID oder einen Zeitstempel, ist jedes Auftreten für das Panel ein anderer Fehler. Verschiebe den variablen Teil aus der Meldung in den Kontext.

Das Panel antwortet 200, aber es gibt kein Ereignis

Eine Antwort 200 {"success": false} bedeutet, dass das Konto sein monatliches Fehlerkontingent aufgebraucht hat. Die Integration behandelt das nicht als Störung - zu Recht. Das Kontingent siehst du im Konto-Dashboard; bis zum Monatsende wird es aus der erfassten Nutzung berechnet, Fehler zu löschen setzt es also nicht zurück.

Es funktioniert weiterhin nicht

Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.