Registro e diagnóstico¶
O editor mantém um registro do que está fazendo. O log é útil quando algo dá errado — você pode aumentar o nível de detalhe dele e anexá-lo a um relatório de erro.
Onde fica o log¶
Um arquivo de log rotativo é gravado na sua pasta de diagnóstico por usuário:
- 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
O arquivo rotaciona à medida que cresce (mte.log, depois mte.log.1,
mte.log.2, …), então nunca cresce sem limite. Se o editor falhar, as linhas de
log mais recentes são incluídas automaticamente no relatório de falhas.
Alterando quanto é registrado¶
Por padrão o log registra mensagens informativas e acima. Para capturar mais
detalhe — por exemplo, enquanto reproduz um problema — aumente o nível para
debug ou trace.
-
Para uma única execução, inicie o editor com um nível na linha de comando:
-
De forma permanente, defina
log/levelno arquivo de configuração (veja a Referência de configuração para saber onde fica o arquivo e quais são todas as chaves). Ali você também pode desligar o arquivo de log, mudar o tamanho dele ou mudar o formato das linhas.
Anexando um log a um relatório de erro
Reproduza o problema com --log=debug e depois anexe o arquivo mte.log da
pasta acima. Observe que as linhas de log podem conter caminhos de arquivos da
sua máquina; revise o arquivo antes de compartilhá-lo.
Sinalizadores de depuração¶
Um pequeno conjunto de chaves de desenvolvimento e diagnóstico pode ser ativado na
seção [debug] do arquivo de configuração — por exemplo, para registrar cada
sinal de alteração de arquivo, ou o tempo que os plugins levam para carregar. Eles
nunca aparecem nas Preferências. Para ver os sinalizadores reconhecidos e seus
valores atuais:
Mais detalhes¶
A lista completa de chaves de log, sinalizadores de depuração, opções de linha de
comando e variáveis de ambiente está na referência CONFIGURATION.md do projeto.