Глава 7. Журнал приложения MySQL Shell

Эта секция объясняет журнал приложения.

7.1. Журнал приложения

MySQL Shell может быть настроен, чтобы произвести файл журнала приложения с информацией о проблемах разной серьезности. Можно использовать эту информацию, чтобы проверить состояние MySQL Shell в процессе работы.

Местоположение файла журнала это пользовательский путь конфигурации, файл называется mysqlsh.log.

По умолчанию регистрация отключена. Чтобы позволить регистрировать, надо применить параметр командной строки --log-level , когда MySQL Shell запускается, использовать любую команду \option или объект shell.options, чтобы установить параметр конфигурации MySQL Shell logLevel. Если выбор не установлен в командной строке или в конфигурационном файле, или если вы определяете уровень 1 или none, регистрация отключена. Все другие значения позволяют регистрироваться и устанавливают уровень детализации в регистрации следующим образом:

Регистрация: числовой уровень Регистрация: текст Значение

1

none

Ни один, по умолчанию

2

internal

Внутренняя ошибка

3

error

Ошибка

4

warning

Предупреждение

5

info

Информационный

6

debug

Отладка

7

debug2

Отладка2

8

debug3

Отладка3

С опцией --log-level можно определить уровень, используя его текстовое название или числовой эквивалент, таким образом, следующие примеры имеют тот же самый эффект:

shell> mysqlsh --log-level=4
shell> mysqlsh --log-level=warning

С опцией logLevel можно определить только числовой уровень.

Если вы предварительно определили уровень с @ (знак at), записи в журнале произведены к дополнительному видимому местоположению, а также написаны в файл журнала MySQL Shell. Следующие примеры имеют тот же самый эффект:

shell> mysqlsh --log-level=@8
shell> mysqlsh --log-level=@debug3

На системах Unix записи в журнале произведены в stderr в выходном формате, который в настоящее время устанавливается для MySQL Shell. Это значение опции resultFormat, если обертывание JSON не было активировано запуском MySQL Shell с опцией --json.

В Windows записи в журнале печатаются, используя функцию OutputDebugString(), вывод которой может быть рассмотрен в прикладном отладчике, системном отладчике или инструменте захвата для вывода отладки.

Формат файла журнала MySQL Shell это простой текст, записи содержат метку времени и описание проблемы, наряду с уровнем регистрации из вышеупомянутого списка. Например:

2016-04-05 22:23:01: Error: Default Domain: (shell):1:8: MySQLError: You have an error
in your SQL syntax; check the manual that corresponds to your MySQL server version for
the right syntax to use near '' at line 1 (1064) in session.sql("select * from t
limit").execute().all();

Пользовательский путь конфигурации по умолчанию может быть отвергнут на всех платформах, определив переменную окружения MYSQLSH_USER_CONFIG_HOME. Значение этой переменной заменяет %AppData%\MySQL\mysqlsh\ в Windows или ~/.mysqlsh/ в Unix.

Местоположение файла журнала в Windows

В Windows путь по умолчанию к файлу журнала %APPDATA%\MySQL\mysqlsh\mysqlsh.log.

Чтобы найти местоположение %APPDATA% в Вашей системе, введите:

C:>echo %APPDATA%

C:\Users\exampleuser\AppData\Roaming

В Windows это папка %APPDATA%, определенная для пользователя, с добавкой MySQL\mysqlsh. Используя вышеупомянутый пример, путь был бы C:\Users\exampleuser\AppData\Roaming\MySQL\mysqlsh\mysqlsh.log.

Местоположение файла журнала в Unix

Для Unix путь по умолчанию ~/.mysqlsh/mysqlsh.log, где ~ представляет корневой каталог пользователя. Переменная окружения HOME также представляет корневой каталог пользователя. Добавление .mysqlsh к корневому каталогу пользователя определяет путь по умолчанию к журналу.