新特性解读 | MySQL 8.0错误日志深入过滤（上）

作者：杨涛涛

资深数据库专家，专研 MySQL 十余年。擅长 MySQL、PostgreSQL、MongoDB 等开源数据库相关的备份恢复、SQL 调优、监控运维、高可用架构设计等。目前任职于爱可生，为各大运营商及银行金融企业提供 MySQL 相关技术支持、MySQL 相关课程培训等工作。

本文来源：原创投稿

*爱可生开源社区出品，原创内容未经授权不得随意使用，转载请联系小编并注明来源。

–

MySQL 8.0 有一个组件叫 component_log_filter_dragnet ， 它主要功能就是对 MySQL 的错误日志内容进行定制化过滤与改造，之前有简单提过，这次来详细说下如何使用。

使用前，先安装组件：

INSTALL COMPONENT 'file://component_log_filter_dragnet';

安装后，设置系统参数log_error_services 来启用它。

SET global log_error_services = 'log_filter_dragnet; log_sink_internal';

通过系统参数dragnet.log_error_filter_rules 来调整过滤规则，比如对指定错误代码限流、改造输出等等。类似对MySQL监控，必须有过滤条件、触发动作、最终结果等关键因素。 过滤条件则类似SQL语句中单个字段或者多个字段组合过滤。比如字段<操作符> 值、NOT EXISTS 字段、过滤条件组合等。存在三种字段：分别为核心字段，可选字段，用户自定义字段。

本篇我们来介绍核心字段。

核心字段列表如下：

1. time: 时间，比如可以设置在2022年12月1日之前都不允许写错误日志。
2. msg： 错误信息， 由于err_code直接能定位到msg，一般很少用它来判断，msg可以参与定制内容。
3. prio：优先级，对应的值为ERROR、WARNING、INFORMATION、NOTE几个值或者任意组合，与设置系统参数log_error_verbosity 效果类似。
4. err_code/SQL_state： 具体错误代码，也即错误信息的KEY。
5. err_symbol： 具体错误符号，MySQL每个错误代码都对应一个错误符号。具体的err_symbol 数据可以用perror 打印或者从官网错误参考页面查找：https://dev.mysql.com/doc/mysql-errors/8.0/en/server-error-reference.html
6. subsystem: 指定过滤的子系统项目，比如：Server、InnoDB等。

触发动作有以下四个：

1. drop: 删除错误数据。
2. throttle: 对内容限流。
3. set：定制字段数据。
4. unset: 重置字段数据。

本篇要改造的错误日志基于如下命令产生：全篇用命令A代替。

[root@ytt-pc ytt]# mysql -utest33333 
ERROR 1045 (28000): Access denied for user 'test33333'@'localhost' (using password: NO)

对应的错误日志代码：从结果截取两个err_code 分别为MY-013360和MY-010926。

2022-03-24T06:03:59.511173Z 50 [Warning] [MY-013360] [Server] Plugin sha256_password reported: ''sha256_password' is deprecated and will be removed in a future release. Please use caching_sha2_password instead'
2022-03-24T06:03:59.511322Z 50 [Note] [MY-010926] [Server] Access denied for user 'test33333'@'localhost' (using password: NO)

接下来我举例说明一些常见用法：

字段time

类似对表时间字段进行过滤，可以定义一个等值条件或者取值范围。例如让2023-01-01之前的错误数据不记入日志，配合字段time以及动作drop来实现：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if time <''2023-01-01'' then drop .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，只要时间还没到2023年，错误日志里就不会记录任何数据。

字段prio.

比如可以用字段prio来屏蔽warning数据，让其不计入错误日志，实现如下：

ytt-pc:(none):8.0.28>set global dragnet.log_error_filter_rules='if prio==warning then drop .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，完了查看错误日志：日志里只保留Note数据，warning数据没有记入。

2022-03-24T06:05:41.037512Z 52 [Note] [MY-010926] [Server] Access denied for user 'test33333'@'localhost' (using password: NO)

字段err_code/SQL_state.

