5.4.5 慢查询日志

慢速查询日志由执行时间超过 long_query_time几秒并且至少 min_examined_row_limit需要检查行的 SQL 语句组成。慢速查询日志可用于查找需要很长时间执行的查询，因此是优化的候选者。但是，检查长而慢的查询日志可能是一项耗时的任务。为了使这更容易，您可以使用 mysqldumpslow命令来处理慢速查询日志文件并汇总其内容。请参阅 第 4.6.8 节，“mysqldumpslow — 总结慢速查询日志文件”。

获取初始锁的时间不计入执行时间。mysqld在执行完并释放所有锁后将语句写入慢速查询日志，因此日志顺序可能与执行顺序不同。

慢查询日志参数

的最小值和默认值 long_query_time分别为 0 和 10。该值可以指定为微秒级的分辨率。

默认情况下，不记录管理语句，也不记录不使用索引进行查找的查询。可以使用 log_slow_admin_statements和 更改此行为log_queries_not_using_indexes，如后所述。

默认情况下，慢查询日志是关闭的。要显式指定初始慢查询日志状态，请使用 --slow_query_log[={0|1}]. 在没有参数或参数为 1 的情况下， --slow_query_log启用日志。如果参数为 0，此选项将禁用日志。要指定日志文件名，请使用 . 要指定日志目标，请使用 系统变量（如第 5.4.1 节“选择一般查询日志和慢速查询日志输出目标”中所述）。 --slow_query_log_file=file_namelog_output

笔记

如果指定TABLE日志目的地，请参阅日志表和“打开的文件太多”错误。

如果您没有为慢查询日志文件指定名称，则默认名称为 host_name-slow.log. 服务器在数据目录中创建文件，除非给出绝对路径名来指定不同的目录。

要在运行时禁用或启用慢速查询日志或更改日志文件名，请使用全局 变量slow_query_log和 slow_query_log_file系统变量。设置slow_query_log 为 0 以禁用日志或设置为 1 以启用它。设置 slow_query_log_file以指定日志文件的名称。如果日志文件已经打开，则关闭它并打开新文件。

如果您使用该--log-short-format 选项，服务器将较少的信息写入慢速查询日志。

要在慢速查询日志中包含慢速管理语句，请启用 log_slow_admin_statements 系统变量。行政报表包括 ALTER TABLE、 ANALYZE TABLE、 CHECK TABLE、 CREATE INDEX、 DROP INDEX、 OPTIMIZE TABLE和 REPAIR TABLE。

要在写入慢速查询日志的语句中包含不使用索引进行行查找的查询，请启用 log_queries_not_using_indexes 系统变量。（即使启用了该变量，服务器也不会记录由于表少于两行而无法从索引的存在中受益的查询。）

当记录不使用索引的查询时，慢速查询日志可能会快速增长。log_throttle_queries_not_using_indexes 可以通过设置系统变量来限制这些查询的速率 。默认情况下，此变量为 0，表示没有限制。正值对不使用索引的查询的记录施加每分钟限制。第一个这样的查询会打开一个 60 秒的窗口，服务器会在该窗口内记录达到给定限制的查询，然后抑制其他查询。如果窗口结束时有被抑制的查询，服务器会记录一个摘要，指示有多少以及在这些查询中花费的总时间。当服务器记录下一个不使用索引的查询时，下一个 60 秒窗口开始。

服务器按以下顺序使用控制参数来确定是否将查询写入慢查询日志：

  1. 查询必须不是管理语句，或者 log_slow_admin_statements 必须启用。

  2. 查询必须至少花费 long_query_time几秒钟，或者 log_queries_not_using_indexes 必须启用并且查询不使用索引进行行查找。

  3. 查询必须至少检查了 min_examined_row_limit 行。

  4. 根据设置不得抑制查询 log_throttle_queries_not_using_indexes 。

log_timestamps系统变量控制写入慢速查询日志文件（以及一般查询日志文件和错误日志）的消息中时间戳的时区 。它不会影响写入日志表的一般查询日志和慢速查询日志消息的时区，但是可以使用CONVERT_TZ()或通过设置会话time_zone 系统变量从这些表中检索的行从本地系统时区转换为任何所需的时区。

服务器不记录查询缓存处理的查询。

默认情况下，副本不会将复制的查询写入慢查询日志。要更改此设置，请启用 log_slow_slave_statements 系统变量。请注意，如果基于行的复制正在使用 ( binlog_format=ROW)， log_slow_slave_statements则无效。只有在二进制日志中以语句格式记录查询时，查询才会添加到副本的慢查询日志中，即 binlog_format=STATEMENT设置为 when 时，或者binlog_format=MIXED设置为 statement 格式时记录语句。设置时以行格式记录的慢速查询 binlog_format=MIXED或设置时记录 binlog_format=ROW的慢速查询不会添加到副本的慢速查询日志中，即使 log_slow_slave_statements启用也是如此。

慢查询日志内容

启用慢速查询日志后，服务器会将输出写入 log_output系统变量指定的任何目标。如果启用日志，服务器将打开日志文件并将启动消息写入其中。FILE但是，除非选择了日志目标，否则不会进一步将查询记录到文件中。如果目标是 NONE，即使启用了慢速查询日志，服务器也不会写入任何查询。FILE如果未选择为输出目标， 则设置日志文件名对日志记录没有影响。

如果启用慢速查询日志并将FILE其选为输出目标，则写入日志的每个语句前面都有一行，该行以 #字符开头并包含以下字段（所有字段都在一行中）：

  • Query_time: duration

    以秒为单位的语句执行时间。

  • Lock_time: duration

    获取锁的时间，单位秒。

  • Rows_sent: N

    发送到客户端的行数。

  • Rows_examined:

    服务器层检查的行数（不计算存储引擎内部的任何处理）。

写入慢速查询日志文件的每个语句之前都有一个SET 语句，其中包含一个时间戳，指示慢速语句何时被记录（在语句完成执行后发生）。

写入慢速查询日志的语句中的密码由服务器重写，不会以纯文本形式出现。请参阅第 6.1.2.3 节，“密码和日志记录”。

从 MySQL 5.7.38 开始，无法解析的语句（例如，由于语法错误）不会写入慢查询日志。