2056634.jpg MySQL8.0的错误日志可以理解为一个全新的日志,在这个版本里,接受了来自社区的广泛批评意见,在这些意见和建议的基础上生成了新的日志。 下面这些是来自社区的意见:

  • 默认情况下内容过于冗长
  • 遗漏了有用的信息
  • 难以过滤某些信息
  • 没有标识错误信息的子系统源
  • 没有错误代码,解析消息需要识别错误
  • 引导消息可能会丢失
  • 固定格式

针对这些意见,MySQL 8.0做了如下改变:

MySQL8.0新特性

  • 采用组件架构,通过不同的组件执行日志的写入和过滤功能
  • 写入错误日志的全部信息都具有唯一的错误代码从10000开始
  • 增加了一个新的消息分类《system》用于在错误日志中始终可见的非错误但服务器状态更改事件的消息
  • 增加了额外的附加信息,例如关机时的版本信息,谁发起的关机等等
  • 两种过滤方式,Internal和Dragnet
  • 三种写入形式,经典、JSON和syseventlog 这些新功能完全满足了广大用户所提出的要求,接下来将会具体说明相关功能。 组件架构:包括写入和过滤两大类,从可用组件中选取适用部分激活使用。 image.png

过滤方式:

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