Logowanie i diagnostyka

Edytor prowadzi log tego, co robi. Log przydaje się, gdy coś idzie nie tak — możesz zwiększyć jego szczegółowość i dołączyć go do zgłoszenia błędu.

Gdzie jest log

Rotowany plik logu zapisywany jest w Twoim folderze diagnostycznym:

• Windows: %LOCALAPPDATA%\7-bits\OctoEdit\Diagnostics\log\mte.log
• Linux: ~/.local/share/7-bits/OctoEdit/Diagnostics/log/mte.log
• macOS: ~/Library/Application Support/7-bits/OctoEdit/Diagnostics/log/mte.log

Plik rotuje w miarę wzrostu (mte.log, potem mte.log.1, mte.log.2, …), więc nigdy nie rośnie bez ograniczeń. Jeśli edytor się zawiesi, najnowsze linie logu trafiają automatycznie do raportu o awarii.

Zmiana szczegółowości logowania

Domyślnie log rejestruje komunikaty informacyjne i ważniejsze. Aby przechwycić więcej szczegółów — np. podczas odtwarzania problemu — podnieś poziom do debug lub trace.

• Na jedno uruchomienie — wystartuj edytor z poziomem w wierszu poleceń:

  OctoEdit --log=debug
  

• Na stałe — ustaw log/level w pliku konfiguracyjnym (lokalizację pliku i wszystkie klucze znajdziesz w dokumentacji konfiguracji). Możesz tam też wyłączyć plik logu, zmienić jego rozmiar albo format linii.

Dołączanie logu do zgłoszenia błędu

Odtwórz problem z --log=debug, a następnie dołącz plik mte.log z powyższego folderu. Pamiętaj, że linie logu mogą zawierać ścieżki plików z Twojego komputera; przejrzyj plik przed udostępnieniem.

Flagi debugowania

Niewielki zestaw przełączników deweloperskich/diagnostycznych można włączyć w sekcji [debug] pliku konfiguracyjnego — np. logowanie każdego sygnału zmiany pliku albo czasu ładowania wtyczek. Nigdy nie pojawiają się w Preferencjach. Aby zobaczyć rozpoznawane flagi i ich bieżące wartości:

OctoEdit --list-debug-flags

Więcej informacji

Pełna lista kluczy logowania, flag debugowania, opcji wiersza poleceń i zmiennych środowiskowych znajduje się w projekcie, w dokumencie CONFIGURATION.md.