Debian MariaDB日志管理方法

Debian MariaDB日志管理实用指南

一 日志类型与默认路径

• 常见日志类型与用途如下（路径以 Debian 常见布局为例，具体以实际配置为准）：
  • 错误日志：记录数据库启动、运行错误与告警，默认路径通常为**/var/log/mysql/error.log**（部分系统可能为**/var/log/mariadb/mariadb.err**）。
  • 查询日志（General Query Log）：记录所有客户端执行的 SQL，默认多为未启用，启用后常见路径为**/var/log/mysql/general.log**。
  • 慢查询日志（Slow Query Log）：定位性能问题，默认多为未启用，启用后常见路径为**/var/log/mysql/slow-query.log**。
  • 二进制日志（Binlog）：用于主从复制与时间点恢复，常见路径为**/var/log/mysql/mysql-bin.log**。
  • 中继日志（Relay Log）：仅从库使用，位于数据目录（如**/var/lib/mysql/**）下，由复制进程自动管理。
  • 系统日志：通过 systemd 的 journalctl -u mariadb 可查看服务日志，适合排查服务层面的启动与崩溃信息。

二 启用与配置各类日志

• 配置目录与方式：Debian 中 MariaDB 的主配置通常位于**/etc/mysql/mariadb.conf.d/50-server.cnf**（或**/etc/my.cnf**），在 [mysqld] 段中设置相应参数，修改后需重启服务生效（如：sudo systemctl restart mariadb）。
• 常用配置示例（按需启用与调整）：
  • 错误日志（通常默认开启，可显式指定路径）
    • log_error = /var/log/mysql/error.log
  • 查询日志（调试环境建议临时开启，生产慎用）
    • general_log = 1
    • general_log_file = /var/log/mysql/general.log
  • 慢查询日志（性能优化常用）
    • slow_query_log = 1
    • slow_query_log_file = /var/log/mysql/slow-query.log
    • long_query_time = 2
    • log_queries_not_using_indexes = 1
  • 二进制日志（主从复制/恢复必备）
    • log_bin = /var/log/mysql/mysql-bin.log
    • server_id = 1（必须唯一）
    • binlog_format = ROW
    • expire_logs_days = 10（自动清理过期 Binlog）
    • max_binlog_size = 100M
  • 提示：开启查询日志会带来明显的 I/O 与磁盘占用，建议仅在排障时短期启用。

三 查看与检索日志

• 实时查看与检索常用命令：
  • 实时跟踪错误日志：sudo tail -f /var/log/mysql/error.log
  • 实时跟踪查询日志（若已启用）：sudo tail -f /var/log/mysql/general.log
  • 按时间查看系统日志：sudo journalctl -u mariadb --since “2025-09-01”
  • 关键字过滤：sudo grep ‘error’ /var/log/mysql/error.log
  • 分页查看：less /var/log/mysql/slow-query.log
• 建议结合时间戳、用户、主机与 SQL 关键字进行定位，慢查询日志可配合 pt-query-digest 等工具做深入分析。

四 日志轮转与清理

• 使用 logrotate 管理 MariaDB 文本日志（如 error.log、general.log、slow-query.log）：
  • 创建配置：/etc/logrotate.d/mysql
    • /var/log/mysql/*.log { daily rotate 30 compress delaycompress missingok notifempty create 640 mysql adm sharedscripts postrotate if [ -f /var/run/mysqld/mysqld.pid ]; then kill -USR1 $(cat /var/run/mysqld/mysqld.pid) fi endscript }
  • 说明：
    • daily/rotate/compress/delaycompress/missingok/notifempty/create 等为常用策略项。
    • MariaDB 对文件描述符的“重新打开”通常通过发送 USR1 信号完成（部分安装使用 /var/run/mysql/mysqld.pid 或 /var/run/mariadb/mariadb.pid，请按实际 pid 文件路径调整）。
    • 测试与强制执行：sudo logrotate -d /etc/logrotate.conf（语法检查），sudo logrotate -f /etc/logrotate.conf（强制执行一次）。
• 二进制日志的保留策略：
  • 优先使用参数控制保留天数（如 expire_logs_days = 10），避免无限增长；必要时可手动 PURGE BINARY LOGS。
• 系统级日志轮转：
  • logrotate 通常由 /etc/cron.daily/logrotate 每日定时执行，无需额外配置。

五 安全与运维建议

• 权限最小化：确保日志目录与文件属主为 mysql:adm，权限如 640，避免被非授权用户读取。
• 性能权衡：仅在需要时开启查询日志；为慢查询日志设置合理阈值（如 long_query_time = 2），并定期分析优化。
• 复制环境：主库合理设置 server_id 与 binlog_format=ROW；从库关注中继日志与复制延迟，避免磁盘被中继日志撑满。
• 容量规划：为 /var/log/mysql 与 /var/lib/mysql 挂载充足空间或使用独立分区；对历史日志做归档与压缩备份。
• 审计与合规：如需细粒度审计，可结合企业审计方案与复制/触发器等手段，避免长期开启通用查询日志带来的性能与合规风险。