MySQL8.0的错误日志

使用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';输出的格式与对应的系统日志格式相同。

关于错误日志的介绍内容到此为止，更为详细的信息请访问官网“https://dev.mysql.com/doc/refman/8.0/en/error-log.html”，希望新的日志能够给您带来帮助。