err_code 最直接，只要查到错误代码，根据err_code来过滤即可。比如禁止错误代码为MY-010926的数据记入日志，可以直接用err_code=MY-010926来过滤，实现如下：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 then drop .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，完了查看错误日志：不存在错误代码为MY-010926的数据。

2022-03-24T06:08:47.771611Z 53 [Warning] [MY-013360] [Server] Plugin sha256_password reported: ''sha256_password' is deprecated and will be removed in a future release. Please use caching_sha2_password instead'

假设想定制错误代码，把它们改造成MySQL官网错误参考页面查不到的值，可以配合动作set来实现：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 or err_code==MY-013360  then set err_code=1234567890 .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，完了查看错误日志：相关错误代码全部替换为MY-1234567890。

2022-03-24T06:12:37.456522Z 55 [Warning] [MY-1234567890] [Server] Plugin sha256_password reported: ''sha256_password' is deprecated and will be removed in a future release. Please use caching_sha2_password instead'
   2022-03-24T06:12:37.456676Z 55 [Note] [MY-1234567890] [Server] Access denied for user 'test33333'@'localhost' (using password: NO)

假设想定制错误数据，可以在set动作时，更新字段msg的值，实现如下：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 or err_code==MY-013360  then set msg=''你来看哦，没有了哦！！！'' .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，完了查看错误日志：错误数据已经被重新定制。

2022-03-24T06:16:05.617758Z 56 [Warning] [MY-013360] [Server] 你来看哦，没有了哦！！！
   2022-03-24T06:16:05.617898Z 56 [Note] [MY-010926] [Server] 你来看哦，没有了哦！！！

以上err_code也可以直接替换为对应的SQL_state，效果一样。比如：sql_state=‘HY000’（这里是字符串）。

字段err_symbol

之前说过，err_symbol和err_code类似，通过perror打印这两个错误代码对应的err_symbol如下：括号里大写的两串字符。

[root@ytt-pc ytt]# perror MY-013360 MY-010926
   MySQL error code MY-013360 (ER_SERVER_WARN_DEPRECATED): '%s' is deprecated and will be removed in a future release. Please use %s instead
   MySQL error code MY-010926 (ER_ACCESS_DENIED_ERROR_WITH_PASSWORD): Access denied for user '%-.48s'@'%-.64s' (using password: %s)

现在来由err_symbol实现刚才err_code定制的msg数据：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_symbol==''ER_SERVER_WARN_DEPRECATED''  or err_symbol==''ER_ACCESS_DENIED_ERROR_WITH_PASSWORD'' then set msg=''你来看哦，没有了哦！！''.';
   Query OK, 0 rows affected (0.00 sec)

字段subsystem

假设要屏蔽Server级别的错误（本篇这两个错误代码对应的数据也是Server级别的），实现如下：

ytt-pc:(none):8.0.28>set global dragnet.log_error_filter_rules='if subsystem==''Server'' then drop .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，再次查看错误日志：Server级别的错误数据都没记入日志。

动作复原命令：unset

unset 可以初始化具体的字段，比如初始化这两个错误代码对应的msg，实现如下：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 or err_code==MY-013360  then unset msg .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，完了查看错误日志：数据变为*“No error message, or error message of non-string type. This is almost certainly a bug!”*

2022-03-24T06:24:14.846763Z 59 [ERROR] [MY-013360] [Server] No error message, or error message of non-string type. This is almost certainly a bug!
   2022-03-24T06:24:14.846925Z 59 [ERROR] [MY-010926] [Server] No error message, or error message of non-string type. This is almost certainly a bug!

动作限流命令：throttle

假设这两个错误数据在日志里只能记录两条，实现如下：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 or err_code==MY-013360 then throttle 2 .';
   Query OK, 0 rows affected (0.00 sec)

无论执行多少次命令A，同样的错误数据在日志里只记录两条。

假设限制这两个错误数据在日志里每分钟记录2条，实现如下：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 or err_code==MY-013360 then throttle 2/60 .';
   Query OK, 0 rows affected (0.00 sec)

效果为错误日志以分钟级别记录这两条数据。

在条件里加上稍微复杂的判断条件

