PrestaShop Monitoring & Alarme (DataFirefly Monitor)
DataFirefly Monitor 2.0.0 auf PrestaShop 1.7.8 bis 9 installieren, den Cron einplanen, Alarmkanäle, überwachte Seiten und Regeln einstellen und jede Erkennung verstehen.
DataFirefly Monitor überwacht Ihren PrestaShop-Shop rund um die Uhr und warnt Sie, wenn er ausfällt, abstürzt, langsamer wird oder keine Zahlungen mehr annimmt. Er nennt das Modul, das wahrscheinlich die Ursache ist, sendet einen einzigen Alarm pro Problem und meldet, wenn alles wieder normal läuft. Diese Dokumentation gilt für Version 2.0.0.

Installation und Update
Voraussetzungen
- PrestaShop 1.7.8 bis 9.x, Multishop und mehrsprachig
- PHP 7.1 bis 8.5, mit cURL (empfohlen)
- Eine Cron-Aufgabe alle 5 Minuten (empfohlen, siehe unten)
Installation
- Öffnen Sie im Backoffice Module > Modul-Manager, klicken Sie auf Modul hochladen und senden Sie
dfmonitor-2.0.0.zip. - Das Modul legt seine Tabellen und den Reiter Erweiterte Einstellungen > Überwachung & Alarme an. Die Schaltfläche Konfigurieren des Moduls führt direkt dorthin.
- Bei der Installation wird die Shop-E-Mail als Empfänger verwendet und der Status Zahlungsfehler als Fehlerstatus gewählt. PrestaShop-Logs, die vor der Installation geschrieben wurden, werden nicht importiert.
Update von 1.x
Laden Sie das neue Zip über das alte hoch: Das Update-Skript fügt die neuen Spalten und Einstellungen hinzu, ohne Ihre Daten anzutasten. Fehlerverlauf, Alarme, Benachrichtigungen, Ihre Einstellungen und Ihr Cron-Token bleiben erhalten, die bisherige Cron-URL funktioniert also weiter.
Dashboard
Der Kopfbereich fasst den Zustand des Shops in einem Satz zusammen: Alles funktioniert, eine Warnung oder ein kritisches Problem. Darunter stehen die offenen Alarme mit den Schaltflächen Bestätigen und Schließen, dann sechs Kennzahlen: Verfügbarkeit über 24 Stunden, Antwortzeit über 1 Stunde (p95), PHP-Fehler über 24 Stunden, fehlgeschlagene Zahlungen, heutige Bestellungen im Vergleich zur üblichen Aktivität und Server.
Der Verfügbarkeitsstreifen zeigt die letzten 24 Stunden in 15-Minuten-Abschnitten. Die Karte Überwachte Seiten listet die Startseite und die zusätzlichen Seiten mit letztem HTTP-Status, Antwortzeit und Verfügbarkeit über 24 Stunden.

Zwei Diagramme zeigen die Antwortzeit (Durchschnitt und p95) und die PHP-Fehler pro Stunde über 24 Stunden, gefolgt von den letzten Fehlern und den langsamsten Seitentypen.

Cron-Aufgabe
Fatale Fehler und Zahlungsfehler werden in Echtzeit gemeldet. Alles andere (Verfügbarkeit, Antwortzeit, Bestellungen, Serverzustand, Bericht) wird von einer geplanten Aufgabe ausgewertet, die alle 5 Minuten laufen sollte.
Server-Cron (empfohlen)
*/5 * * * * php /pfad/zu/prestashop/modules/dfmonitor/cron.php
Der genaue Befehl mit dem Pfad Ihres Servers steht unter Einstellungen > Geplante Prüfungen, mit einer Kopieren-Schaltfläche. Führen Sie ihn mit dem Benutzer des Webservers aus. cron.php lehnt jeden Aufruf ab, der nicht von der Kommandozeile kommt.
Cron per URL
Erlaubt Ihr Hoster nur Web-Crons, rufen Sie die im selben Reiter angezeigte URL aus Ihrem Hosting-Panel oder über einen Dienst wie cron-job.org auf. Das Token kann auch im Header X-Dfmonitor-Token gesendet werden. Ohne das richtige Token antwortet die Adresse mit 403 und gibt nichts preis. Mit Token liefert die Antwort nur Status, Dauer und Anzahl offener Alarme: keinen Pfad, keine Version, keine Fehlermeldung. Über diese URL laufen die Prüfungen höchstens einmal pro Minute, und Neues Token erzeugen macht das vorherige ungültig.

