MariaDB 日志详解:错误日志、慢查询日志与集群日志实战
MariaDB 日志中文详解:错误日志(log_error)、通用查询日志(general_log)、慢查询日志(log_slow_query/log_slow_query_time/log_slow_filter)、二进制日志(binlog)、Galera 集群日志特点,以及观测云 DataKit 采集告警落地方案。
MariaDB 从 MySQL 分叉而来,日志体系同源但有细节差异(变量命名默认值、特有开关如 log_slow_filter、Galera 集群日志)。本文讲解 MariaDB 各类日志的配置与实战要点,并说明如何集中检查各节点日志。
核心要点速览
- 四大日志与 MySQL 同源:错误日志、通用查询日志、慢查询日志、binlog,概念一致、参数略有差异。
- MariaDB 独有的慢日志增强:
log_slow_filter、log_slow_rate_limit等细粒度控制。 - Galera 集群结合 wsrep 日志和状态:节点加入与状态传输先查各节点错误日志,当前状态和流控还要查 wsrep 状态变量。
- 集中采集路径:DataKit 采集文件,Pipeline 解析,监控器告警。
1. 错误日志
[mariadb]
log_error = /var/log/mariadb/error.log
log_warnings = 2
记录启动/关闭、崩溃恢复、连接异常。错误日志的实际去向取决于启动方式和配置。上面文件的父目录需预先存在,MariaDB 进程需有写权限。若文件已存在,也要确认进程能写入。确认当前实例配置:
SHOW VARIABLES LIKE 'log_error';
Unix 上未设 log_error 时写到 stderr。由 systemd 捕获时可按实际服务名查看 journal,例如 journalctl -u mariadb;容器或其他进程管理器则要查各自的输出。文件日志轮转后需让 MariaDB 重新打开对应文件,避免继续写到旧文件。
2. 慢查询日志(MariaDB 增强版)
[mariadb]
log_output = FILE
log_slow_query = 1
log_slow_query_file = /var/log/mariadb/slow.log
log_slow_query_time = 1
log_queries_not_using_indexes = OFF
log_slow_rate_limit = 1
示例使用 MariaDB 10.11 起的变量名,旧名 slow_query_log、slow_query_log_file、long_query_time 在这些版本仍作为别名。示例使用耗时阈值,显式关闭未使用索引时绕过阈值的开关,也不对慢日志降采样。下列变量可用于进一步控制:
log_slow_filter:按全表扫描、filesort、临时表等执行特征筛选。not_using_index可绕过耗时阈值;打开前评估日志量,也可结合log_slow_min_examined_row_limit限定检查行数;log_slow_rate_limit:对符合条件的日志降采样,不能用写入条数推算慢查询总数。MariaDB 11.7 起,超过log_slow_always_query_time的极慢查询可绕过相关采样限制;log_slow_verbosity:向文件慢日志附加查询计划等信息,query_plan记录计划相关信息,explain可为支持的语句输出 EXPLAIN。表输出不支持此选项。
3. 通用查询日志
SHOW GLOBAL VARIABLES
WHERE Variable_name IN ('general_log', 'general_log_file', 'log_output');
通用查询日志在接收到客户端语句时记录,也记录连接和断开,不能用来判断事务是否提交。只在受控排障窗口启用 SET GLOBAL general_log = ON,结束后恢复原状态;日志量大且可能包含敏感值。 log_output 同时影响通用查询日志和慢查询日志,改成 TABLE 会把启用的日志写入相应表,而不是只改变通用日志。
4. 二进制日志
[mariadb]
log_bin = /var/log/mariadb/mariadb-bin
binlog_expire_logs_seconds = 604800
max_binlog_size = 1G
binlog 用于复制与时间点恢复,需要与可用备份配合。示例 binlog_expire_logs_seconds 要求 MariaDB 10.6.1 或更新版本;604800 秒是 7 天,是否够用取决于备份周期、恢复窗口和副本延迟。过期清理可在启动或轮转时检查,不能靠外部 logrotate 或手动删文件来管理。
5. Galera 集群日志
MariaDB 可搭配 Galera 做近同步多主复制。节点加入/离开及 SST、IST 等事件可查各节点错误日志中的 WSREP 信息;SST 失败还要看对应方法的传输日志。当前集群是否处于 Primary、节点是否就绪以及流控程度,需要用 wsrep 状态变量判断,不能只数日志行。采集时集群所有节点的错误日志都应收齐,按节点字段区分。
SHOW GLOBAL STATUS
WHERE Variable_name IN (
'wsrep_cluster_status',
'wsrep_cluster_size',
'wsrep_ready',
'wsrep_connected',
'wsrep_local_state_comment',
'wsrep_local_recv_queue_avg',
'wsrep_flow_control_paused'
);
wsrep_flow_control_paused 表示自上次 FLUSH STATUS 起因流控暂停的时间比例,需与接收队列及其他节点的状态一起看。
汇总节点日志并定位异常
Galera 排障需要同时看多个节点。将错误日志与慢日志写入文件后,可通过观测云 DataKit 文件采集指定实际可读的路径,保留实例、集群和节点标识。如果错误日志只进 journal 或容器输出,需使用对应来源,不能直接填不存在的文件。
为实际日志格式编写 Pipeline,解析事件时间、错误级别和慢查询耗时;慢日志包含多行 SQL 时,先确认一条记录没有被拆成多条。然后按同一时间窗比较节点日志,区分最先报错的节点与后续受影响节点。
对反复出现的 crash、wsrep 失败等记录,可在日志检测中限定节点或集群、过滤条件及计数阈值。错误日志与慢日志若需要不同保留时长,可配置原生日志索引的路由规则和存储策略。
常见问题(FAQ)
MariaDB 和 MySQL 的日志配置能直接互抄吗?
日志类型相近,但慢日志参数(如 log_slow_filter)、变量别名和输出配置有差异。错误日志去向还取决于部署方式。互抄前先核对两边的版本文档和实际变量值。
log_warnings 设多少合适?
MariaDB 文档给出的默认值为 2,实际值可能由部署配置覆盖。该变量只影响部分警告;先确认需要的消息级别,再临时调整,并在排查后恢复。
Galera 节点日志时间对不上怎么办?
集群排障依赖跨节点时间对齐——所有节点配置 NTP 校时;采集时用 Pipeline 将日志时间解析到 time 并核对时区。解析事件时间不会修正主机本身的时钟偏差。
慢日志分析和 MySQL 工具通用吗?
优先用 MariaDB 的 mariadb-dumpslow 汇总文件慢日志。某些安装仍提供旧名 mysqldumpslow;用其他分析工具前,应以当前版本和附加字段的样本核对解析结果,表输出则直接查询 mysql.slow_log。
系列阅读
- 上一篇:PostgreSQL 日志详解
- 下一篇:Redis 日志详解
- 相关阅读:MySQL 日志详解 | Linux 系统日志管理入门
[1]: 观测云文档《DataKit 日志采集综述》https://docs.guance.com/integrations/datakit-logging/
[2]: 观测云文档《日志查看器》https://docs.guance.com/logs/explorer/
[3]: 观测云文档《监控》https://docs.guance.com/monitoring/
MariaDB 官方参考:错误日志 · 慢查询日志 · 通用查询日志 · Binlog 管理 · Galera 状态变量