MySQL Shell 9.0  /  MySQL Shell 日志记录和调试  /  应用程序日志

12.1 应用程序日志

MySQL Shell 应用程序日志文件的位置是用户配置路径,文件名为 mysqlsh.log。默认情况下,MySQL Shell 会将日志级别 5(错误、警告和信息消息)的日志信息发送到此文件。

注意

日志消息使用 UTC 格式添加时间戳。

要更改发送的日志信息的级别,或禁用发送到应用程序日志文件的日志记录,请选择以下选项之一

可用的日志级别如表 12.1“MySQL Shell 中的日志级别”中所列。如果为此选项指定日志级别 1 或 none,则禁用发送到应用程序日志文件的日志记录。所有其他值都保持日志记录启用状态,并在日志文件中设置详细级别。此选项需要一个值。

使用 --log-level 命令行选项,您可以使用其文本名称或等效数字指定日志级别,因此以下示例具有相同的效果

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

使用 logLevel MySQL Shell 配置选项,您只能指定数字日志级别。

如果在日志级别前面加上 @(at 符号),则日志条目将输出到另一个可见位置,并写入 MySQL Shell 日志文件。以下示例具有相同的效果

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

在基于 Unix 的系统上,日志条目以 MySQL Shell 当前设置的输出格式输出到 stderr。这是 resultFormat MySQL Shell 配置选项的值,除非已通过使用 --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 来覆盖默认用户配置路径。此变量的值将替换 Windows 上的 %AppData%\MySQL\mysqlsh\

您还可以在从命令行运行 mysqlsh 时使用 --log-file 选项覆盖用户配置路径。 --log-file 选项适用于单个 MySQL Shell 实例,这意味着不同的实例可以写入不同的位置。

基于 Unix 的系统上的日志文件位置

对于运行 Unix 的计算机,应用程序日志文件的默认路径为 ~/.mysqlsh/mysqlsh.log,其中 ~ 表示用户的主目录。环境变量 HOME 也表示用户的主目录。将 .mysqlsh 附加到用户的主目录将确定日志的默认路径。

如果希望将应用程序日志文件存储在其他位置,可以通过定义环境变量 MYSQLSH_USER_CONFIG_HOME 来覆盖默认用户配置路径。此变量的值将替换 Unix 上的 ~/.mysqlsh/

您还可以在从命令行运行 mysqlsh 时使用 --log-file 选项覆盖用户配置路径。 --log-file 选项适用于单个 MySQL Shell 实例,这意味着不同的实例可以写入不同的位置。