Эта секция объясняет журнал приложения.
MySQL Shell может быть настроен, чтобы произвести файл журнала приложения с информацией о проблемах разной серьезности. Можно использовать эту информацию, чтобы проверить состояние MySQL Shell в процессе работы.
Местоположение файла журнала это пользовательский путь конфигурации,
файл называется mysqlsh.log.
По умолчанию регистрация отключена. Чтобы позволить регистрировать, надо
применить параметр командной строки
--log-level
, когда MySQL Shell запускается, использовать любую команду
\option или объект shell.options,
чтобы установить параметр конфигурации MySQL Shell
logLevel. Если выбор не установлен в командной
строке или в конфигурационном файле, или если вы определяете уровень 1 или
none, регистрация отключена. Все другие значения
позволяют регистрироваться и устанавливают уровень детализации в
регистрации следующим образом:
| Регистрация: числовой уровень | Регистрация: текст | Значение |
|---|---|---|
1 |
|
Ни один, по умолчанию |
2 |
|
Внутренняя ошибка |
3 |
|
Ошибка |
4 |
|
Предупреждение |
5 |
|
Информационный |
6 |
|
Отладка |
7 |
|
Отладка2 |
8 |
|
Отладка3 |
С опцией
--log-level можно определить уровень, используя его текстовое
название или числовой эквивалент, таким образом, следующие примеры имеют тот
же самый эффект:
shell>mysqlsh --log-level=4shell>mysqlsh --log-level=warning
С опцией logLevel
можно определить только числовой уровень.
Если вы предварительно определили уровень с @ (знак at), записи в журнале произведены к дополнительному видимому местоположению, а также написаны в файл журнала MySQL Shell. Следующие примеры имеют тот же самый эффект:
shell>mysqlsh --log-level=@8shell>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 путь по умолчанию к файлу журнала
%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 путь по умолчанию
~/.mysqlsh/mysqlsh.log, где
~
представляет корневой каталог пользователя. Переменная окружения
HOME также представляет корневой каталог
пользователя. Добавление .mysqlsh
к корневому каталогу пользователя определяет путь по умолчанию к журналу.