Ohne Cron
Mit PHP-FPM startet die Option Ersatzlösung ohne Cron die Prüfungen über den Besucherverkehr, wenn seit 10 Minuten kein Cron gelaufen ist, nachdem die Seite gesendet wurde. Verfügbarkeitsprüfung und Heartbeat laufen in diesem Modus nicht. Mit Apache mod_php ist ein Cron unverzichtbar.
Externer Heartbeat
Das Modul kann einen kompletten Serverausfall nicht selbst melden. Legen Sie eine Prüfung bei Healthchecks.io oder Better Stack an und fügen Sie deren URL unter Heartbeat-URL ein: Sie wird bei jedem Cron-Lauf aufgerufen, und der Dienst warnt Sie, wenn die Aufrufe ausbleiben.
Benachrichtigungskanäle
Aktivieren Sie beliebig viele Kanäle unter Einstellungen > Benachrichtigungskanäle. Jeder Kanal hat eine Mindestschwere (Warnung und kritisch, oder nur kritisch) und eine Schaltfläche Speichern und Test senden. Das Ergebnis der letzten Zustellung steht unter dem Kanalnamen.

Geheimnisse werden nie wieder angezeigt. Nach dem Speichern sind die Slack- und Discord-Webhooks, das Telegram-Token, die Webhook-URL und ihr Geheimnis sowie die Heartbeat-URL verborgen: Das Feld bleibt leer, mit einem Hinweis wie https://hooks.slack.com/...7f3a. Lassen Sie es leer, um den Wert zu behalten, geben Sie einen neuen ein, um ihn zu ersetzen, oder klicken Sie auf Entfernen.
Geben Sie einen oder mehrere Empfänger durch Kommas getrennt ein. Die E-Mails nutzen die E-Mail-Konfiguration von PrestaShop (Erweiterte Einstellungen > E-Mail). Die Sprache der Alarme gilt für alle Kanäle; standardmäßig ist es die Shop-Sprache. Die E-Mails gibt es auf Deutsch, Englisch, Französisch, Spanisch, Italienisch, Niederländisch, Polnisch und Portugiesisch.

Telegram
- Öffnen Sie in Telegram @BotFather, senden Sie
/newbotund folgen Sie den Anweisungen. - Fügen Sie das erhaltene Token unter Bot-Token ein.
- Senden Sie Ihrem Bot eine Nachricht oder fügen Sie ihn einer Gruppe hinzu und klicken Sie auf Meinen Chat erkennen: Die Chat-ID wird automatisch eingetragen.
Slack und Discord
Slack: Apps > Incoming Webhooks > Add to Slack, Kanal wählen und die URL kopieren, die mit https://hooks.slack.com/ beginnt. Discord: Servereinstellungen > Integrationen > Webhooks > Neuer Webhook, dann Webhook-URL kopieren.
Webhook
Für Zapier, Make, n8n, ein Bereitschafts-Tool oder Ihr eigenes Skript. Für jeden neuen Alarm, jede Erinnerung und jede Behebung wird ein JSON-POST gesendet, mit dem Header X-DataFirefly-Event (open, repeat, resolved, test). Der Body enthält event, alert (id, key, type, severity, title, message, occurrences, first_at, last_at, ack_url), shop und sent_at. Mit einem Signaturgeheimnis trägt jede Anfrage X-DataFirefly-Signature: sha256=…, den HMAC SHA-256 des Rohinhalts.
Aus Sicherheitsgründen werden Adressen des privaten Netzwerks, des Servers selbst und von Cloud-Metadatendiensten abgelehnt, und Weiterleitungen werden nicht verfolgt. Läuft Ihr Tool im eigenen Netzwerk, aktivieren Sie Webhook im privaten Netzwerk erlauben; Cloud-Metadatenadressen bleiben abgelehnt.
Alarmregeln
- Erinnerung an einen laufenden Alarm: Abstand zwischen zwei Benachrichtigungen zum selben Problem (standardmäßig 60 Minuten). Ein Problem, das sich von Warnung auf kritisch verschlimmert, wird sofort gemeldet.
- Maximale Benachrichtigungen pro Stunde: standardmäßig 20, 0 ohne Begrenzung. Ein Alarm auf mehreren Kanälen zählt einmal. Eine zurückgehaltene Nachricht erscheint im Protokoll als Zurückgehalten und wird später gesendet.
- Beheben nach: Anzahl fehlerfreier Prüfungen in Folge, bevor ein Alarm geschlossen wird (standardmäßig 2), damit ein Wert, der um einen Schwellenwert schwankt, nicht ständig Öffnungs- und Behebungsmeldungen sendet.
- Entwarnung: Eine Nachricht wird gesendet, wenn ein gemeldetes Problem verschwindet.
- Datenschutz: E-Mail-Adressen in Fehlermeldungen werden in Slack, Telegram, Discord und im Webhook maskiert (standardmäßig aktiv).
- Ruhezeiten: Im gewählten Zeitraum gehen nur kritische Alarme hinaus; Warnungen warten bis zum Ende des Zeitraums.
- Zusammenfassung per E-Mail: deaktiviert, täglich oder jeden Montag zur gewählten Uhrzeit.

