## 一、基础背景

随着 MySQL 5.7 版本 EOL，许多客户都逐渐升级到 MySQL 8.0 版本，早期用社区版 5.7 版本时，MariaDB^[1]^ 审计插件通过调整源码适配，基本可兼容覆盖 5.7 绝大部门主流版本。8.0 后，MariaDB 插件不再兼容（或者说 MySQL 8.0 不再兼容 MariaDB），需要寻求一个社区版可用的审计插件。早期 Percona 官方明确表示，审计插件为 Percona Server 设计，未考虑 Oracle MySQL，也未做兼容适配，但在 2024 年 7 月，Percona 社区发文 验证审计插件支持 MySQL 8.0 版本，并做了示例演示。

**本文基于该背景，本地做基础验证，评估 Percona 审计插件和 MySQL 8.0 兼容性情况以及是否存在异常问题。**
## 二、环境信息

- 操作系统：CentOS Linux release 7.5.1804
- 数据库：MySQL 8.0.37 社区版
- 插件版本：Percona 8.0.37 版本中提取

## 三、插件安装

从 Percona 安装软件包中提取出审计插件 `audit_log.so`备用。
```shell
shell> mkdir -p  Percona-Server-8.0.37-29-Linux.x86_64.glibc2.17/lib/plugin/
shell> tar -xvf Percona-Server-8.0.37-29-Linux.x86_64.glibc2.17.tar.gz --wildcards --no-anchored '*audit_log.so*'
shell> ls -al Percona-Server-8.0.37-29-Linux.x86_64.glibc2.17/lib/plugin/audit_log.so
-rwxr-xr-x 1 root root 914544 Aug 18  2024 Percona-Server-8.0.37-29-Linux.x86_64.glibc2.17/lib/plugin/audit_log.so

```
将提前出的 `audit_log.so`审计插件，放置在 MySQL 插件对应目录即可。
```shell
shell> mysql -u root -p --socket=/data/mysql/mysqldata3306/sock/mysql.sock

确认 MySQL 插件目录
mysql>  show global variables like 'plugin_dir';
+---------------+------------------------------+
| Variable_name | Value                        |
+---------------+------------------------------+
| plugin_dir    | usr/local/mysql/lib/plugin/ |
+---------------+------------------------------+
1 row in set (0.03 sec)

将审计插件拷贝至 MySQL 插件目录并调整好权限
shell> cp usr/local/Percona-Server-8.0.37-29-Linux.x86_64.glibc2.17/lib/plugin/audit_log.so usr/local/mysql/lib/plugin/
shell> chown mysql:mysql usr/local/mysql/lib/plugin/audit_log.so

```
登录数据库安装审计插件。
```shell
shell> mysql -u root -p --socket=/data/mysql/mysqldata3306/sock/mysql.sock

mysql> install plugin audit_log soname 'audit_log.so';
Query OK, 0 rows affected (0.02 sec)

验证安装成功
mysql> select * from mysql.plugin;
+-----------+--------------+
| name      | dl           |
+-----------+--------------+
| audit_log | audit_log.so |
+-----------+--------------+
1 row in set (0.01 sec)

mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS, PLUGIN_TYPE
    -> FROM INFORMATION_SCHEMA.PLUGINS
    -> WHERE PLUGIN_NAME = 'audit_log';
+-------------+---------------+-------------+
| PLUGIN_NAME | PLUGIN_STATUS | PLUGIN_TYPE |
+-------------+---------------+-------------+
| audit_log   | ACTIVE        | AUDIT       |
+-------------+---------------+-------------+

```
## 四、插件使用