假设错误代码MY-010926 对应的msg被定制为“好的，就这样！”，错误代码MY-013360对应的msg被定制为“不错哦，就这样吧！”，实现如下：

ytt-pc:ytt:8.0.28>set global dragnet.log_error_filter_rules='if err_code==MY-010926 then set msg=''好的，就这样！'' elseif err_code==MY-013360 then set msg=''不错哦，就这样吧！'' .';
   Query OK, 0 rows affected (0.00 sec)

退出执行命令A，完了查看错误日志：msg 被对应的定制数据分别覆盖。

2022-03-24T06:32:06.505039Z 60 [Warning] [MY-013360] [Server] 不错哦，就这样吧！
   2022-03-24T06:32:06.505296Z 60 [Note] [MY-010926] [Server] 好的，就这样！

由于内容较多，我分成了两部分，第一部分就到此为止。

这里写自定义目录标题

• ​​本篇我们来介绍核心字段。​​

• ​​核心字段列表如下：​​
• ​​触发动作有以下四个：​​

• ​​接下来我举例说明一些常见用法：​​

• ​​字段time​​
• ​​字段prio.​​
• ​​字段err_code/SQL_state.​​
• ​​字段err_symbol​​
• ​​字段subsystem​​
• ​​动作复原命令：unset​​
• ​​动作限流命令：throttle​​
• ​​在条件里加上稍微复杂的判断条件​​

• ​​欢迎使用Markdown编辑器​​

• ​​新的改变​​
• ​​功能快捷键​​
• ​​合理的创建标题，有助于目录的生成​​
• ​​如何改变文本的样式​​
• ​​插入链接与图片​​
• ​​如何插入一段漂亮的代码片​​
• ​​生成一个适合你的列表​​
• ​​创建一个表格​​

• ​​设定内容居中、居左、居右​​
• ​​SmartyPants​​

• ​​创建一个自定义列表​​
• ​​如何创建一个注脚​​
• ​​注释也是必不可少的​​
• ​​KaTeX数学公式​​
• ​​新的甘特图功能，丰富你的文章​​
• ​​UML 图表​​
• ​​FLowchart流程图​​
• ​​导出与导入​​

• ​​导出​​
• ​​导入​​

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法​​¹​​
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用​​​TOC​​语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: ​​link​​.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去​​博客设置​​页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 ​​代码片​​.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目

• 项目

• 项目

1. 项目1
2. 项目2
3. 项目3

• 
  
• 
  

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用​​:---------:​​​居中
使用​​​:----------​​​居左
使用​​​----------:​​居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	​​'Isn't this fun?'​​	‘Isn’t this fun?’
Quotes	​​"Isn't this fun?"​​	“Isn’t this fun?”
Dashes	​​-- is en-dash, --- is em-dash​​	– is en-dash, — is em-dash

创建一个自定义列表

HTML Authors John Luke

如何创建一个注脚

一个具有注脚的文本。​​²​​

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 ​​KaTeX​​:

Gamma公式展示 $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

$\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.$

你可以找到更多关于的信息 LaTeX 数学表达式​​here​​.

新的甘特图功能，丰富你的文章

Mon 06 Mon 13 Mon 20 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid

• 关于 甘特图 语法，参考 ​​这儿​​,

UML 图表

可以使用UML图表进行渲染。 ​​Mermaid​​. 例如下面产生的一个序列图：

张三 李四 王五 你好！李四, 最近怎么样? 你最近怎么样，王五？ 我很好，谢谢! 我很好，谢谢! 李四想了很长时间, 文字太长了 不适合放在一行. 打量着王五... 很好... 王五, 你怎么样? 张三 李四 王五

这将产生一个流程图。:

链接

长方形

圆

圆角长方形

菱形

• 关于 Mermaid 语法，参考 ​​这儿​​,

FLowchart流程图

我们依旧会支持flowchart的流程图：

Created with Raphaël 2.3.0 开始 我的操作 确认？ 结束 yes no

• 关于 Flowchart流程图 语法，参考 ​​这儿​​.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

---

1. ​​mermaid语法说明​​ ↩︎
2. 注脚的解释 ↩︎