Sync logs

Plugin prowadzi dwa uzupełniające się dzienniki, dzięki którym możesz odpowiedzieć na pytanie „co się właściwie wydarzyło?” bez zgadywania:

• Sync Logs — jeden wiersz na każdą próbę wykonania jakiejś operacji (eksport partii produktów, odświeżenie kategorii, import zamówień). Pokazuje, co zostało spróbowane, ile elementów zostało przetworzonych i co się nie powiodło.
• API Logs — jeden wiersz na każde wywołanie wysłane do marketplace’u. Zawiera całe żądanie i odpowiedź, nagłówki, status i czas. To jest to, co przekazujesz do wsparcia technicznego, gdy marketplace mówi „nie otrzymaliśmy tego”.

Każdy wiersz w Sync Logs ma odnośnik do wpisów API Logs, które ten wiersz wygenerował, więc możesz przejść od „ten eksport nie powiódł się” do dokładnej odpowiedzi, którą zwrócił marketplace.

Gdzie znaleźć listy

Otwórz panel Mirakl Dashboard. W sekcji Quick Start znajdziesz dwa kafelki:

• Logs — otwiera listę Sync Logs.
• API Logs — otwiera listę API Logs.

Obie listy pozwalają filtrować po Connection, Type oraz po statusie sukcesu lub poziomie, i mają u góry przycisk Refresh.

Co mówi wiersz Sync Logs

Lista pokazuje następujące kolumny:

• Type — co zostało zapisane (na przykład 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 lub Error.
• Level — Debug, Info, Success, Warning lub Error.
• Connection — do którego marketplace’u należy wiersz.
• Import / Product — odnośniki do importu po stronie marketplace’u albo do produktu, którego dotyczy wiersz, jeśli ma to zastosowanie.
• Message — krótkie, czytelne podsumowanie, na przykład „Import 123456: 47 lines, 0 errors”.
• Processed / Failed — liczniki elementów.
• Started / Duration — kiedy uruchomienie się rozpoczęło i ile trwało.

Kliknij View Details w wierszu, aby otworzyć stronę Log Details z dwiema zakładkami:

• Overview — pełna treść komunikatu, informacje kontekstowe, status i liczniki.
• Related Logs — wpisy z API Logs (rzeczywiste wywołania), które to uruchomienie wygenerowało, plus odnośniki do powiązanych zamówień, importów i importów produktów.

Gdy wiersz dotyczy zadania importu po stronie marketplace’u, odnośnik Import prowadzi do listy Imports (Dashboard → Quick Start → Imports), gdzie widzisz jego postęp i ewentualne błędy poszczególnych linii, które zgłosił marketplace.

Jak powstają wiersze

Wiersze powstają w dwóch schematach:

Długo działające uruchomienia (przesyłanie partii, odświeżanie, sprawdzanie importu) zapisują wiersz od razu ze statusem Started, a po zakończeniu go aktualizują:

• W razie sukcesu wiersz zmienia się na Completed z poziomem Success, uzupełniany jest czas zakończenia i końcowe liczniki.
• W razie błędu wiersz przechodzi w Error z poziomem Error i zapisywana jest treść komunikatu od marketplace’u.

Pojedyncze zdarzenia (jedna drobna rzecz została zalogowana) zapisują pojedynczy wiersz, który już w momencie pojawienia się jest Completed (albo Error).

W obu przypadkach plugin sprawdza wiersz względem wybranych przez Ciebie poziomów Sync log levels (zobacz niżej), zanim go zachowa. Jeśli odznaczyłeś poziom, na którym wiersz miał wylądować, wiersz nie jest zachowywany — dla pojedynczych zdarzeń oznacza to, że wiersz w ogóle nie powstaje, a dla długo działających uruchomień wiersz jest usuwany pod koniec uruchomienia.

Efekt praktyczny jest taki sam: lista zawiera tylko te poziomy, o które poprosiłeś.

Wybór, co ma być logowane

Otwórz Mirakl → Settings → Options i znajdź kartę Logs. Listy kontrolują trzy ustawienia:

• Sync log levels — zaznacz, które poziomy ważności mają być zachowywane: Debug, Info, Success, Warning, Error. Domyślnie włączone są Info, Success, Warning i Error, a Debug jest wyłączony. Jeśli zależy Ci tylko na awariach, odznacz Success — nadal zobaczysz uruchomienia w trakcie (Started) i takie, które się nie powiodły (Error).
• Sync Log Retention (days) — jak długo przechowywać wiersze w Sync Logs. Domyślnie 30 dni. Starsze wiersze są usuwane raz dziennie.
• API Log Retention (days) — jak długo przechowywać wiersze w API Logs. Domyślnie 30 dni. Starsze wiersze są usuwane raz dziennie.

Odznaczenie wszystkich poziomów logów synchronizacji wyłącza listę Sync Logs w całości. To ustawienie przydaje się tylko do diagnostyki — nie zostawiaj go włączonego w produkcji.

Wskazówki i pułapki

Wskazówka

Dla sprzedawców z dużym wolumenem odznacz Success w Sync log levels i zmniejsz przechowywanie do 7–14 dni. Nadal widzisz uruchomienia w trakcie i te, które się nie powiodły — lista po prostu nie zapełnia się rutynowymi sukcesami.

Uwaga

Jeśli lista Sync Logs rośnie ponad ustawione okno przechowywania, codzienne zadanie czyszczące nie działa. Zajrzyj do Background tasks — bez działającego harmonogramu zadań po stronie hosta żadne zadanie czyszczące się nie uruchamia, a tabela rośnie bez końca.

Notatka

Jeśli wiersz pozostaje w stanie Started przez wiele godzin bez czasu zakończenia, oznacza to, że proces w tle padł w trakcie uruchomienia (brak pamięci, restart kontenera, zabity proces). Wiersz sam się nie zaktualizuje — otwórz zakładkę Related Logs i sprawdź powiązane wpisy w API Logs, żeby zobaczyć, jak daleko zaszło wywołanie marketplace’u.

Notatka

Sync Logs wiążą się z zamówieniami Shopware przez identyfikator. Jeśli usuniesz zamówienie, treść komunikatu pozostaje na liście, ale odnośnik do zamówienia będzie nieaktywny.

Powiązane tematy

• Background tasks — co zapisuje do logów oraz codzienne czyszczenie usuwające stare wiersze
• Troubleshooting — jak korzystać z logów, gdy coś poszło nie tak
• Reference → Enums — wszystkie wartości, które mogą pojawić się w kolumnach Status, Level i Type