13.1 Application Log — MySQL Shell 9.2

13.1 Журнал приложений

Путь к файлу журнала приложений MySQL Shell — это путь к пользовательской конфигурации, а имя файла — mysqlsh.log. По умолчанию MySQL Shell отправляет в этот файл информацию об уровне регистрации 5 (ошибки, предупреждения и информационные сообщения).

Примечание

Сообщения журнала отформатированы по времени UTC.

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

Используйте опцию командной строки --log-level при запуске MySQL Shell.
Используйте команду MySQL Shell \option для установки опции конфигурации MySQL Shell logLevel. Инструкции по использованию этой команды см. в разделе 14.4, «Настройка параметров MySQL Shell».
Используйте объект shell.options для установки опции конфигурации MySQL Shell logLevel. Инструкции по использованию этого интерфейса конфигурации см. в разделе 14.4, «Настройка параметров MySQL Shell».

Доступные уровни регистрации перечислены в таблице 13.1, «Уровни регистрации в MySQL Shell». Если вы зададите уровень регистрации 1 или none для этой опции, регистрация в файле журнала приложений будет отключена. Все остальные значения оставляют регистрацию включенной и задают уровень подробности в файле журнала. Эта опция требует значения.

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

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

С помощью опции конфигурации MySQL Shell logLevel можно указать только числовой уровень регистрации.

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

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

В системах на основе Unix записи журнала выводятся в stderr в формате вывода, который в настоящее время установлен для MySQL Shell. Это значение опции конфигурации 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();

Путь к файлу журнала в 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.

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

Также можно использовать опцию --log-file для переопределения пути к пользовательской конфигурации при запуске mysqlsh из командной строки. Опция --log-file применяется к отдельному экземпляру MySQL Shell, то есть разные экземпляры могут писать в разные места.

Путь к файлу журнала в системах на основе Unix

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