MariaDB 日志详解:错误日志、慢查询日志与集群日志实战

MariaDB 日志中文详解:错误日志(log_error)、通用查询日志(general_log)、慢查询日志(log_slow_query/log_slow_query_time/log_slow_filter)、二进制日志(binlog)、Galera 集群日志特点,以及观测云 DataKit 采集告警落地方案。

最佳实践
MariaDB 日志详解:错误日志、慢查询日志与集群日志实战技术指南封面

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。

系列阅读


[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 状态变量

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台