Fehlersuche
Note
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:
- Melden Sie sich mit Administrator-Rechten im Backend von Shopware an.
- Wählen Sie in der Menüleiste Einstellungen > Grundeinstellungen.
- Wählen Sie System > Cronjobs.
- Finden Sie in der Liste den Cronjob Optivo ErrorHandler und klicken Sie auf Bearbeiten .
- Aktivieren Sie das Kontrollkästchen neben Aktiv.
- 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.
- Klicken Sie auf Speichern.
- 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
Note
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
- Wählen Sie Einstellungen > Logfile.
- 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.
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.
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 usernameWenn 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.
Note
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.