Synchronisationsprotokolle

Das Plugin führt zwei sich ergänzende Protokolle, damit Sie die Frage „was ist eigentlich passiert?” beantworten können, ohne zu raten:

Sync Logs — eine Zeile pro Versuch, etwas zu tun (eine Produkt-Charge exportieren, Kategorien aktualisieren, Bestellungen importieren). Zeigt Ihnen, was versucht wurde, wie viele Elemente verarbeitet wurden und was fehlgeschlagen ist.
API Logs — eine Zeile pro Aufruf, der an den Marktplatz gesendet wurde. Enthält die vollständige Anfrage und Antwort, die Header, den Status und die Laufzeit. Das ist es, was Sie an den Support weitergeben, wenn der Marktplatz sagt „wir haben das nicht erhalten”.

Jede Zeile in Sync Logs verlinkt auf die API Logs-Einträge, die sie erzeugt hat, sodass Sie von „dieser Export ist fehlgeschlagen” zu der genauen Antwort gelangen, die der Marktplatz zurückgegeben hat.

Wo Sie die Listen finden

Öffnen Sie das Mirakl-Dashboard. Unter Quick Start finden Sie zwei Kacheln:

Logs — öffnet die Liste Sync Logs.
API Logs — öffnet die Liste API Logs.

Beide Listen lassen sich nach Connection, Type und nach Erfolg bzw. Stufe filtern und haben oben eine Schaltfläche Refresh.

Was eine Sync-Logs-Zeile aussagt

Die Liste zeigt diese Spalten:

Type — was die Zeile aufgezeichnet hat (zum Beispiel Offer sync, Stock sync, Order import, Product export, Product export batch, Product import status check, Product import item error, Order state sync, Offer delete).
Status — started, completed oder error.
Level — debug, info, success, warning oder error.
Connection — zu welchem Marktplatz die Zeile gehört.
Import / Product — Verlinkungen auf den marktplatzseitigen Import oder auf das betroffene Produkt, falls anwendbar.
Message — eine kurze, für Menschen lesbare Zusammenfassung, zum Beispiel „Import 123456: 47 lines, 0 errors”.
Processed / Failed — Zählwerte.
Started / Duration — wann der Lauf gestartet ist und wie lange er gedauert hat.

Klicken Sie in einer Zeile auf View Details, um die Seite Log Details mit zwei Reitern zu öffnen:

Overview — vollständige Nachricht, Kontextinformationen, Status und Zählwerte.
Related Logs — die API Logs-Einträge (die tatsächlichen Aufrufe), die dieser Lauf erzeugt hat, plus Verweise auf zugehörige Bestellungen, Importe und Produktimporte.

Wenn eine Zeile einen marktplatzseitigen Importauftrag aufzeichnet, führt der Link Import zur Liste Imports (Dashboard → Quick Start → Imports), wo Sie den Fortschritt und etwaige Zeilenfehler des Marktplatzes sehen können.

Wie Zeilen geschrieben werden

Zwei Muster erzeugen Zeilen:

Langlaufende Läufe (eine Charge wird hochgeladen, eine Aktualisierung, eine Importprüfung) schreiben die Zeile sofort mit Status started und aktualisieren sie am Ende:

Bei Erfolg wechselt die Zeile auf completed mit Stufe success, die Abschlusszeit und die finalen Zählwerte werden eingetragen.
Bei Fehlschlag wechselt die Zeile auf error mit Stufe error, und die Nachricht des Marktplatzes wird festgehalten.

Einmalige Ereignisse (eine einzelne kleine Sache wurde protokolliert) schreiben eine Zeile, die im Moment ihres Erscheinens bereits completed (oder error) ist.

In beiden Fällen prüft das Plugin die Zeile gegen Ihre ausgewählten Sync log levels (siehe unten), bevor sie behalten wird. Wenn Sie die Stufe abgewählt haben, auf der die Zeile landen würde, wird die Zeile nicht behalten — für einmalige Ereignisse heißt das, dass keine Zeile geschrieben wird, für langlaufende Läufe wird die Zeile am Ende des Laufs entfernt.

Praktisch ist der Effekt derselbe: die Liste enthält nur die Stufen, die Sie angefordert haben.

Auswählen, was protokolliert wird

Öffnen Sie Mirakl → Einstellungen → Optionen und sehen Sie sich die Karte Protokolle an. Drei Einstellungen steuern die Listen:

Sync-Protokollstufen — wählen Sie, welche Schweregrade behalten werden sollen: Debug, Info, Erfolg, Warnung, Fehler. Standardmäßig sind Info, Erfolg, Warnung und Fehler eingeschaltet und Debug ist aus. Wenn Sie nur Fehlschläge interessieren, deaktivieren Sie Erfolg — Sie sehen weiterhin Läufe in Arbeit (started) und Läufe, die fehlgeschlagen sind (error).
Synchronisierungsprotokoll-Aufbewahrung (Tage) — wie lange Zeilen in Sync Logs behalten werden. Standardwert ist 30 Tage. Ältere Zeilen werden einmal pro Tag entfernt.
API-Protokoll-Aufbewahrung (Tage) — wie lange Zeilen in API Logs behalten werden. Standardwert ist 30 Tage. Ältere Zeilen werden einmal pro Tag entfernt.

Das Abwählen aller Sync-Protokollstufen schaltet die Liste Sync Logs komplett ab. Das ist eine Einstellung nur zur Fehlersuche — produktiv sollte sie nicht laufen.