Protokolování a diagnostika

Editor si vede protokol o tom, co dělá. Protokol se hodí, když se něco pokazí — můžete zvýšit jeho podrobnost a přiložit jej k hlášení chyby.

Kde protokol leží

Průběžný soubor protokolu se zapisuje do vaší uživatelské složky s diagnostikou:

• 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

Soubor se s růstem rotuje (mte.log, pak mte.log.1, mte.log.2, …), takže neroste donekonečna. Pokud editor spadne, nejnovější řádky protokolu se automaticky přiloží k hlášení o pádu.

Změna podrobnosti protokolu

Ve výchozím stavu protokol zaznamenává informační zprávy a závažnější. Chcete-li zachytit víc podrobností — třeba při reprodukci problému — zvyšte úroveň na debug nebo trace.

• Pro jediný běh spusťte editor s úrovní na příkazové řádce:

  OctoEdit --log=debug
  

• Trvale nastavte log/level v konfiguračním souboru (umístění souboru a všechny klíče najdete v referenci konfigurace). Můžete tam také soubor protokolu vypnout, změnit jeho velikost nebo formát řádků.

Přiložení protokolu k hlášení chyby

Zreprodukujte problém s --log=debug a pak přiložte soubor mte.log z výše uvedené složky. Pozor, řádky protokolu mohou obsahovat cesty k souborům z vašeho stroje; než jej budete sdílet, projděte si jej.

Ladicí příznaky

Malou sadu vývojářských a diagnostických přepínačů lze zapnout v sekci [debug] konfiguračního souboru — například pro zaznamenání každého signálu o změně souboru nebo doby, kterou zabere načtení zásuvných modulů. V Předvolbách se nikdy neobjeví. Rozpoznávané příznaky a jejich aktuální hodnoty zobrazíte takto:

OctoEdit --list-debug-flags

Další podrobnosti

Úplný seznam klíčů protokolování, ladicích příznaků, voleb příkazové řádky a proměnných prostředí je v referenci CONFIGURATION.md v projektu.