MySQL 错误日志详解
MySQL 的错误日志(Error Log)是数据库管理中一种至关重要的日志,它记录了服务器启动与关闭过程中的关键信息,以及运行期间发生的各种故障、异常和需要关注的事件。
错误日志内容概览
错误日志详细记录了 mysqld 服务的启动与终止时间戳。此外,它还包含诊断性消息,如服务器在启动、关闭或运行过程中遇到的错误、警告以及其他需要特别注意的信息。例如,当 mysqld 检测到某个表需要检查或修复时,相关信息会被写入错误日志。根据配置,错误信息也可能被同步到 performance_schema.error_log 表,从而允许通过 SQL 接口查询错误日志。如果使用 mysqld_safe 启动 mysqld,mysqld_safe 会将相关消息写入错误日志,包括 mysqld 异常退出后的重启信息。
错误日志的启用与配置
错误日志在 MySQL 中默认启用,且无法被禁用。默认情况下,日志文件存储在 MySQL 的数据目录中,文件名为 mysqld.log(Linux 系统)或 hostname.err(macOS 系统)。
如需自定义日志文件名或路径,可在配置文件 (my.cnf 或 my.ini) 的 [mysqld] 部分添加以下配置:
log-error = /path/to/your/error.log
修改配置后,必须重启 MySQL 服务才能使更改生效。
查看错误日志
错误日志以纯文本文件的形式存储,可使用任意文本编辑器直接打开查阅。要确定日志文件的具体路径,可以执行以下 SQL 查询:
mysql> SHOW VARIABLES LIKE 'log_error%';
查询结果将显示 log_error 变量的值,即错误日志文件的完整路径。
关键配置参数解析
log_error: 指定错误日志文件的路径。log_error_services: 控制错误日志的启用组件。该变量可包含一个或多个组件,以分号(或 MySQL 8.0.12 及以上版本中的逗号)分隔。服务器将按顺序处理这些组件。默认配置通常为log_filter_internal; log_sink_internal。log_error_suppression_list: 用于抑制错误日志中特定事件的记录。log_error_verbosity: 控制日志记录的详细程度。- 值为
1: 仅记录ERROR级别的消息。 - 值为
2: 记录ERROR和WARNING级别的消息。 - 值为
3: 记录ERROR、WARNING和INFORMATION级别的消息。
3,以便获取更全面的日志信息,便于问题排查。- 值为
log_timestamps 参数:控制日志时间显示
MySQL 5.7.2 版本引入了 log_timestamps 参数,用于控制错误日志等记录的显示时间戳格式。在新版本中,该参数默认设置为 UTC。这可能导致日志中的时间比本地时间(例如北京时间)晚 8 小时,给查看和分析日志带来不便。
查看当前配置:
mysql> SHOW GLOBAL VARIABLES LIKE 'log_timestamps';
修改方法:
- MySQL 5.7:
- 执行
SET GLOBAL log_timestamps = 'system'; - 在配置文件
my.cnf的[mysqld]部分添加log_timestamps = system。
- 执行
- MySQL 8.0:
- 执行
SET GLOBAL log_timestamps = 'system';
- 执行
为方便国内用户阅读日志,建议将 log_timestamps 设置为 system,并将其写入配置文件。MySQL 8.0 支持此参数的持久化设置。
日志刷新与删除
随着时间的推移,错误日志文件可能会变得非常庞大。为了释放磁盘空间并便于管理,可以定期删除旧的错误日志文件。由于错误日志是普通文本文件,可以直接在文件系统中删除。
执行 FLUSH LOGS 命令(或 mysqladmin flush-logs)的效果如下:
- MySQL 5.5.7 之前的版本:
FLUSH LOGS会将当前的错误日志文件重命名为filename.err_old,并创建一个新的日志文件。 - MySQL 5.5.7 及之后的版本:
FLUSH LOGS仅重新打开日志文件,不会自动进行备份或创建新文件。
如果日志文件不存在,MySQL 在启动或执行 FLUSH LOGS 时会自动创建新的日志文件,其大小为 0 字节。
如果遇到无法刷新日志的情况(例如权限问题),可能需要手动创建日志文件,如:
# 示例命令,请根据实际情况调整用户和权限
install -omysql -gmysql -m0644 /dev/null /var/log/mysqld.log