Fehlersuche

  • Aktualisiert

Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Shopware.

Dieses Kapitel beschreibt, wie Sie als Nutzer von Shopware als E-Commerce Plattform in Verbindung mit Optimizely Campaign mit Fehlfunktionen umgehen können. Erfahren Sie mehr über häufige Fehlerquellen, die bei der Konfiguration und im Betrieb der Shopware-Integration auftreten können und wie Sie die Protokollierung von Ereignissen und ausgeführten Aufgaben starten, um den Betrieb zu überwachen und bei Problemen die Fehlerquelle ausfindig zu machen.

Probleme bei der Einrichtung

Wenn bei der Installation, der Konfiguration und im Betrieb Probleme auftreten, die Sie nicht beseitigen können, wenden Sie sich an die Kundenbetreuung.

Häufige Fehlerquellen

Fehler mögliche Ursache Lösung
Kunden können sich nicht zum Newsletter anmelden. Die Firewall des Shop-Systems blockiert den Verbindungsaufbau zu Optimizely Campaign. Überprüfen Sie die Netzwerkkonfiguration des Shop-Systems.
Der Autorisierungs-Code der Empfängerliste ist ungültig. Überprüfen Sie den Autorisierungs-Code der Empfängerliste und erstellen Sie ggf. einen neuen Autorisierungs-Code.
Die Opt-In-ID ist ungültig. Überprüfen und korrigieren Sie die Opt-In-ID.
Der Katalog-Export schlägt fehl. Die Firewall des Shop-Systems blockiert den Verbindungsaufbau zu Optimizely Campaign. Überprüfen Sie die Netzwerkkonfiguration des Shop-Systems.
Der private SSH-Schlüssel wurde unvollständig oder fehlerhaft hinterlegt. Geben Sie den SSH-Schlüssel erneut ein.
Das Passwort des privaten SSH-Schlüssels wurde unvollständig oder fehlerhaft hinterlegt. Geben Sie das Passwort des privaten SSH-Schlüssels erneut ein.

Protokollierung

Die Shopware-Integration enthält eine Funktion zur Protokollierung von Ereignissen und ausgeführten Aufgaben, wie beispielsweise die Protokollierung des Katalog-Exports. Mithilfe der Protokolldateien können Sie bei Problemen mit der Shopware-Integration die entsprechenden Fehlerquellen ausfindig machen. Die Protokollierung steuern Sie über einen Cronjob, den Sie in Ihrem Shopware-System aktivieren müssen.

Protokollierung konfigurieren

Um den Cronjob für die Protokollierung zu konfigurieren, führen Sie die folgenden Schritte aus:

  1. Melden Sie sich mit Administrator-Rechten im Backend von Shopware an.
  2. Wählen Sie in der Menüleiste Einstellungen > Grundeinstellungen.

    Bild: Grundeinstellungen

  3. Wählen Sie System > Cronjobs.

    Bild: Cronjobs auswählen

  4. Finden Sie in der Liste den Cronjob Optivo ErrorHandler und klicken Sie auf Bearbeiten .

    Bild: Cronjob suchen und bearbeiten

  5. Aktivieren Sie das Kontrollkästchen neben Aktiv.

    Bild: Cronjob aktivieren

  6. Wählen Sie in der Drop-down-Liste Intervall ein Zeitintervall für den Cronjob aus. Mit dem Zeitintervall legen Sie fest, in welchen zeitlichen Abständen einzelne Protokolleinträge zusammengefasst werden.

    Bild: Zeitintervall auswählen

  7. Klicken Sie auf Speichern.
  8. Um den Cronjob zu aktivieren und die Protokollierung zu starten, rufen Sie die URL auf. In der Regel lautet die URL http://<URL Ihres Shops>/backend/cron

    In der Liste der Cronjobs sehen Sie den Eintrag Processing Optivo ErrorHandler (wenn der Job aufgrund seiner Intervall-Einstellungen ausgeführt wird).

Protokollierung im Backend-Log

  1. Wählen Sie Einstellungen > Logfile.

    Bild: Logfile im Einstellungsmenü

  2. Entnehmen Sie der Liste die protokollierten Ereignisse der Shopware-Integration. Um die Details eines Eintrag einzusehen, klicken Sie auf das Lupen-Symbol in der Spalte Optionen. Einträge, die die Shopware-Integration in die Liste geschrieben hat, erkennen Sie an dem Namen optivobroadmail in der Spalte Benutzer.

    Bild: Lupensymbol

Protokolldateien im System-Log

Die Shopware-Integration schreibt ihre Meldungen in den Kanal broadmail im Reiter System-Log. Sie finden dort die aktuellsten, noch nicht durch den Cronjob archivierten Einträge.

Bild: Reiter System-Log

Um die Details einer Meldung anzuzeigen, klicken Sie auf das Lupensymbol.

Beispiel: Die folgende Nachricht weist darauf hin, dass der Produktexport gestartet wurde. Die Ausführung schlug allerdings fehl, weil keine Benutzerkennung in den Einstellungen der Shopware-Integration eingegeben wurde.

CronJobsSubscriber::onOptivoProductExport: missing export sftp username

Wenn Sie die archivierten Einträge anzeigen möchten, öffnen Sie die Drop-down-Liste links neben Download. Wenn Sie eine Protokolldatei auf Ihrem Rechner zu speichern, klicken Sie auf Download.

Wenn Sie Fehlermeldungen der Programmiersprache PHP bei der Nutzung der Shopware-Integration erhalten, senden Sie die Fehlermeldungen mit einem Screenshot und einer Beschreibung des Vorgangs, bei dem das Problem aufgetreten ist, an die Optimizely Kundenbetreuung. Eventuell muss ein Entwickler/Administrator Ihres Shopware-Systems die exakten Fehlermeldungen der Protokolldatei des Linux-Systems auslesen und an Optimizely weiterleiten.