Die Message Queue in Shopware 6 sorgt dafür, dass viele Aufgaben im Hintergrund ausgeführt werden – zum Beispiel E-Mail-Versand, Import/Export von Daten oder auch Pickware-Prozesse. Wenn sie nicht richtig funktioniert, bleiben diese Aufgaben hängen, und dein Shop reagiert träge oder fehlerhaft. Eine funktionierende Queue ist daher absolut notwendig, damit dein Shop und auch Pickware reibungslos arbeiten. Ein umfassenderes Tutorial zur Message Queue direkt von Shopware findest du hier.
Woran erkenne ich, dass meine Message Queue nicht richtig arbeitet?
Es gibt einige typische Anzeichen, die vermuten lassen, dass etwas mit deiner Message Queue nicht stimmt:
-
Import- und Exportfunktionen wie der DATEV-Dokumentenexport oder der Import von Lieferantenbestellungen funktionieren nicht
Da diese Funktionen immer über die Message Queue laufen, sind sie eines der häufigsten Symptome
Pickware-Prozesse werden nicht oder nur stark verzögert abgeschlossen
Bestellungen oder Lagerbestände aktualisieren sich nicht
In der Shopware Administration bleiben Aufgaben dauerhaft im Status offen
Einige Shopware- und Pickware-Aufgaben werden regelmäßig über sogenannte Scheduled Tasks gestartet. Diese Aufgaben werden dann ebenfalls über die Message Queue abgearbeitet – funktioniert die Queue nicht, werden auch diese Tasks nicht ausgeführt. Wenn diese Abläufe also nicht mehr wie gewohnt funktionieren, liegt die Ursache häufig an einer nicht laufenden Message Queue.
Wie prüfe ich den Status meiner Message Queue?
Wenn eines oder mehrere dieser Symptome auftreten, solltest du zunächst den Status deiner Message Queue überprüfen. Hierfür hast du folgende Möglichkeiten:
Prüfung über Frosh Tools
Wir empfehlen zur Prüfung das kostenlose Plugin Frosh Tools von Friends of Shopware. An der Ampel oben links in deiner Shopware-Administration kannst du live, schnell und ohne Umwege erkennen, ob Probleme bestehen.
Darüber hinaus kannst du auch im Bereich Warteschlangen-Manager in Echtzeit prüfen, wie genau deine Nachrichten verarbeitet werden.
Hier kannst du (neben anderen Funktionen) den Status deiner Message Queue detailliert einsehen und auslesen, wieviel Verzögerung besteht und ob Nachrichten in der Queue hängen bleiben.
Prüfung über die Shopware Admin
Auch die Shopware-Admin selbst bietet über Einstellungen → Nachrichtenwarteschlangen-Statistiken die Möglichkeit, dir eine Übersicht über deine Message Queue zu geben, verarbeitete Nachrichten protokolliert.
Was kann ich tun?
Wenn deine Queue nicht arbeitet, liegt das in der Regel daran, dass kein aktiver Worker-Prozess läuft.
Bitte wende dich an deinen Hostinganbieter oder Administrator und bitte darum, den CLI Worker dauerhaft einzurichten. Dieser verarbeitet die Queue unabhängig von der Shopware-Administration und sorgt dafür, dass alle Pickware- und Shopware-Aufgaben korrekt abgearbeitet werden.
Anleitungen dazu findest du in der offiziellen Shopware-Dokumentation: Message Queue und Scheduled Tasks Einige Hostinganbieter stellen hier auch eigene Schritt-für-Schritt-Anleitungen bereit:
Noch detailliertere technische Informationen zur Message Queue findest du in der Shopware-Dokumentation für Entwickler.