Webinar: Shopware 5 End of Life am 18.04. um 16:00 Uhr
Jetzt anmelden!
Pickware Blog
Archiv
| 27.08.2019

Shopware Tipps & Tricks – Fehlerquellen mit Logdateien aufspüren

Fehler sind unvermeidbar. Daher können auch in Ihrem Shopware Shop Fehler entstehen, sei es aufgrund von Konflikten im Frontend, Plugin-Inkompatibilitäten, Dateninkonsistenzen oder Problemen mit dem Server. Doch häufig ist es schwierig, die Ursache des Fehlers exakt zu lokalisieren. Daher zeigen wir Ihnen in diesem Teil von Shopware Tipps & Tricks, wie Sie Fehler mithilfe der richtigen Logdateien eingrenzen können, um sie anschließend erfolgreich zu beheben.

Backend-Log

Wenn Sie vermuten, dass Fehler aufgrund von veränderten Einstellungen im Backend verursacht wurden, können Sie sämtliche Vorgänge im Backend-Log einsehen. Diesen finden Sie unter Einstellungen > Logfile im Tab Backend-Log. Die Einträge geben Auskunft, in welchen Modulen und von welchem Nutzer Änderungen im Backend vorgenommen wurden. In folgendem Beispiel wurde im Plugin Shopware WMS ein Pickprofil bearbeitet.

System-Log

Sowohl Shopware, als auch installierte Plugins legen Logdateien über Vorgänge und Probleme auf dem Server des Shops an. Diese befinden sich standardmäßig im Serververzeichnis /var/log/. Sie können die einzelnen Log-Dateien bequem über das Backend einsehen. Gehen Sie hierzu auf Einstellungen > Logfile und wechseln Sie in den Tab System-Log. Hier können Sie alle verfügbaren Dateien auswählen und einsehen. Die von Shopware angelegten Logs beginnen meist mit core_production_XXX, die Pickware Logs mit pickware_production-XXX. In diesem Beispiel enthält der Log einen häufiger auftretenden Fehler aufgrund eines abgelaufenen Tokens. Aber auch Template-Fehler werden hier hinterlegt.

Pickware API-Log

Sollten Sie Schwierigkeiten mit unseren Produkten Shopware WMS oder POS powered by Pickware haben, können Sie unseren Pickware API-Log unter Einstellungen > Logfile > API-Log aufrufen. Hier werden alle Vorgänge zwischen unseren Apps mit Shopware protokolliert. Fehlermeldungen werden dabei rot markiert. Mit einem Klick auf die Lupe lassen sich detaillierte Informationen für jeden Zugriff abrufen.

Im unteren Beispiel konnte in der Versand App von Shopware WMS das Versandetikett nicht gedruckt werden. Der Pickware API-Log verrät in der zugehörigen Fehlermeldung, dass das Etikett aufgrund einer falsch kodierten Kundenadresse nicht erstellt werden konnte.

PHP-Errorlog

In Ausnahmefällen kann es vorkommen, dass aufgrund von Fehlern Bereiche des Shops bzw. das Backend nicht mehr aufrufbar sind. Der Webserver liefert dann meist den Fehlercode 500 oder 503 zurück, welcher im Frontend nur die Nachricht Ups! Ein Fehler ist aufgetreten! generiert. Hier hilft ein Blick in die PHP Errorlogs Ihres Webservers. Dessen Verzeichnis hängt immer von Ihrer individuellen Serverkonfiguration ab, wenden Sie sich hierzu am besten an Ihren Hoster.

Wenn Sie Schwierigkeiten mit den Store Templates haben, diese aber nicht im System-Log angezeigt bekommen, können Sie in der PHP-Konfiguration Ihres Servers das erweiterte Error-Debugging aktivieren. Dann wird PHP Ihnen entsprechende Fehlermeldungen direkt im Frontend Ihres Shops anzeigen. Fügen Sie hierzu in der Datei config.php folgenden Code hinzu:

'front' => array(
  'showException' => true,
  'noErrorHandler' => false,
),

//Low-Level PHP-Fehler ab Shopware 5.2.0
'phpsettings' => [
    'display_errors' => 1,
]

Aber Achtung: Nutzen Sie dieses Feature nicht dauerhaft im Produktivbetrieb, da alle Ihre Kunden die Meldungen, und damit möglicherweise auch sensible Serverinformationen angezeigt bekommen.

Fazit

Fehler in Ihrem Shop sind immer ärgerlich, und deren Ursache zu finden, ist nicht immer einfach. Wir hoffen, dass wir Ihnen mit diesen Tipps bei der nächsten Eingrenzung helfen können. Sollten Sie Fragen zu unseren Pickware Produkten haben, zögern Sie nicht, uns zu kontaktieren. Wir helfen Ihnen gerne weiter.

Newsletter
Bleibe immer auf dem Laufenden
Jetzt anmelden
Teilen