Spec-Zone.ru › MySQL Shell 8.4

12.1 Журнал приложений MySQL Shell

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

Примечание

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

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

  • Используйте опцию командной строки --log-level при запуске MySQL Shell.

  • Используйте команду MySQL Shell \option для установки параметра конфигурации MySQL Shell logLevel. Инструкции по использованию этой команды см. в разделе 13.4 «Настройка параметров MySQL Shell».

  • Используйте объект shell.options для установки параметра конфигурации MySQL Shell logLevel. Инструкции по использованию этого интерфейса конфигурации см. в разделе 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.
https://docs.oracle.com/cd/E17952_01/mysql-shell-8.4-en/mysql-shell-application-log-introduction.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API