要配置审核日志文件名，请 audit_log_file在服务器启动时设置系统变量。默认名称 audit.log位于服务器数据目录中。为了获得最佳安全性，将审计日志写入一个目录，该目录只能由 MySQL 服务器和有正当理由查看日志的用户访问。

从 MySQL 5.7.21 开始，插件将 audit_log_file值解释为由可选的前导目录名称、基本名称和可选的后缀组成。如果启用了压缩或加密，则有效文件名（实际用于创建日志文件的名称）与配置的文件名不同，因为它具有额外的后缀：

有效审计日志文件名是将适用的压缩和加密后缀添加到配置的文件名后得到的名称。例如，如果配置 audit_log_file值为 audit.log，则有效文件名是下表中显示的值之一。

在 MySQL 5.7.21 之前，配置的和有效的日志文件名是相同的。例如，如果配置 audit_log_file值为 audit.log，审计日志插件将写入 audit.log.

审计日志插件根据有效的审计日志文件名在初始化和终止期间执行某些操作：

从 MySQL 5.7.21 开始：

在 MySQL 5.7.21 之前，只有 XML 日志格式可用，插件执行基本的完整性检查：

要配置审计日志文件格式，请 audit_log_format在服务器启动时设置系统变量。这些格式可用：

有关每种格式的详细信息，请参阅 第 6.4.5.4 节，“审计日志文件格式”。

如果你改变 audit_log_format了，建议你也改变 audit_log_file。例如，如果您设置audit_log_format 为JSON，则设置 audit_log_file为 audit.json。否则，较新的日志文件将具有与旧文件不同的格式，但它们都将具有相同的基本名称，并且不会指示格式何时更改。

从 MySQL 5.7.21 开始，审计日志文件压缩可用。可以为任何日志格式启用压缩。

要配置审计日志文件压缩，请 audit_log_compression在服务器启动时设置系统变量。允许的值为 NONE（无压缩；默认值）和 GZIP（GNU Zip 压缩）。

如果同时启用压缩和加密，则压缩发生在加密之前。要手动恢复原始文件，请先解密，然后解压缩。请参阅 手动解压缩和解密审计日志文件。

从 MySQL 5.7.21 开始，审计日志文件加密可用。可以为任何日志格式启用加密。加密基于用户定义的密码（审计日志插件生成的初始密码除外）。要使用此功能，必须启用 MySQL 密钥环，因为审核日志记录使用它来存储密码。可以使用任何密钥环插件；有关说明，请参阅第 6.4.4 节，“MySQL 密钥环”。

要配置审计日志文件加密，请 audit_log_encryption在服务器启动时设置系统变量。允许的值为 NONE（无加密；默认值）和 AES（AES-256-CBC 密码加密）。

要在运行时设置或获取加密密码，请使用这些审计日志函数：

有关审核日志加密功能的其他信息，请参阅审核日志功能。

审计日志插件在初始化时，如果发现启用了日志文件加密，则检查keyring是否包含审计日志加密密码。如果没有，插件会自动生成一个随机的初始加密密码并将其存储在密钥环中。要发现此密码，请调用 audit_log_encryption_password_get().

如果同时启用压缩和加密，则压缩发生在加密之前。要手动恢复原始文件，请先解密，然后解压缩。请参阅 手动解压缩和解密审计日志文件。

可以使用标准工具解压缩和解密审计日志文件。这应该只对已关闭（存档）且不再使用的日志文件执行，而不是审计日志插件当前正在写入的日志文件。您可以识别归档日志文件，因为它们已被审计日志插件重命名为在基本名称之后的文件名中包含时间戳。

对于此讨论，假设 audit_log_file设置为 audit.log。在这种情况下，存档的审核日志文件具有下表中显示的名称之一。

要手动解压缩压缩日志文件，请使用 gunzip、gzip -d或等效命令。例如：

gunzip -c audit.timestamp.log.gz > audit.timestamp.log

要手动解密加密的日志文件，请使用 openssl命令。例如：

openssl enc -d -aes-256-cbc -pass pass:password -md sha256
    -in audit.timestamp.log.enc
    -out audit.timestamp.log

如果为审计日志启用了压缩和加密，则压缩发生在加密之前。在这种情况下，文件名添加了.gz和 .enc后缀，对应于这些操作发生的顺序。要手动恢复原始文件，请执行相反的操作。即先解密文件，再解压：

openssl enc -d -aes-256-cbc -pass pass:password -md sha256
    -in audit.timestamp.log.gz.enc
    -out audit.timestamp.log.gz
gunzip -c audit.timestamp.log.gz > audit.timestamp.log

审核日志文件有可能变得非常大并占用大量磁盘空间。为了管理使用的空间，可以使用日志轮换。这涉及通过重命名来旋转当前日志文件，然后使用原始名称打开一个新的当前日志文件。旋转可以手动执行，或配置为自动发生。

要配置审计日志文件空间管理，请使用以下系统变量：

The following sections describe log file rotation in greater detail.

Manual Audit Log File Rotation

If audit_log_rotate_on_size is 0 (the default), no log rotation occurs unless performed manually. In this case, the audit log plugin closes and reopens the log file when the audit_log_flush value changes from disabled to enabled. Log file renaming must be done externally to the server. Suppose that the log file name is audit.log and you want to maintain the three most recent log files, cycling through the names audit.log.1 through audit.log.3. On Unix, perform rotation manually like this:

Automatic Audit Log File Rotation

If audit_log_rotate_on_size is greater than 0, setting audit_log_flush has no effect. Instead, whenever a write to the current log file causes its size to exceed the audit_log_rotate_on_size value, the audit log plugin automatically renames the current log file and opens a new current log file using the original name.

Automatic size-based rotation also occurs under these conditions:

The plugin renames the original file as follows:

The audit log plugin can use any of several strategies for log writes. Regardless of strategy, logging occurs on a best-effort basis, with no guarantee of consistency.

To specify a write strategy, set the audit_log_strategy system variable at server startup. By default, the strategy value is ASYNCHRONOUS and the plugin logs asynchronously to a buffer, waiting if the buffer is full. It's possible to tell the plugin not to wait (PERFORMANCE) or to log synchronously, either using file system caching (SEMISYNCHRONOUS) or forcing output with a sync() call after each write request (SYNCHRONOUS).

For asynchronous write strategy, the audit_log_buffer_size system variable is the buffer size in bytes. Set this variable at server startup to change the buffer size. The plugin uses a single buffer, which it allocates when it initializes and removes when it terminates. The plugin does not allocate this buffer for nonasynchronous write strategies.

Asynchronous logging strategy has these characteristics:

使用异步日志记录时，如果在写入文件期间出现问题或插件未完全关闭（例如，在服务器主机意外退出的情况下），则日志文件的完整性可能会受到损害。为了降低这种风险，设置 audit_log_strategy为使用同步日志记录。

策略的一个缺点PERFORMANCE是它会在缓冲区已满时丢弃事件。对于负载很重的服务器，审计日志可能缺少事件。