MySQL8.0的错误日志可以理解为一个全新的日志,在这个版本里,接受了来自社区的广泛批评意见,在这些意见和建议的基础上生成了新的日志。
下面这些是来自社区的意见:
- 默认情况下内容过于冗长
- 遗漏了有用的信息
- 难以过滤某些信息
- 没有标识错误信息的子系统源
- 没有错误代码,解析消息需要识别错误
- 引导消息可能会丢失
- 固定格式
针对这些意见,MySQL 8.0做了如下改变:
MySQL8.0新特性
- 采用组件架构,通过不同的组件执行日志的写入和过滤功能
- 写入错误日志的全部信息都具有唯一的错误代码从10000开始
- 增加了一个新的消息分类《system》用于在错误日志中始终可见的非错误但服务器状态更改事件的消息
- 增加了额外的附加信息,例如关机时的版本信息,谁发起的关机等等
- 两种过滤方式,Internal和Dragnet
- 三种写入形式,经典、JSON和syseventlog
这些新功能完全满足了广大用户所提出的要求,接下来将会具体说明相关功能。
组件架构:包括写入和过滤两大类,从可用组件中选取适用部分激活使用。
过滤方式:
Internal方式 Internal方式通变量来控制日志的内容和详细级别。两个变量为log_error_verbosity和log-error-suppression-list。 1)log_error_verbosity的值为1,2,3分别对应ERROR, WARNING, INFORMATION的组合,默认为2,既ERROR+WARNING。 2)log-error-suppression-list对应各种错误代码,不希望在日志里面显示的相关信息,可以通过设定相关的错误代码来控制。例如:“-SET PERSIST log_error_suppression_list=‘ER_PARSER_TRACE, MY-010001,10002’” Dragnet方式 Dragnet方式则更加灵活,类似于编写脚本。用户可以根据需要自行编写规则,每条规则是一个IF语句以"."结束,可以包含多条规则。例如:“SET GLOBAL dragnet.log_error_filter_rules = ‘IF prio>=INFORMATION THEN drop. IF EXISTS source_line THEN unset source_line.’;” 详细的语法内容可以参照在线手册:https://dev.mysql.com/doc/refman/8.0/en/error-log-rule-based-filtering.html
写入方式和输出格式:
1)默认的方式:将日志写入文件,输出格式为:timestamp thread_id [priority] [err_code] [subsystem] message 2)JSON方式:需要安装组件“INSTALL COMPONENT ‘file://component_log_sink_json’;”并在服务中添加“SET GLOBAL log_error_services = ‘log_filter_internal; log_sink_json’;”输出的格式为:
{
"prio": 3,
"err_code": 10051,
"source_line": 533,
"source_file": "event_scheduler.cc",
"function": "run",
"msg": "Event Scheduler: scheduler thread started with id 5",
"time": "2020-03-19T12:30:20.297184Z",
"ts": 1584621317167,
"thread": 5,
"err_symbol": "ER_SCHEDULER_STARTED",
"SQL_state": "HY000",
"subsystem": "Server",
"buffered": 1584621020297184,
"label": "Note"}
运维操作
查询当前错误日志配置
mysql> select @@global.log_error_services;
+----------------------------------------+
| @@global.log_error_services |
+----------------------------------------+
| log_filter_internal; log_sink_internal |
+----------------------------------------+
查询已安装的组件
mysql> select * from mysql.component;
Empty set (0.01 sec)
配置错误日志写出json格式
mysql> INSTALL COMPONENT 'file://component_log_sink_json';
Query OK, 0 rows affected (0.10 sec)
mysql> select * from mysql.component;
+--------------+--------------------+--------------------------------+
| component_id | component_group_id | component_urn |
+--------------+--------------------+--------------------------------+
| 1 | 1 | file://component_log_sink_json |
+--------------+--------------------+--------------------------------+
mysql> SET GLOBAL log_error_services = 'log_filter_internal; log_sink_internal; log_sink_json';
Query OK, 0 rows affected (0.01 sec)
配置log_sink_internal组件
目标: 配置log_sink_internal组件只记录ERROR类信息。 方法: 修改启动参数文件,调整log_error_verbosity参数。
[mysqld]
log_error_verbosity=1
目标: 配置log_sink_internal记录ERROR, WARNING, INFORMATION类错误,将 WARNING, INFORMATION中错误号MY-010001,MY-10002过滤掉。 方法: 修改启动参数文件,调整log_error_verbosity和log_error_suppression_list参数。
[mysqld]
log_error_verbosity=3
log_error_suppression_list='MY-010001,10002'
配置使用log_filter_dragnet过滤器
目标: 配置过滤器,按照用户定义的规则过滤错误日志信息。 方法: 使用log_filter_dragnet,配置变量dragnet.log_error_filter_rules添加过滤规则。
mysql> INSTALL COMPONENT 'file://component_log_filter_dragnet';
Query OK, 0 rows affected (0.08 sec)
mysql> SET GLOBAL log_error_services = 'log_filter_dragnet; log_sink_internal';
Query OK, 0 rows affected (0.00 sec)
mysql> SET GLOBAL dragnet.log_error_filter_rules = '
'> IF prio>=INFORMATION THEN drop.
'> IF prio>=WARNING THEN throttle 1/60.
'> IF EXISTS source_line THEN unset source_line.
'> ';
Query OK, 0 rows affected (0.00 sec)
配置错误日志写入Linux系统日志
目标: 将MySQL的错误日志写入Linux系统日志。 方法: 使用log_sink_syseventlog组件,将错误日志写入Linux系统日志。
mysql> INSTALL COMPONENT 'file://component_log_sink_syseventlog';
Query OK, 0 rows affected (0.08 sec)
mysql> SET PERSIST log_error_services = 'log_filter_internal; log_sink_syseventlog';
Query OK, 0 rows affected, 1 warning (0.00 sec)
刷新错误日志
目标: 保留原错误日志,让MySQL开始一个新的错误日志。 方法: 使用FLUSH ERROR LOGS 或 FLUSH LOGS 或 mysqladmin flush-logs都可以关闭错误日志,然后重新创建错误日志,在此之前应该手工将错误日志改名或备份。
#备份日志文件
mv /greatCluster/logs/error19000.log /greatCluster/logs/error19000.log.`date +%Y%m%d`
#刷新error log
mysqladmin flush-logs
或
mysql>flush error logs;
本文知识总结和测试参考文章: https://blog.51cto.com/u_15080016/2641676 https://www.cnblogs.com/greatsql/p/16105132.html