插件安装完成后会新增 10 余个相关参数。
```shell
mysql> show global variables like 'audit%';
+-----------------------------+-----------------------------------------+
| Variable_name               | Value                                   |
+-----------------------------+-----------------------------------------+
| audit_log_buffer_size       | 1048576                                 |   #审计日志的缓冲区大小，单位为字节
| audit_log_exclude_accounts  | orchestrator'@'10*                      |   #指定不记录审计日志的数据库账号
| audit_log_exclude_commands  |                                         |   #指定不记录审计日志的命令类型
| audit_log_exclude_databases |                                         |   #指定不记录审计日志的数据库
| audit_log_file              | data/mysql/mysqldata3306/log/audit.log |   #审计日志文件的存储路径和文件名
| audit_log_flush             | OFF                                     |   #控制是否自动刷新审计日志缓冲区到磁盘（OFF 表示关闭自动刷新）
| audit_log_format            | JSON                                    |   #审计日志的文件格式
| audit_log_handler           | FILE                                    |   #审计日志的输出方式
| audit_log_include_accounts  |                                         |   #指定仅记录这些账号的审计日志
| audit_log_include_commands  |                                         |   #指定仅记录这些命令类型的审计日志
| audit_log_include_databases |                                         |   #指定仅记录这些数据库的审计日志
| audit_log_policy            | LOGINS                                  |   #审计日志的核心记录策略（LOGINS 表示仅记录登录相关事件）
| audit_log_rotate_on_size    | 1073741824                              |   #日志文件自动轮转的触发阈值（单位：字节）
| audit_log_rotations         | 7                                       |   #日志轮转后保留的历史日志文件数量（最多保留 7 个）
| audit_log_strategy          | ASYNCHRONOUS                            |   #审计日志的写入策略（ASYNCHRONOUS 表示异步写入）
| audit_log_syslog_facility   | LOG_USER                                |   #指定审计日志发送到系统日志时的 “设备类型”（facility），用于分类系统日志的来源
| audit_log_syslog_ident      | percona-audit                           |   #指定审计日志在系统日志中的 “标识字符串”（identifier），用于区分不同应用的日志。
| audit_log_syslog_priority   | LOG_INFO                                |   #指定审计日志在系统日志中的 “优先级”（priority），用于标记日志的重要程度
+-----------------------------+-----------------------------------------+
18 rows in set (0.02 sec)

```
基于默认规则，可以看到审计插件已启用并记录审计日志。
![image](https://developer.qcloudimg.com/http-save/yehe-9216102/54b4b95db5eb63151bdc6a7a21171905.png)

审计日志片段字段含义。
```shell
{
    "audit_record": {
        "name": "Connect",                       表示审计记录的事件类型
        "record": "2_2025-09-05T07:01:54",       计记录的唯一标识（ID）
        "timestamp": "2025-09-05T07:04:44Z",     登录事件发生的时间戳（UTC 时间）
        "connection_id": "8",                    //本次数据库连接的唯一会话 ID
        "status": 0,                             登录操作的状态码
        "user": "root",                          //客户端登录时使用的用户名
        "priv_user": "root",                     实际授予权限的用户
        "os_login": "",                          //客户端操作系统的用户名
        "proxy_user": "",                        //代理用户（若通过代理登录）
        "host": "localhost",                     客户端连接的主机名
        "ip": "",                                //客户端的 IP 地址
        "db": ""                                 //登录时指定的默认数据库
    }
}

```
## 五、审计相关关键参数使用

### 1. audit_log_policy 参数

`audit_log_policy`
 参数可以动态修改，满足 ALL、LOGINS、QUERIES 和 NONE 四种类型
- **ALL**：记录所有操作
- **LOGINS**：记录登录操作
- **QUERIES**：只记录数据库的查询操作
- **NONE**：不记录任何审计日志，即关闭审计功能

`audit.log`按照参数的设置输出相应的日志类型，这里测试 QUERIES 的。
```shell
root@localhost:(none) 8.0.37 05:22:16> SET GLOBAL audit_log_policy = 'QUERIES';
Query OK, 0 rows affected (0.00 sec)

root@localhost:(none) 8.0.37 05:23:31> select * from sys.sys_config;
+--------------------------------------+-------+---------------------+--------+
| variable                             | value | set_time            | set_by |
+--------------------------------------+-------+---------------------+--------+
| diagnostics.allow_i_s_tables         | OFF   | 2025-09-05 06:29:55 | NULL   |
| diagnostics.include_raw              | OFF   | 2025-09-05 06:29:55 | NULL   |
| ps_thread_trx_info.max_length        | 65535 | 2025-09-05 06:29:55 | NULL   |
| statement_performance_analyzer.limit | 100   | 2025-09-05 06:29:55 | NULL   |
| statement_performance_analyzer.view  | NULL  | 2025-09-05 06:29:55 | NULL   |
| statement_truncate_len               | 64    | 2025-09-05 06:29:55 | NULL   |
+--------------------------------------+-------+---------------------+--------+
6 rows in set (0.00 sec)

```
![image](https://developer.qcloudimg.com/http-save/yehe-9216102/e786984a075b65ad60b245e955a61cd3.png)
### 2. audit_log_format 参数

`audit_log_format`支持 OLD、NEW、CSV、JSON 四种形式；
- **OLD**：记录内容按照一定顺序排列，各字段间通过特定分隔符（如空格、制表符等）隔开；
- **NEW**：在 OLD 格式基础上进行优化和扩展，信息分类更细致，结构化程度更高，采用类似键值对组合的方式组织数据，不同操作类型会记录与其相关的详细上下文信息；
- **CSV**：即逗号分隔值（Comma-Separated Values）格式;
- **JSON**：采用键值对（"key": "value"）的方式组织数据

这里展现 JSON 形式。
![image](https://developer.qcloudimg.com/http-save/yehe-9216102/0eef0351a4e8002ade9a5d5c93f45f87.png)
### 3. audit_log_exclude_accounts 参数

测试添加排除的用户 `test`，测试生效，日志不会记录该用户的操作。
```shell
test@127.0.0.1:(none) 8.0.37 05:25:35> select * from sys.sys_config;
+--------------------------------------+-------+---------------------+--------+
| variable                             | value | set_time            | set_by |
+--------------------------------------+-------+---------------------+--------+
| diagnostics.allow_i_s_tables         | OFF   | 2025-09-05 06:29:55 | NULL   |
| diagnostics.include_raw              | OFF   | 2025-09-05 06:29:55 | NULL   |
| ps_thread_trx_info.max_length        | 65535 | 2025-09-05 06:29:55 | NULL   |
| statement_performance_analyzer.limit | 100   | 2025-09-05 06:29:55 | NULL   |
| statement_performance_analyzer.view  | NULL  | 2025-09-05 06:29:55 | NULL   |
| statement_truncate_len               | 64    | 2025-09-05 06:29:55 | NULL   |
+--------------------------------------+-------+---------------------+--------+
6 rows in set (0.00 sec)

test@127.0.0.1:(none) 8.0.3705:25:54> SET GLOBAL audit_log_exclude_accounts = "'orchestrator'@'10%','test'@'%'";
Query OK, 0 rows affected (0.00 sec)
test@127.0.0.1:(none) 8.0.37 05:29:53> select * from sys.sys_config;
+--------------------------------------+-------+---------------------+--------+
| variable                             | value | set_time            | set_by |
+--------------------------------------+-------+---------------------+--------+
| diagnostics.allow_i_s_tables         | OFF   | 2025-09-05 06:29:55 | NULL   |
| diagnostics.include_raw              | OFF   | 2025-09-05 06:29:55 | NULL   |
| ps_thread_trx_info.max_length        | 65535 | 2025-09-05 06:29:55 | NULL   |
| statement_performance_analyzer.limit | 100   | 2025-09-05 06:29:55 | NULL   |
| statement_performance_analyzer.view  | NULL  | 2025-09-05 06:29:55 | NULL   |
| statement_truncate_len               | 64    | 2025-09-05 06:29:55 | NULL   |
+--------------------------------------+-------+---------------------+--------+
6 rows in set (0.00 sec)

```
发现排除 `test`用户后无日志输出。
![image](https://developer.qcloudimg.com/http-save/yehe-9216102/c37779fc1f6675aed85c37b9607306e9.png)
### 4. audit_log_include_commands 参数

`audit_log_include_commands`：指定需要被记录到审计日志中的特定数据库命令类型，可以通过该语句查询出插件支持所有语句类型。
```shell
mysql> SELECT name FROM performance_schema.setup_instruments  WHERE name LIKE "statement/sql/%" ORDER BY name;
+-----------------------------------------------+
| name                                          |
+-----------------------------------------------+
| statement/sql/alter_db                        |
| statement/sql/alter_event                     |
| statement/sql/alter_function                  |
| statement/sql/alter_instance                  |
| statement/sql/alter_procedure                 |
| statement/sql/alter_resource_group            |
......
......
| statement/sql/update_multi                    |
| statement/sql/xa_commit                       |
| statement/sql/xa_end                          |
| statement/sql/xa_prepare                      |
| statement/sql/xa_recover                      |
| statement/sql/xa_rollback                     |
| statement/sql/xa_start                        |
+-----------------------------------------------+
159 rows in set (0.01 sec)

```
**支持 159 种！**
这里测试设置 `begin`，是否只会记录 `begin`语句。
测试前要先将 `audit_log_policy`调整成 **ALL** 或者 **QUERIES**，不然日志不会有记录。
```shell
mysql> SET GLOBAL audit_log_policy = 'ALL';
Query OK, 0 rows affected (0.01 sec)
mysql> SET GLOBAL audit_log_include_commands = 'begin';
Query OK, 0 rows affected (0.01 sec)
  
mysql> begin;
Query OK, 0 rows affected (0.00 sec)

```
![image](https://developer.qcloudimg.com/http-save/yehe-9216102/d7904cd44b088f75d01668e29984274d.png)

如果设置为NULL，则不会记录任何语句。

![image](https://developer.qcloudimg.com/http-save/yehe-9216102/dee9a49962964dd8f2ab80fc49e115e9.png)
![image](https://developer.qcloudimg.com/http-save/yehe-9216102/ebb6db80e3801c63ba2e7f69720199e2.png)
### 5. audit_log_exclude_databases 参数

作用：用于指定不需要被审计记录的数据库名称，实现 “**排除特定数据库的所有操作**” 的审计过滤效果。
添加 `audit_log_exclude_databases = 'mysql','test_%'`，重启登录数据库。
```shell
mysql> SELECT @@global.audit_log_exclude_databases;
+--------------------------------------+
| @@global.audit_log_exclude_databases |
+--------------------------------------+
| mysql','test_%                       |
+--------------------------------------+
1 row in set (0.00 sec)
mysql> select * from test_ddl_db.i1;
Empty set (0.02 sec)
root@localhost:(none) 8.0.3705:20:04> select * from sys.sys_config;
+--------------------------------------+-------+---------------------+--------+
| variable | value | set_time | set_by |
+--------------------------------------+-------+---------------------+--------+
| diagnostics.allow_i_s_tables | OFF | 2025-09-05 06:29:55 | NULL |
| diagnostics.include_raw | OFF | 2025-09-05 06:29:55 | NULL |
| ps_thread_trx_info.max_length | 65535 | 2025-09-05 06:29:55 | NULL |
| statement_performance_analyzer.limit | 100 | 2025-09-05 06:29:55 | NULL |
| statement_performance_analyzer.view | NULL | 2025-09-05 06:29:55 | NULL |
| statement_truncate_len | 64 | 2025-09-05 06:29:55 | NULL |
+--------------------------------------+-------+---------------------+--------+
6 rows in set (0.01 sec)

```
## 六、测试结论

在 MySQL 8.0.37 版本下，Percona 审计日志记录插件可以正常被使用，并简单说明了关键的几个参数。
- **audit_log_policy**：支持四种类型（ALL、LOGINS、QUERIES和NONE）
- **audit_log_format**：支持四种类型（OLD、NEW、CSV、JSON）
- **audit_log_exclude_accounts**：可以排除不记录用户的操作日志
- **audit_log_include_commands**：可以控制 159 种类型语句
- **audit_log_exclude_databases**：可以排除特定数据库的所有操作

随着 MySQL 5.7 版本 EOL，许多客户都逐渐升级到 MySQL 8.0 版本，早期用社区版 5.7 版本时，MariaDB^[1]^ 审计插件通过调整源码适配，基本可兼容覆盖 5.7 绝大部门主流版本。8.0 后，MariaDB 插件不再兼容（或者说 MySQL 8.0 不再兼容 MariaDB），需要寻求一个社区版可用的审计插件。早期 Percona 官方明确表示，审计插件为 Percona Server 设计，未考虑 Oracle MySQL，也未做兼容适配，但在 2024 年 7 月，Percona 社区发文 验证审计插件支持 MySQL 8.0 版本，并做了示例演示。

MySQL 8.0 社区版如何使用 Percona 审计插件？

随着 MySQL 5.7 版本 EOL，许多客户都逐渐升级到 MySQL 8.0 版本，早期用社区版 5.7 版本时，MariaDB^[1]^ 审计插件通过调整源码适配，基本可兼容覆盖 5.7 绝大部门主流版本。8.0 后，MariaDB 插件不再兼容（或者说 MySQL 8.0 不再兼容 MariaDB），需要寻求一个社区版可用的审计插件。

数据开发

数据库

开发工具

MySQL8.0.37兼容Percona审计插件，支持多种日志格式和策略。详细介绍audit_log_policy、audit_log_format等关键参数配置，实现精准审计控制，包括排除特定用户、数据库和159种SQL语句类型。

日志文件

MariaDB

MySQL

Linux

JSON

2026新春采购季

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


tdsql

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

MySQL 8.0 社区版如何使用 Percona 审计插件？-腾讯云开发者社区-腾讯云

MySQL 8.0 社区版如何使用 Percona 审计插件？

MySQL 8.0 社区版如何使用 Percona 审计插件？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