"LogLevel": консольна команда MyChat Client для керування режимами протоколювання
MyChat Client має кілька режимів протоколювання роботи, вони сумісні зі стандартом SysLog. Після перезапуску програми автоматично встановлюється стандартний режим протоколювання (info = 4).
Синтаксис
LogLevel <type>
Параметри
Усі рівні подій поділяються на 6 категорій, від 1 до 6, кожен має текстове скорочення.
Наприклад, якщо ви увімкнете рівень WARN, то в протокол потраплятимуть лише події рівнів 1, 2 та 3, а все, що більше – ні.
Два останні режими призначені для налагодження режимів і можуть генерувати досить багато тексту.
|
Параметр |
Опис |
|
fatal або 1 |
будь-яка помилка, яка призводить до закриття служби або програми для запобігання втраті даних (або подальшої втрати даних). Це найважчі помилки та ситуації, коли гарантовано пошкодження або втрата даних; |
|
error або 2 |
будь-яка помилка, яка є фатальною для операції, але не для служби або програми (не вдається відкрити потрібний файл, відсутні дані, вказано неправильний пароль тощо). Ці помилки вимагають втручання адміністратора або користувача, але не призводять до фатальних збоїв; |
|
warn або 3 |
все, що потенційно може викликати дивну поведінку програми, але які програма автоматично усуває або може продовжувати роботу далі без фатальних помилок (наприклад, переключення з основного на резервний сервер, повторна спроба операції, відсутність додаткових даних тощо); |
|
info або 4 |
корисна інформація для роботи. Інформація, яку завжди корисно мати під рукою, але на яку не звертають уваги у звичайних обставинах. Це стандартний рівень протоколювання; |
|
debug або 5 |
розширена діагностика (IT персонал, системні адміністратори тощо); |
|
trace або 6 |
"трасування", для детального глибокого налагодження, протоколювання мережного трафіку, логів буде дуже багато; |
|
пустий рядок |
показати поточний режим протоколювання. |
Результат
Логи відображаються в інтерфейсі MyChat Client, їх можна побачити в консолі (Ctrl+` або через головне меню "Інструменти", "Консоль").
Текстовий варіант у форматі UTF8 пишеться у файл до папки протоколів за вказану дату, наприклад, "%USERPROFILE%\MyChat Client\logs\2023\07\14\mcserv.log". Враховуйте, що цей файл може не створюватися, якщо в налаштуваннях програми вимкнено збереження протоколів з міркувань безпеки, наприклад.
Якщо увімкнено рівень протоколювання 5 або 6, то текстовий протокол у файл пишеться розширений timestamp, включаючи мілісекунди.
Щоб відкрити папку з логами у Провіднику, використовуйте консольну команду "Logs".
Приклад
[16:38:39] loglevel trace
[16:38:39] Рівень протоколювання: TRACE
[16:38:42] [TRACE] Input traffic (raw): 802200{"UIN":29051,"State":0}
[16:38:42] [TRACE] Input traffic (raw): 802200{"UIN":29051,"State":0}
[16:38:42] [TRACE] Input traffic (unpacked): {"UIN":29051,"State":0}
[16:38:47] [DEBUG] 000C{"Ticks":334874484}
[16:38:47] [TRACE] Output traffic (unpacked): 000C10{"Ticks":334874484}
[16:38:47] [DEBUG] message sent to server
[16:38:47] ping
[16:38:47] [TRACE] Input traffic (raw): 800F10{"Ticks":334874484}
[16:38:47] [TRACE] Input traffic (raw): 800F10{"Ticks":334874484}
[16:38:47] [TRACE] Input traffic (unpacked): {"Ticks":334874484}
[16:38:47] PONG! (125 мс)
[16:39:14] loglevel info
[16:39:14] Рівень протоколювання: INFO