必须启用慢查询日志并配置正确,即slow_query_log=on、long_query_time=1.0,写入my.cnf的[mysqld]段,重启mysql;python需用偏移轮询法实时解析日志,适配mysql 8.0时间格式,告警邮件须用app password、starttls及utf-8编码,脚本应通过flock+crontab运行并处理logrotate。

MySQL 慢查询日志是否已启用且格式正确
没开慢查询日志,后续所有监控都是空谈。必须确认 slow_query_log 为 ON,且 long_query_time 设定合理(例如 1.0 秒),否则大量低延迟但高代价的查询会被漏掉。
关键配置项需写入 my.cnf(通常是 /etc/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf)的 [mysqld] 段:
slow_query_log = ON slow_query_log_file = /var/log/mysql/mysql-slow.log long_query_time = 1.0 log_queries_not_using_indexes = OFF # 建议关闭,避免日志爆炸
改完必须重启 MySQL(systemctl restart mysql)或执行 SET GLOBAL slow_query_log = ON(仅临时生效)。注意:slow_query_log_file 路径的父目录需被 MySQL 进程(如 mysql 用户)有写权限,否则日志静默失败。
Python 脚本如何实时读取并解析慢查询日志
不能用普通 open() 全量读取——日志持续追加,文件可能很大;也不能依赖 tail -f 管道(Python 子进程易卡死)。推荐用 watchdog 库监听文件变更,或更轻量的轮询 + 文件偏移记录法。
核心逻辑是:记录上次读到的字节位置(存进 last_offset.txt),每次启动时 seek 到该位置,再读新增行。每行需匹配典型慢查询开头(如 # Time:、# User@Host:)来识别新条目。
示例片段(简化版):
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
with open('/var/log/mysql/mysql-slow.log', 'rb') as f:
f.seek(last_offset)
for line in f:
if line.startswith(b'# Time:'):
current_entry = []
current_entry.append(line.decode('utf-8', errors='ignore'))
if line.strip() == b'':
if len(current_entry) > 5: # 粗略过滤空条目
parse_and_alert(current_entry)
注意点:
-
errors='ignore'防止二进制日志中混入乱码导致解码中断 - MySQL 8.0+ 默认用 microsecond 时间戳,日志行格式略有变化,正则需适配
# Time: [0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[0-9]{6}Z - 别在循环里频繁发邮件——用队列或时间窗口去重(比如 5 分钟内同 SQL 只报一次)
用 Python 发送告警邮件时 SMTP 配置常见失败原因
本地 sendmail 不可靠,直接走 SMTP 最可控。但 90% 的失败集中在三处:SMTP AUTH 被拒、端口被封、发信地址未认证。
以 Gmail 为例(其他邮箱类似):
- 必须开启「App Password」而非账户密码(两步验证开启后,原密码无效)
- 使用
smtp.gmail.com,端口587(STARTTLS),不是465(SSL)——Pythonsmtplib.SMTP默认不支持 SSL 封装 - 发件人地址(
From:)必须和登录账号一致,否则多数服务商拒收 - 邮件正文务必设
Content-Type: text/plain; charset=utf-8,否则中文变问号
最小可用发送代码:
import smtplib
from email.mime.text import MIMEText
msg = MIMEText('慢查询:SELECT * FROM orders WHERE status=...\n耗时:3.2s', 'plain', 'utf-8')
msg['Subject'] = '【MySQL慢查告警】'
msg['From'] = 'alert@gmail.com'
msg['To'] = 'admin@example.com'
<p>s = smtplib.SMTP('smtp.gmail.com', 587)
s.starttls()
s.login('alert@gmail.com', 'your_app_password_here')
s.send_message(msg)
s.quit()</p>
如何避免脚本本身成为系统负担或漏报
这个监控脚本一旦跑歪,要么吃光 CPU(高频轮询)、要么丢掉日志(崩溃后不恢复偏移)。上线前必须做两件事:
- 用
crontab每分钟拉起一次(而不是常驻进程),配合文件锁(flock)防重复执行:* * * * * flock -n /tmp/mysql-slow-alert.lock -c '/usr/bin/python3 /opt/scripts/slow_alert.py' - 偏移文件(
last_offset.txt)要定期校验:如果日志文件大小小于记录的 offset,说明日志被轮转(logrotate)了,得重置为 0 - SQL 解析不要做完整语法分析——提取
Query_time:、Lock_time:、第一行SELECT/UPDATE和表名即可,复杂度控制在毫秒级
真正难的是日志轮转场景:MySQL 自身不支持自动切割,通常靠 logrotate 配合 flush-logs。脚本必须检测 mysql-slow.log.1 这类归档文件,否则轮转瞬间的慢查询就丢了。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










