图文结合带你搞懂MySQL日志之Error Log（错误日志）

• GreatSQL社区原创内容未经授权不得随意使用，转载请联系小编并注明来源。
• GreatSQL是MySQL的国产分支版本，使用上与MySQL一致。
• 作者：KAiTO
• 文章来源：社区原创

往期回顾：

• 图文结合带你搞懂MySQL日志之Redo Log(重做日志)
• 图文结合带你搞懂InnoDB MVCC
• 图文结合带你搞定MySQL日志之Undo log(回滚日志)

---

什么是错误日志

错误日志（Error Log） 是 MySQL 中最常用的一种日志，主要记录 MySQL 服务器启动和停止过程中的信息、服务器在运行过程中发生的故障和异常情况等。

错误日志记录了啥

错误日志包含 mysqld 启动和关闭的时间信息，还包含诊断消息，如服务器启动和关闭期间以及服务器运行时出现的错误、警告和其他需要注意的信息。

例如：如果 mysqld 检测到某个表需要检查或修复，会写入错误日志。

根据错误日志配置，错误消息还可能填充 performance_schema.error_log 表，以便为日志提供 SQL 接口，使错误日志能够查询。

如果用 mysqld_safe 启动 mysqld，mysqld_safe 会将消息写入错误日志。

例如，当 mysqld_safe 注意到 mysqld 异常退出时，它会重新启动 mysqld，并将 mysqld 重新启动的消息写入错误日志。

怎么启动错误日志

在MySQL数据库中，错误日志功能是默认开启的。而且，错误日志无法被禁止。

默认情况下，错误日志存储在MySQL数据库的数据文件夹下，名称默认为mysqld.log（Linux系统）或hostname.err（mac系统）。如果需要制定文件名，则需要在my.cnf或者my.ini中做如下配置：

[mysqld]
log-error=[path/[filename]] #path为日志文件所在的目录路径，filename为日志文件名

修改配置项后，需要重启 MySQL 服务以生效。

查看日志

MySQL错误日志是以文本文件形式存储的，可以使用文本编辑器直接查看。
查询错误日志的存储路径：

mysql> show variables like 'log_err%';
+----------------------------+----------------------------------------+
| Variable_name              | Value                                  |
+----------------------------+----------------------------------------+
| log_error                  | /var/log/mysqld.log                    |
| log_error_services         | log_filter_internal; log_sink_internal |
| log_error_suppression_list |                                        |
| log_error_verbosity        | 2                                      |
+----------------------------+----------------------------------------+
4 rows in set (0.00 sec)

参数解析

• log_error 定义为错误日志文件路径。
• log_error_services 控制哪个日志组件启用错误日志，该变量可以包含具有0、1或多组件列表；在后一种情况下，组件可以用分号或（从MySQL 8.0.12开始）逗号分隔，另外服务器按照列出的顺序执行组件。
  默认情况下，log_error_services 具有以下值：

mysql> SELECT @@GLOBAL.log_error_services;
+----------------------------------------+
| @@GLOBAL.log_error_services            |
+----------------------------------------+
| log_filter_internal; log_sink_internal |
+----------------------------------------+
1 row in set (0.00 sec)

• log_error_suppression_list 用于错误日志的事件的抑制作用,有些日志不希望记录下来。
• log_error_verbosity日志记录等级：

log_error_verbosity Value	Permitted Message Priorities
1	ERROR
2	ERROR, WARNING
3	ERROR, WARNING, INFORMATION

• 在MGR中建议设置为3可以记录更多日志信息，便于跟踪问题。

log_timestamps控制日志显示时间

在MySQL 5.7.2 新增了 log_timestamps 这个参数，该参数主要是控制 error log、genera log，等等记录日志的显示时间参数。
在 5.7.2 之后改参数为默认 UTC 这样会导致日志中记录的时间比中国这边的慢，导致查看日志不方便。

mysql> SHOW GLOBAL VARIABLES LIKE 'log_timestamps';
+----------------+-------+
| Variable_name  | Value |
+----------------+-------+
| log_timestamps | UTC   |
+----------------+-------+
1 row in set (0.00 sec)

可以看到使用的时间是UTC时间，UTC是世界公用的一个时间，那么我们本地时间和UTC时间就必然存在一个换算关系。按北京时间来算，北京时间将比UTC时间快8个小时。

修改方法：

• MySQL5.7修改

1.set global log_timestamps=system;
2.修改后可以在配置文件再添加
  [mysqld]
  log_timestamps=system

• MySQL8.0修改

1.set global log_timestamps=system;

• 小节结论
  1.为了国内用户便于读取日志信息，建议将参数写入到配置文件my.cnf
  2.MySQL 8.0支持参数log_timestamps持久化设置。

删除\刷新日志

对于很久以前的错误日志，数据库管理员查看这些错误日志的可能性不大，可以将这些错误日志删除，以保证 MySQL 服务器上的硬盘空间。MySQL 的错误日志是以文本文件的形式存储在文件系统中的，可以直接删除。

#刷新日志
[root@kaito log]# mysqladmin -uroot -p flush-logs
Enter password:
mysqladmin: refresh failed; error: 'Could not open file '/var/log/mysqld.log' for error logging.'

官网提示：

补充操作：

install -omysql -gmysql -m0644 /dev/null /var/log/mysqld.log

·flush-logs·指令操作：

• MySQL5.5.7以前的版本，flush-logs将错误日志文件重命名为filename.err_old,并创建新的日志文件。
• 从MySQL5.5.7开始，flush-logs只是重新打开日志文件，并不做日志备份和创建的操作。
• 如果日志文件不存在，MySQL启动或者执行flush-logs时会自动创建新的日志文件。重新创建错误日志，大小为0字节。

参考文章

《MySQL是怎样运行的--从根儿上理解MySQL》—小孩子4919

---

Enjoy GreatSQL 😃

关于 GreatSQL

GreatSQL是由万里数据库维护的MySQL分支，专注于提升MGR可靠性及性能，支持InnoDB并行查询特性，是适用于金融级应用的MySQL分支版本。

相关链接： GreatSQL社区 Gitee GitHub Bilibili

GreatSQL社区：

捉虫活动详情：https://greatsql.cn/thread-97-1-1.html

社区博客有奖征稿详情：https://greatsql.cn/thread-100-1-1.html

技术交流群：

微信：扫码添加GreatSQL社区助手微信好友，发送验证信息加群。