Logs & Debug-Modus

Wenn eine Formel nicht das erwartete Ergebnis liefert oder ein Fehler auftritt, musst du nicht raten: Der Konfigurator protokolliert Fehler und — auf Wunsch — ganze Berechnungskontexte.

Fehlerprotokoll pro Konfiguration

Jede Konfiguration hat einen Tab Fehlerprotokoll. Dort findest du alle protokollierten Meldungen dieser Konfiguration — z.B. fehlgeschlagene Formeln, bei denen der Fallback-Wert gegriffen hat:

• Die Einträge zeigen Zeitpunkt, Level und Nachricht; über den Level-Filter und die Suche grenzt du die Liste ein.
• Zusammengehörige Einträge sind zu Prozessen gruppiert — so siehst du alle Meldungen eines Warenkorb- oder Seitenaufrufs im Zusammenhang.
• Zu Berechnungs-Meldungen kannst du den kompletten Berechnungskontext öffnen: alle Variablenwerte (Felder, Produkt, Mengen), mit denen die Formel ausgewertet wurde — das schnellste Mittel, um Formelfehler zu finden.
• Mit „Protokoll leeren" startest du frisch, mit „Neu laden" aktualisierst du die Liste.

Debug-Logging

Mit dem Schalter „Debug-Logging aktivieren" (im Tab Fehlerprotokoll oder in den Einstellungen der Konfiguration) wird zusätzlich der Berechnungskontext während der Warenkorbverarbeitung protokolliert. Aktiviere das gezielt zum Einrichten oder zur Fehlersuche.

Der Schalter steuert auch, ob Fehler aus dem Storefront-JavaScript (z.B. eine fehlerhafte Formel beim Konfigurieren auf der Produktseite) im Fehlerprotokoll landen: Nur bei aktivem Debug-Logging wird ein Protokoll-Eintrag angelegt. In die Shopware-Protokolldatei werden diese Fehler unabhängig davon immer geschrieben, gehen also nicht verloren.

hinweis

Lass das Debug-Logging im Regelbetrieb ausgeschaltet — es schreibt bei jedem Warenkorb-Aufruf umfangreiche Daten ins Protokoll.

Debug-Modus auf der Produktseite

In den Einstellungen der Konfiguration gibt es den Schalter „Debug-Modus aktivieren": Damit werden Debug-Informationen direkt auf der Produktseite ausgegeben — praktisch, um beim Einrichten live zu sehen, welche Werte und Zwischenergebnisse der Konfigurator berechnet.

Shopware-Protokolle

Unter Kataloge > neonlines Konfigurator gibt es zusätzlich den Bereich Shopware Protokolle: Dort wählst du eine Protokolldatei des Shops aus und durchsuchst die Einträge nach Level und Stichwort — hilfreich bei Server-Fehlern, ohne dass du dafür auf den Server musst (siehe auch Fehlerbehebung & FAQs).