Journalisation & diagnostics¶

L'éditeur tient un journal de son activité. Ce journal est utile quand quelque chose tourne mal — vous pouvez augmenter son niveau de détail et le joindre à un rapport de bogue.

Où se trouve le journal¶

Un fichier journal rotatif est écrit dans votre dossier de diagnostics :

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

Le fichier tourne à mesure qu'il grossit (mte.log, puis mte.log.1, mte.log.2, …), il ne grandit donc jamais sans limite. Si l'éditeur plante, les lignes les plus récentes du journal sont automatiquement incluses dans le rapport de plantage.

Modifier le niveau de journalisation¶

Par défaut, le journal enregistre les messages d'information et au-dessus. Pour capturer plus de détails — par exemple en reproduisant un problème — montez le niveau à debug ou trace.

Pour une seule exécution, lancez l'éditeur avec un niveau en ligne de commande :
```
OctoEdit --log=debug
```
De façon persistante, définissez log/level dans le fichier de configuration (voir la référence de configuration pour l'emplacement du fichier et toutes les clés). Vous pouvez aussi y désactiver le fichier journal, changer sa taille ou le format des lignes.

Joindre un journal à un rapport de bogue

Reproduisez le problème avec --log=debug, puis joignez le fichier mte.log du dossier ci-dessus. Notez que les lignes du journal peuvent contenir des chemins de fichiers de votre machine ; relisez le fichier avant de le partager.

Drapeaux de débogage¶

Un petit ensemble de commutateurs développeur/diagnostic peut être activé dans la section [debug] du fichier de configuration — par exemple pour journaliser chaque signal de changement de fichier, ou le temps de chargement des extensions. Ils n'apparaissent jamais dans les Préférences. Pour voir les drapeaux reconnus et leurs valeurs actuelles :

OctoEdit --list-debug-flags

Plus de détails¶

La liste complète des clés de journalisation, drapeaux de débogage, options de ligne de commande et variables d'environnement se trouve dans la référence CONFIGURATION.md du projet.