使用MySQL的时候,会经常涉及几个日志,例如二进制日志、慢查询日志、REDO日志、UNDO日志、错误日志以及通用日志。每种日志都有自己的用处和用法,建议日常使用中根据需要,选择开启不同的日志。
今天在这里主要介绍一下MySQL8.0里对错误日志的改进。MySQL8.0的错误日志可以理解为一个全新的日志,在这个版本里,接受了来自社区的广泛批评意见,在这些意见和建议的基础上生成了新的日志。
下面这些是来自社区的意见:
- 默认情况下内容过于冗长
- 遗漏了有用的信息
- 难以过滤某些信息
- 没有标识错误信息的子系统源
- 没有错误代码,解析消息需要识别错误
- 引导消息可能会丢失
- 固定格式
针对这些意见,MySQL做了如下改变:
- 采用组件架构,通过不同的组件执行日志的写入和过滤功能
- 写入错误日志的全部信息都具有唯一的错误代码从10000开始
- 增加了一个新的消息分类《system》用于在错误日志中始终可见的非错误但服务器状态更改事件的消息
- 增加了额外的附加信息,例如关机时的版本信息,谁发起的关机等等
- 两种过滤方式,Internal和Dragnet
- 三种写入形式,经典、JSON和syseventlog
这些新功能完全满足了广大用户所提出的要求,接下来将会具体说明相关功能。
组件架构:包括写入和过滤两大类,从可用组件中选取适用部分激活使用。
过滤方式:包括Internal和Dragnet。Internal方式通变量来控制日志的内容和详细级别。两个变量为log_error_verbosity和
log-error-suppression-list。log_error_verbosity的值为1,2,3分别对应
ERROR, WARNING, INFORMATION的组合,默认为2,既ERROR+WARNING。
log-error-suppression-list对应各种错误代码,不希望在日志里面显示的相关信息,可以通过设定相关的错误代码来控制。例如:“-SET PERSIST log_error_suppression_list=‘ER_PARSER_TRACE, MY-010001,10002’”
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”
写入方式和输出格式:
默认的方式:将日志写入文件,输出格式为:timestamp thread_id [priority] [err_code] [subsystem] message
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"}
系统日志方式:允许mysqld将日志写入Windows的event log或类UNIX系统的syslog。同样需要安装组件和加载服务:INSTALL COMPONENT 'file://component_log_sink_syseventlog';SET GLOBAL log_error_services = 'log_filter_internal; log_sink_syseventlog';输出的格式与对应的系统日志格式相同。