pt-deadlock-logger是Percona Toolkit中专用于持续捕获、结构化记录MySQL死锁事件的工具,通过轮询INFORMATION_SCHEMA表主动发现死锁,而SHOW ENGINE INNODB STATUS仅保留最近一次死锁且为非结构化文本,易被覆盖、难分析。

pt-deadlock-logger 是什么,为什么不用 SHOW ENGINE INNODB STATUS
pt-deadlock-logger 是 Percona Toolkit 中专用于**持续捕获、结构化记录 MySQL 死锁事件**的工具。它不依赖人工触发,而是通过轮询 INFORMATION_SCHEMA.INNODB_TRX、INFORMATION_SCHEMA.INNODB_LOCK_WAITS 等表,主动发现并日志化死锁发生时的完整上下文(包括事务 ID、SQL、等待锁类型、持有锁对象、时间戳等)。
而 SHOW ENGINE INNODB STATUS\G 只保留**最近一次**死锁信息,高并发场景下极易被覆盖;且输出是纯文本块,无时间戳、无结构字段、难做聚合分析——线上出问题时你大概率已经看不到“现场”了。
MySQL 5.7 下 pt-deadlock-logger 的最小可行配置
确保已安装 Percona Toolkit(v3.3+ 兼容 MySQL 5.7),然后用以下命令启动采集:
pt-deadlock-logger --host=localhost --user=root --password=xxx \ --dest D=percona,t=deadlocks \ --run-time=86400 \ --interval=30 \ --create-dest-table \ --no-column-names
关键参数说明:
-
--dest D=percona,t=deadlocks:指定结果存入percona.deadlocks表(需提前建库) -
--create-dest-table:自动创建符合规范的目标表(含ts、server、thread、txn_id、username、hostname、ip、db、tbl、idx、lock_type、lock_mode、wait_time、query等字段) -
--interval=30:每 30 秒扫描一次锁等待状态,太短会增加开销,太长可能漏掉瞬时死锁 -
--run-time=86400:运行 24 小时后自动退出(建议配合 systemd 或 cron 控制生命周期)
注意:pt-deadlock-logger 不需要 SUPER 权限,但要求用户对 INFORMATION_SCHEMA 有 SELECT 权限,且对目标 --dest 表有 INSERT/CREATE 权限。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
容易踩的坑:权限、隔离级别与误报
常见失败现象:pt-deadlock-logger 启动后无日志写入、报错 Access denied、或日志里全是 NULL 查询语句。
- MySQL 5.7 默认开启
performance_schema,但某些安全加固配置会禁用INFORMATION_SCHEMA.INNODB_LOCK_WAITS——请确认SELECT COUNT(*) FROM INFORMATION_SCHEMA.INNODB_LOCK_WAITS;能返回非零值 - 如果应用使用
READ COMMITTED隔离级别,部分锁等待可能在语句结束即释放,pt-deadlock-logger扫描间隙中抓不到完整链条,导致漏报;建议生产环境统一用REPEATABLE READ -
--no-column-names必须加,否则插入目标表时会把列名当数据写入(第一行变成 "ts server ..." 字符串) - 不要用 root@localhost 连接从库采集——从库 SQL 线程卡住时,
INNODB_TRX中的trx_query可能为空或截断,实际死锁发生在主库,应只在主库部署该工具
怎么查和用这些死锁日志
日志存进 percona.deadlocks 后,直接查表即可,例如:
SELECT ts, db, tbl, idx, query, wait_time FROM percona.deadlocks WHERE ts > NOW() - INTERVAL 1 HOUR ORDER BY ts DESC LIMIT 10;
重点看这三列:
-
query:触发死锁的原始 SQL(注意:可能被截断,需结合wait_time和idx判断是否走对索引) -
tbl+idx:锁定涉及的表和索引,快速定位是否因缺失索引或用了全表扫描导致锁范围过大 -
wait_time:事务等待秒数,> 50 毫秒基本可判定为真实阻塞,
真正麻烦的是那些 query 字段为空、但 tbl 和 idx 明确的记录——这往往意味着死锁由隐式锁(如外键级联、唯一约束检查)引发,不在业务 SQL 里,得翻 binlog + error log 对齐时间点。










