Tryb debug — szczegółowe logi do diagnozy błędu dokumentu

Gdy jakiś dokument nie chce się wystawić, tryb debug zapisuje w logach komplet danych zamówienia — i to, co przyszło ze sklepu, i to, co z tego powstało przed wysłaniem do Subiekta. Dzięki temu widać, na czym dokument się wywraca. Zasada jest prosta: włącz, odtwórz problem, wyłącz. Dotyczy obu wariantów — NEXO i GT.

1. Kiedy warto włączyć

   Włącz tryb debug, gdy:

   • konkretne zamówienie, faktura lub paragon nie chce się wystawić i komunikat błędu nic Ci nie mówi,
   • poprosi o to serwisant AppsBusters przy zgłoszeniu.

   Na co dzień trzymaj go wyłączonego — normalne logi w zupełności wystarczają do bieżącej pracy.

2. Włącz przełącznik w konfiguracji

   Wejdź w Konfigurację i rozwiń sekcję Zdalna pomoc. Na dole znajdziesz przełącznik „Zapisuj szczegółowe logi diagnostyczne (debug)” — włącz go.

   Następnie kliknij Zapisz zmiany i potwierdź. Aplikacja zrestartuje się sama — to normalne, tryb debug zaczyna działać dopiero po restarcie.

   

   Konfiguracja → Zdalna pomoc → przełącznik trybu debug.

3. Przeczytaj ostrzeżenie

   Po włączeniu zobaczysz żółte ostrzeżenie — nie ignoruj go. W trybie debug:

   • baza logów rośnie dużo szybciej niż zwykle i zajmuje więcej miejsca na dysku,
   • starsze wpisy zaczynają znikać wcześniej (sprzątanie logów kasuje najstarsze po przekroczeniu limitu, który ustawiasz w Panel → Logi),
   • w zapisanych danych są dane osobowe Twoich klientów — imię, nazwisko, adres, telefon, e-mail, NIP.

   Dlatego tryb debug nie jest ustawieniem „na stałe”.

   

   Ostrzeżenie widoczne, dopóki tryb debug jest włączony.

4. Odtwórz problem

   Powtórz dokładnie tę czynność, która się nie udaje — np. zmień status zamówienia tak, żeby aplikacja spróbowała jeszcze raz wystawić dokument. Zapis powstaje w chwili przetwarzania, więc dokumenty sprzed włączenia trybu debug nie mają szczegółów.

5. Zajrzyj do logów

   Wejdź w Panel → Logi i znajdź wpisy z numerem swojego zamówienia. Obok zwykłych komunikatów zobaczysz szczegółowy zapis danych dokumentu.

   Jak filtrować i czytać logi opisuje Logi aplikacji — gdzie szukać i jak czytać.

   Jeśli diagnozę prowadzi serwisant, wystarczy że włączysz mu zdalną pomoc — resztę zrobi sam.

6. Wyłącz, gdy skończysz

   Wróć do Konfiguracja → Zdalna pomoc, wyłącz przełącznik i zapisz. Żółte ostrzeżenie zniknie, a aplikacja wróci do normalnego zapisu logów.

   Jeśli nie pamiętasz, co dokładnie zmieniałeś przy okazji diagnozy — zajrzyj do Historii zmian ustawień i cofnij zmiany jednym kliknięciem.

7. Sprawdź również

   • Logi aplikacji — gdzie szukać i jak czytać — jak filtrować wpisy i ustawić, jak długo logi są przechowywane.
   • Zdalna pomoc serwisowa — jak wpuścić serwisanta, żeby sam obejrzał logi.
   • Historia zmian ustawień — podgląd i cofanie zmian w konfiguracji.