Pause
Die Schaltfläche Pausieren setzt die Benachrichtigungen für 30 Minuten, 2 Stunden, 8 Stunden oder 24 Stunden aus, zum Beispiel während eines Updates. Probleme werden weiter erkannt und gespeichert; die bei Ende der Pause noch offenen werden gemeldet.
Was das Modul erkennt
PHP-Fehler
Das Modul erfasst fatale Fehler und Warnungen (optional auch Notices und Deprecations) im Shop und, wenn die Option aktiv ist, im Backoffice. Identische Fehler werden zusammengefasst. Ein neuer fataler Fehler löst sofort einen kritischen Alarm aus; er läuft nach 24 Stunden ohne neues Auftreten still ab. Ein Spitzenalarm wird ab 100 Fehlern und Warnungen in 15 Minuten ausgelöst (einstellbar, 0 zum Deaktivieren). PrestaShop-Logs der Schwere 3 und 4 werden bei jedem Cron-Lauf importiert. Jeder Fehler erhält eine wahrscheinliche Ursache: Modul, Theme, Override, kompiliertes Template oder Core; tritt der Fehler im Core auf, wird das erste Modul im Aufrufstapel verwendet.
Antwortzeit
Die Antwortzeit wird bei echten Besuchen gemessen. Der Anteil gemessener Seiten reicht von 1 bis 100 %; jede gemessene Seite kostet einen Datenbank-Schreibvorgang. Ein Alarm wird ausgelöst, wenn das 95. Perzentil über 15 Minuten den Schwellenwert überschreitet (standardmäßig 3000 ms), ab 20 gemessenen Seiten, und er wird behoben, sobald das p95 wieder 10 % unter dem Schwellenwert liegt. Ein kritischer Alarm wird ausgelöst, wenn über 15 Minuten mehr als 5 % der Anfragen mit einem Serverfehler enden, mit mindestens 5 Fehlern.
Verfügbarkeit und überwachte Seiten
Bei jedem Server-Cron-Lauf lädt das Modul die Startseite und bis zu 5 Seiten Ihrer Wahl: eine Kategorie, ein Produkt, den Warenkorb, die Kontaktseite… Eine Seite ist erreichbar, wenn sie mit HTTP 2xx oder 3xx (nach höchstens 3 Weiterleitungen), 401 oder 429 antwortet. Sie ist ausgefallen, wenn sie nicht antwortet, mit 5xx oder einem anderen 4xx antwortet, den von Ihnen festgelegten erwarteten Text nicht enthält oder, bei der Startseite, leer ist. Nach 2 Fehlschlägen in Folge (einstellbar) öffnet sich ein kritischer Alarm. Im Wartungsmodus ist die Prüfung ausgesetzt.

Es werden nur Adressen auf den Domains Ihres Shops akzeptiert: Für diese Prüfung ruft das Modul nie eine andere Website auf. Mit Speichern und Seiten jetzt testen prüfen Sie sie sofort. Erreicht der Server seine eigene öffentliche Adresse nicht (manche Hoster, Docker, ein Proxy), tragen Sie unter Verbindungsadresse die lokale Adresse des Webservers ein, zum Beispiel 127.0.0.1:80: Seitenadresse und Host-Header bleiben gleich.
Zahlungen und Bestellungen
- Zahlungsfehler: Bestellungen, die in der letzten Stunde in einen der gewählten Status gewechselt sind, nach Zahlungsmodul (Schwellenwert standardmäßig 3). Die Prüfung läuft auch, sobald eine Bestellung ihren Status ändert, nachdem die Antwort gesendet wurde: Sie verlangsamt die Bestellung nie.
- Checkout-Konversion: Anteil der Warenkörbe, die den Zahlungsschritt erreicht haben und zu Bestellungen wurden, über ein 2-Stunden-Fenster, verglichen mit dem üblichen Anteil über 28 Tage. Sie beginnt nach etwa 40 Warenkörben Verlauf.
- Bestelleinbruch: Bestellungen der letzten 3 Stunden (einstellbar) verglichen mit demselben Zeitfenster der 4 Vorwochen. Entfällt, wenn weniger als 4 Bestellungen erwartet werden.
- Empfindlichkeit: niedrig, mittel (empfohlen) oder hoch.

Serverzustand
- SSL-Zertifikat: wird alle 6 Stunden gelesen. Warnung 14 Tage vor Ablauf (einstellbar), kritisch bei 3 Tagen.
- Speicherplatz: Warnung unter 2048 MB frei (einstellbar), kritisch unter einem Viertel dieses Werts.
- Cron-Überwachung: Sobald ein Server-Cron gelaufen ist, wird nach 30 Minuten ohne Lauf ein Alarm ausgelöst.

