12.1 Журнал приложений MySQL Shell
Путь к файлу журнала приложений MySQL Shell находится в пользовательской конфигурации и называется mysqlsh.log. По умолчанию, MySQL Shell отправляет в этот файл информацию о журнале на уровне ведения журнала 5 (ошибки, предупреждения и информационные сообщения).
Сообщения журнала отформатированы с меткой времени в формате UTC.
Чтобы изменить уровень отправляемой информации о журнале или отключить ведение журнала в файле журнала приложения, выберите один из следующих вариантов:
Используйте опцию командной строки
--log-levelпри запуске MySQL Shell.Используйте команду MySQL Shell
\optionдля установки параметра конфигурации MySQL ShelllogLevel. Инструкции по использованию этой команды см. в разделе 13.4 «Настройка параметров MySQL Shell».Используйте объект
shell.optionsдля установки параметра конфигурации MySQL ShelllogLevel. Инструкции по использованию этого интерфейса конфигурации см. в разделе 13.4 «Настройка параметров MySQL Shell».
Доступные уровни ведения журнала перечислены в таблице 12.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 к домашнему каталогу пользователя определяет путь по умолчанию к журналу.
Если вы хотите, чтобы файл журнала приложения хранился в другом месте, вы можете переопределить путь к пользовательской конфигурации, определив переменную среды MYSQLSH_USER_CONFIG_HOME. Значение этой переменной заменяет ~/.mysqlsh/ в Unix.
Вы также можете использовать опцию --log-file для переопределения пути к пользовательской конфигурации при запуске mysqlsh из командной строки. Опция --log-file применяется к отдельному экземпляру MySQL Shell, что означает, что разные экземпляры могут записывать в разные места.
© 2025 Oracle
Licensed under the GPLv2 License.