Konfiguration - PrestaShop

Wo die Konfiguration liegt

Alles steht auf einem Bildschirm: Module → Modulmanager → DockRay → Konfigurieren. Oben sitzen zwei Status-Pillen - ob die Zugangsdaten vollständig sind und wie der letzte Verbindungstest ausgegangen ist, mit Zeitstempel.

Ein auf einen Testserver kopierter Shop

Das ist die klassische PrestaShop-Falle: ein nach Staging kopierter Shop nimmt seine Datenbank mit und damit die Projekt-Zugangsdaten - und beide Umgebungen berichten plötzlich in dasselbe Projekt. Überschreibe den Schlüssel mit einer Konstante in app/config/parameters.php, die kein Teil eines Datenbank-Dumps ist:

define('_DOCKRAY_PRIVATE_KEY_', 'privater-schluessel-des-testprojekts');

Die Konstante gewinnt gegenüber dem in der Tabelle configuration gespeicherten Wert.

Konfigurationsquelle

Der Schalter Konfigurationsquelle entscheidet, wie Konstanten und Formular zusammenspielen: Auto (Standard - eine definierte Konstante gewinnt für ihr Feld, alles andere kommt vom Formular), Nur Konstanten und Nur dieses Formular. Die letzte Option hilft, wenn eine gemeinsame Parameterdatei ein Standardprojekt festschreibt und ein Shop eines Multistores in sein eigenes berichten soll.

Die übrigen Konstanten wirken genauso: _DOCKRAY_TOKEN_, _DOCKRAY_URL_, _DOCKRAY_ENVIRONMENT_, _DOCKRAY_RELEASE_, _DOCKRAY_TRACES_SAMPLE_RATE_, _DOCKRAY_SEND_CUSTOMER_, _DOCKRAY_SEND_DEFAULT_PII_, _DOCKRAY_JS_ERRORS_ und _DOCKRAY_JS_SAMPLE_RATE_.

Umgebungen

Jede Umgebung sollte unter einem eindeutigen Namen berichten - production, staging, preview. Der Name ist eine Spalte im Panel und ein Filter in der Fehlerliste; ohne ihn sieht ein Produktionsausfall genauso aus wie ein Fehler, den jemand im Test ausgelöst hat. Lass die lokale Umgebung ohne Zugangsdaten: ohne Token und Schlüssel lädt die Integration und bleibt still - ein eigener Schalter ist nicht nötig.

Kundendaten und Datenschutz

Zwei Schalter, beide standardmäßig aus und bewusst getrennt. Angemeldeten Kunden anhängen sendet Kundennummer und E-Mail-Adresse - das hilft, den Weg einer Bestellung nachzuvollziehen, bringt aber personenbezogene Daten in das Monitoring. IP-Adresse und User-Agent senden ist eine eigene Entscheidung, denn sie betrifft auch Gäste. Aktiviere beides bewusst und halte es in deiner Datenschutzerklärung fest.

JavaScript-Fehler im Shop

Standardmäßig aus. Nach dem Aktivieren lädt das Modul im Storefront einen kleinen Kollektor, der window.onerror und unbehandelte Promise-Rejections an den Shop meldet, nicht an das Panel: eine Authentifizierung aus dem Browser würde den privaten Schlüssel im Seitenquelltext veröffentlichen. Der Shop leitet jeden Fehler mit seinem eigenen Schlüssel weiter.

Empfänger ist ein Front-Controller des Moduls (index.php?fc=module&module=dockray&controller=browsererror), geschützt durch den PrestaShop-Token, ein Body-Limit von 16 kB und 20 Meldungen pro IP-Adresse und Minute. Er antwortet 202, unabhängig davon, ob die Meldung angenommen wurde. Der Kollektor begrenzt sich ebenfalls: eine Meldung pro eigenständigem Fehler pro Seitenaufruf und höchstens zehn pro Seitenaufruf, ResizeObserver loop und Cross-Origin-Script error. werden ausgesiebt.

Aus eigenem Storefront-Code:

DockRay.captureException(error);
DockRay.captureMessage('Checkout step skipped');

Melden aus PHP

use Dock\Ray\PrestaShop\Reporter;

try {
    $this->syncStock();
} catch (\Throwable $exception) {
    Reporter::report($exception);

    throw $exception;
}

Reporter::report() wirft nie, du kannst es also auch in der Fehlerbehandlung aufrufen, aus der du gerade meldest.

Den privaten Schlüssel schützen

Der private Schlüssel ist ein Projektgeheimnis, keine Kennung. Bewahre ihn in Umgebungsvariablen, in einem Secret-Manager oder in der Serverkonfiguration auf - niemals im Repository, in Logs, auf einem Screenshot oder in Code, der an den Browser geht. Ein Projekt kann mehrere Schlüssel haben, deshalb sollten Produktion und Staging je eigene bekommen: jeder lässt sich einzeln widerrufen, ohne die übrigen zu unterbrechen. Der Verdacht, dass ein Schlüssel abgeflossen ist, genügt, um ihn zu widerrufen und einen neuen zu erzeugen.

Wann Ereignisse hinausgehen

Nach der Antwort. Das Modul sammelt Ereignisse während der Anfrage und leert die Warteschlange aus einem Shutdown-Handler, wenn PHP-FPM die Verbindung zum Browser geschlossen hat. Ein langsames Panel kostet den Käufer nichts.