博客园  :: 首页  :: 新随笔  :: 订阅 订阅  :: 管理

MySQL 调试方式之mysqld.trace

Posted on 2022-07-20 16:18  面具下的戏命师  阅读(1095)  评论(0编辑  收藏  举报

MySQL 调试方式之mysqld.trace

MySQL 的 debug 版提供了一个专门的 DBUG 包。通过这个 DBUG 包,可获取正在执行操作程序的 Trace 文件。通过控制 DBUG 开关,可以将 MySQL 的任何操作,以及所涉及的调用模块、函数、状态信息记录在 Trace 文件中。

DBUG包可以通过使用--debug[=debug_options]或-#[debug_options]选项调用程序来使用。如果在没有debug_options值的情况下指定--debug或-#选项,则大多数MySQL程序使用默认值。服务器默认为d:t:i:o,/tmp/mysqld。 大多数客户端程序使用默认的debug选项值d:t:o,/tmp/program_name.trace。

在 shell 命令行指定调试控制字符串,示例:

--debug=d:t
--debug=d:f,main,subr1:F:L:t,20
--debug=d,input,output,files:n
--debug=d:t:i:O,\\mysqld.trace

对于mysqld,也可以通过设置debug系统变量在运行时更改DBUG设置。此变量具有全局值和会话值:

mysql> SET GLOBAL debug = 'debug_options';
mysql> SET SESSION debug = 'debug_options';

debug_options值是一系列冒号分隔的字段,值中的每个字段都由一个强制标志字符组成,前面可选+或-字符,后面可选逗号分隔的修饰符列表

[+|-]flag[,modifier,modifier,...,modifier]

下表介绍标志字符。无法识别的标志字符将被自动忽略。

标识字符 描述
d 为当前状态启用DBUG_XXX宏的输出。后面可能会有一个关键字列表,该列表仅为具有该关键字的DBUG宏启用输出。关键字的空列表启用所有宏的输出.在MySQL中,要启用的常见调试宏关键字有enter、exit、error、warning、info和loop。如:set debug = 'd,info';   获取代码中DBUG_PRINT("info:" 打印的日志)
D 每个调试器输出行之后的延迟。论点是延迟,以十分之一秒为单位,取决于机器的能力。例如,D,20指定两秒的延迟。
f 将调试、跟踪和分析限制在命名函数列表中。空列表启用所有功能。仍然必须给出适当的d或t标志;此标志仅在启用时限制其操作。
F 标识每行调试或跟踪输出的源文件名。
i 用每行调试或跟踪输出的PID或线程ID标识进程
L 标识调试或跟踪输出每行的源文件行号
n 打印每行调试或跟踪输出的当前函数嵌套深度
N 对调试输出的每行进行编号
o 将调试器输出流重定向到指定文件。默认输出为stderr
O 与o类似,但文件在每次写入之间都会被刷新。需要时,在每次写入之间关闭并重新打开文件
P 将调试器操作限制为指定进程。一个进程必须用DBUG_进程宏标识,并与列表中的一个进程匹配,才能执行调试器操作
p 打印每行调试或跟踪输出的当前进程名称
r 推送新状态时,不要继承以前状态的函数嵌套级别。当输出从左边距开始时有用。
S 在每个已调试的函数上执行函数_sanity(_file_,_line_))直到_sanity()返回与0不同的内容
t 启用函数调用/退出跟踪线。后面可能会有一个列表(仅包含一个修饰符),给出数字最大跟踪级别,超过该级别,调试或跟踪宏都不会出现输出。默认为编译时选项。

前导+或-字符和尾随修饰符列表用于标志字符,如d或f,可以对所有适用修饰符或其中一些修饰符启用调试操作:

如果没有前导+或-,则标志值将精确设置为给定的修饰符列表。使用前导+或-,列表中的修饰符将添加到当前修饰符列表或从中减去

以下示例显示了这如何适用于d标志。为所有调试宏启用了空d列表输出。非空列表仅为列表中的宏关键字启用输出。

这些语句将d值设置为给定的修饰符列表:

mysql> SET debug = 'd';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| d       |
+---------+
mysql> SET debug = 'd,error,warning';
mysql> SELECT @@debug;
+-----------------+
| @@debug         |
+-----------------+
| d,error,warning |
+-----------------+

前导+或-将当前d值相加或相减:

mysql> SET debug = '+d,loop';
mysql> SELECT @@debug;
+----------------------+
| @@debug              |
+----------------------+
| d,error,warning,loop |
+----------------------+

mysql> SET debug = '-d,error,loop';
mysql> SELECT @@debug;
+-----------+
| @@debug   |
+-----------+
| d,warning |
+-----------+

添加到“所有启用的宏”不会导致任何更改:

mysql> SET debug = 'd';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| d       |
+---------+

mysql> SET debug = '+d,loop';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| d       |
+---------+

禁用所有启用的宏将完全禁用d标志:

mysql> SET debug = 'd,error,loop';
mysql> SELECT @@debug;
+--------------+
| @@debug      |
+--------------+
| d,error,loop |
+--------------+

mysql> SET debug = '-d,error,loop';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
|         |
+---------+

建议:

set debug = 'd:t:o,/tmp/mysqld.trace';   只对当前会话生效,只对当前执行的语句 trace。结果比较清晰

官方手册:https://dev.mysql.com/doc/refman/8.0/en/debugging-mysql.html