Alarme bearbeiten
Ein Problem öffnet einen einzigen Alarm, der aktualisiert wird, solange es besteht. Der Reiter Alarme zeigt eine 30-Tage-Bilanz (Alarme, kritische Alarme, durchschnittliche Behebungszeit, gesendete Nachrichten), den Verlauf mit der Dauer jedes Vorfalls und das Protokoll jeder Zustellung.

- Bestätigen: stoppt die Erinnerungen. Die Entwarnung wird trotzdem gesendet.
- Schließen: schließt den Alarm. Besteht das Problem weiter, öffnet sich bei der nächsten Prüfung ein neuer Alarm.

Vom Smartphone aus bestätigen
Jede Alarmbenachrichtigung enthält einen für diesen Alarm signierten Link Bestätigen und Erinnerungen stoppen. Er öffnet im Shop eine für Smartphones gestaltete Bestätigungsseite, und der Alarm wird erst nach Ihrer Bestätigung quittiert: Mail-Virenscanner, die Links öffnen, können ihn also nicht an Ihrer Stelle bestätigen.

Seite PHP-Fehler
Filtern Sie nach Schwere oder Ursache und suchen Sie nach einer Meldung, einer Datei oder einer Seite. Ein aufgeklappter Fehler zeigt Seite, Controller, Daten, vollständige Meldung und Aufrufstapel. Bericht für einen Entwickler kopieren kopiert einen Text mit den Versionen von PrestaShop und PHP, Datei, Ursache, Seite, Vorkommen, Meldung und Aufrufstapel. Stummschalten zählt den Fehler weiter, alarmiert aber nie wieder dazu.

Berechtigungen
Ein Mitarbeiter, dessen Profil auf Überwachung & Alarme nur das Recht Anzeigen hat, sieht alle Seiten schreibgeschützt: Felder sind deaktiviert, Aktionen (Starten, Pause, Bestätigen, Einstellungen) werden abgelehnt.
Daten und Datenschutz
- Seitenadressen werden ohne URL-Parameter gespeichert, der Aufrufstapel ohne Funktionsargumente.
- Serverpfad und Name des Admin-Ordners werden aus jedem gespeicherten oder gesendeten Text entfernt.
- Bot-Tokens und Webhook-Pfade werden im Benachrichtigungsprotokoll maskiert.
- Der Verlauf wird standardmäßig nach 30 Tagen gelöscht (7 bis 365 Tage), in kleinen Paketen; geschlossene Alarme bleiben mindestens 90 Tage erhalten.
Bekannte Grenzen
- Die Verfügbarkeitsprüfung läuft vom Server selbst aus: Einen externen Netzwerk- oder DNS-Ausfall sieht sie nicht. Der externe Heartbeat deckt diesen Fall ab.
- Ein fataler Fehler vor dem Laden der Module wird vom Fehlerhandler nicht erfasst; Verfügbarkeitsprüfung und 5xx-Rate melden ihn.
- Symfony-Seiten des Backoffice laufen nicht über den Hook, der Backoffice-Fehler erfasst.
- Die Checkout-Konversion beruht auf dem Hook
displayPaymentTop. Ruft Ihr One-Page-Checkout ihn nicht auf, deaktivieren Sie diese Prüfung: Der Bestelleinbruch bleibt aktiv.
Fehlerbehebung
Der E-Mail-Test schlägt fehl
Prüfen Sie die Konfiguration unter Erweiterte Einstellungen > E-Mail und senden Sie von dort einen Test. Der genaue Fehler wird nach dem Test und im Reiter Alarme angezeigt.
Die Startseite wird als ausgefallen angezeigt, obwohl der Shop läuft
Der Server erreicht vermutlich seine eigene öffentliche Adresse nicht. Füllen Sie Verbindungsadresse aus (zum Beispiel 127.0.0.1:80) und klicken Sie auf Speichern und Seiten jetzt testen.
„Kein Server-Cron erkannt“ bleibt stehen
Nur der Kommandozeilen-Cron und die Cron-URL zählen. Führen Sie den Befehl per SSH von Hand aus: Er gibt einen JSON-Bericht aus. Schlägt er fehl, klären Sie den Pfad von PHP CLI mit Ihrem Hoster.
Der Webhook-Test antwortet „Adresse abgelehnt“
Die URL zeigt ins private Netzwerk oder auf den Server selbst. Verwenden Sie eine öffentliche Adresse oder aktivieren Sie Webhook im privaten Netzwerk erlauben, wenn Ihr Tool im eigenen Netzwerk läuft.