Registrazione e diagnostica¶

L'editor tiene un registro di ciò che sta facendo. Il log è utile quando qualcosa va storto: puoi alzarne il livello di dettaglio e allegarlo a una segnalazione di errore.

Dove vive il log¶

Un file di log a rotazione viene scritto nella tua cartella di diagnostica per utente:

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

Il file ruota man mano che cresce (mte.log, poi mte.log.1, mte.log.2, …), così non cresce mai senza limite. Se l'editor si arresta in modo anomalo, le righe di log più recenti vengono incluse automaticamente nella segnalazione.

Cambiare quanto viene registrato¶

Per impostazione predefinita il log registra i messaggi informativi e superiori. Per catturare più dettaglio —ad esempio mentre riproduci un problema— alza il livello a debug o trace.

Per una singola esecuzione, avvia l'editor con un livello sulla riga di comando:
```
OctoEdit --log=debug
```
In modo permanente, imposta log/level nel file di configurazione (vedi il Riferimento di configurazione per la posizione del file e per tutte le chiavi). Lì puoi anche disattivare il file di log, cambiarne la dimensione o cambiare il formato delle righe.

Allegare un log a una segnalazione di errore

Riproduci il problema con --log=debug, poi allega il file mte.log dalla cartella qui sopra. Nota che le righe di log possono contenere percorsi di file della tua macchina; controlla il file prima di condividerlo.

Flag di debug¶

Un piccolo insieme di interruttori di sviluppo e diagnostica si può attivare nella sezione [debug] del file di configurazione — ad esempio per registrare ogni segnale di modifica dei file, o il tempo che i plugin impiegano a caricarsi. Non compaiono mai nelle Preferenze. Per vedere i flag riconosciuti e i loro valori attuali:

OctoEdit --list-debug-flags

Maggiori dettagli¶

L'elenco completo delle chiavi di log, dei flag di debug, delle opzioni di riga di comando e delle variabili d'ambiente si trova nel riferimento CONFIGURATION.md del progetto.