pt-query-digest是将慢查询日志转化为可行动结论的关键工具;需确保slow_query_log=ON、log_output=FILE、long_query_time≤1,并用--filter筛选高危模式,按Query_time:sum和Rows_examined:sum双维度排序,聚焦fingerprint而非原始SQL。

慢查询日志本身不直接告诉你哪条 SQL 在拖垮系统,pt-query-digest 才是把日志变成可行动结论的关键工具。没开日志、long_query_time 设太高、或只看单条最慢 SQL,这三类操作基本等于白忙。
确认慢查询日志真正在记录,而不是“开着但没写”
很多线上实例的 slow_query_log 看似是 ON,实则因权限、路径或配置冲突导致日志文件为空。必须立刻验证三项:
-
SHOW VARIABLES LIKE 'slow_query_log'—— 必须返回ON,不是OFF或空值 -
SHOW VARIABLES LIKE 'log_output'—— 必须是FILE;若为TABLE,pt-query-digest无法解析(MySQL 8.0 默认仍可能为TABLE) -
SHOW VARIABLES LIKE 'slow_query_log_file'—— 检查路径是否存在、MySQL 进程是否有写权限(常见于 SELinux 启用或目录属主为root)
顺手再跑一句:SELECT SLEEP(1.1),然后 tail -n 1 /var/log/mysql/slow.log,看是否真有新记录落盘。别信配置,信日志文件内容。
用 pt-query-digest --filter 快速筛掉干扰项
原始慢日志动辄几百 MB,全量分析既慢又容易被健康检查、定时任务等低危害语句淹没。用 --filter 提前聚焦才是高效做法:
- 查全表扫描:
pt-query-digest --filter '((event->{Full_scan}||"") eq "yes")' slow.log - 查 JOIN 没走索引:
pt-query-digest --filter '((event->{Full_join}||"") eq "yes")' slow.log - 排除监控探针:
--filter '$event->{fingerprint} !~ m/SELECT.*FROM health_check/i' - 只看某个业务库:
--filter '$event->{db} =~ m/^order_service$/'
注意:$event->{key} 中的字段名大小写敏感,且必须与日志中实际字段一致(如 Full_scan 不是 full_scan);Perl 正则必须用单引号包裹,否则 shell 会提前解析变量。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
排序逻辑决定你看到的是真相还是幻觉
pt-query-digest 默认按 Query_time:sum 排序是对的,但它掩盖了一个更危险的问题:有些 SQL 单次快(Query_time 低),但扫了上万行才返回一行(Rows_examined 高),这类语句在数据量翻倍后会突然爆炸。
- 先看总耗时大户:
pt-query-digest --order-by 'Query_time:sum' slow.log --limit 20 - 再看资源滥用大户:
pt-query-digest --order-by 'Rows_examined:sum' slow.log --limit 20 - 真正要盯紧的是两者都高的:
--order-by 'Query_time:sum,Rows_examined:sum'
报告头部的 # Profile 表里,重点看 Response time 列占比——超过 30% 的那 1–2 类才值得投入优化;占比不到 5% 的,即使排第一也没啥意义。
别跳过 fingerprint 和 Rows_examined / Rows_sent 比值
报告里每类 SQL 都有 fingerprint 字段(比如 SELECT * FROM orders WHERE user_id = ? AND status = ?),这是你建索引、改 SQL 的唯一依据。原始 SQL 带具体数值,毫无聚合价值。
- 人工复核时,第一眼就看
Rows_examined / Rows_sent这个比值;超过 100 就基本可以断定索引失效或缺失 - 这个比值比
EXPLAIN更早暴露问题——哪怕你还没连上数据库,光看报告就能判断“这里肯定要加复合索引” - 如果比值高但
Query_time低,说明当前数据量小,掩盖了问题;必须按未来 3–6 个月的数据增长预估压力
最后提醒一句:pt-query-digest 不会告诉你“该在 user_id 和 status 上建联合索引”,它只负责把问题放大到你眼皮底下。下一步怎么建、怎么验证、要不要覆盖索引,得你自己拿着 fingerprint 去 EXPLAIN。










