官方文档: pt-query-digest
下载地址: DOWNLOADING
pt-query-digest 简介
pt-query-digest是用于分析mysql慢查询的一个工具,它可以分析binlog、General log、slowlog,也可以通过SHOWPROCESSLIST或者通过tcpdump抓取的MySQL协议数据来进行分析。可以把分析结果输出到文件中,分析过程是先对查询语句的条件进行参数化,然后对参数化以后的查询进行分组统计,统计出各查询的执行时间、次数、占比等,可以借助分析结果找出问题进行优化。
pt-query-digest 安装
下载软件包
1
wget percona.com/get/percona-toolkit.tar.gz
或者使用
wget percona.com/get/TOOL
命令下载单个工具,将 TOOL 换成想下载的工具名称1
wget percona.com/get/pt-query-digest
安装 perl 模块
1
yum install -y perl-CPAN perl-Time-HiRes
安装步骤
1
2
3
4
5
6
7
8
9
10
11
12
13
14# RPM 安装
cd /usr/local/src
wget percona.com/get/percona-toolkit.rpm
yum install -y percona-toolkit.rpm
# 源码安装(推荐)
cd /usr/local/src
wget percona.com/get/percona-toolkit.tar.gz
tar zxvf percona-toolkit.tar.gz
cd percona-toolkit-3.3.1
perl Makefile.PL PREFIX=/usr/local/percona-toolkit
make && make install各种工具用法文档Percona Toolkit Documentation
pt-query-digest 使用
语法
1 | pt-query-digest [OPTIONS] [FILES] [DSN] |
重要选项
--create-review-table
: 当使用--review
参数把分析结果输出到表中时,如果没有表就自动创建;--create-history-table
: 当使用--history
参数把分析结果输出到表中时,如果没有表就自动创建;--filter
: 对输入的慢查询按指定的字符串进行匹配过滤后再进行分析;--limit
: 限制输出结果百分比或数量,默认值是20,即将最慢的 20 条语句输出,如果是 50% 则按总响应时间占比从大到小排序,输出到总和达到50% 位置截止;--host
: mysql服务器地址;--user
: mysql用户名;--password
: mysql用户密码;--history
: 将分析结果保存到表中,分析结果比较详细,下次再使用--history
时,如果存在相同的语句,且查询所在的时间区间和历史表中的不同,则会记录到数据表中,可以通过查询同一CHECKSUM
来比较某类型查询的历史变化;--review
: 将分析结果保存到表中,这个分析只是对查询条件进行参数化,一个类型的查询一条记录,比较简单。当下次使用--review
时,如果存在相同的语句分析,就不会记录到数据表中;--output
: 分析结果输出类型,值可以是report
(标准分析报告)、slowlog
(Mysql slow log)、json
、json-anon
,一般使用report
,以便于阅读;--since
: 从什么时间开始分析,值为字符串,可以是指定的某个yyyy-mm-dd [hh:mm:ss]
格式的时间点,也可以是简单的一个时间值:s(秒)、h(小时)、m(分钟)、d(天),如12h就表示从12小时前开始统计;--until
: 截止时间,配合-—since
可以分析一段时间内的慢查询。
示例
pt-query-digest 主要用来分析 mysql 的慢日志,与 mysqldumpshow 工具相比,py-query_digest 工具的分析结果更具体,更完善。
1 | pt-query-digest /data/mysql/mysql-slow.log |
常用的用法分析
直接分析慢查询文件:
1
pt-query-digest /data/mysql/mysql-slow.log > slow_report.log
分析最近12小时内的查询:
1
pt-query-digest --since=12h /data/mysql/mysql-slow.log > slow_report2.log
分析指定时间范围内的查询:
1
2
3pt-query-digest /data/mysql/mysql-slow.log \
--since '2021-08-01 09:30:00' \
--until '2021-08-03 09:30:00' > slow_report3.log分析指含有 select 语句的慢查询
1
pt-query-digest --filter '$event->{fingerprint} =~ m/^select/i' /data/mysql/mysql-slow.log > slow_report4.log
针对某个用户的慢查询
1
pt-query-digest --filter '($event->{user} || "") =~ m/^root/i' /data/mysql/mysql-slow.log > slow_report5.log
查询所有的全表扫描或
full join
的慢查询1
2
3pt-query-digest \
--filter '(($event->{Full_scan} || "") eq "yes") ||(($event->{Full_join} || "") eq "yes")' \
/data/mysql/mysql-slow.log > slow_report6.log
pt-query-digest 报告分析
pt-query-digest 的报告导出信息如下所示:
1 | # 30.1s user time, 2.5s system time, 28.40M rss, 218.48M vsz |
第一部分, 总体统计结果
- Overall:总共有多少条查询
- Time range:查询执行的时间范围
- unique:唯一查询数量,即对查询条件进行参数化以后,总共有多少个不同的查询
- total:总计
- min:最小
- max:最大
- avg:平均
- 95%:把所有值从小到大排列,位置位于95%的那个数,这个数一般最具有参考价值
- median:中位数,把所有值从小到大排列,位置位于中间那个数
第二部分, 查询分组统计结果
- Rank:所有语句的排名,默认按查询时间降序排列,通过
--order-by
指定 - Query ID:语句的ID,(去掉多余空格和文本字符,计算hash值)
- Response:总的响应时间
- time:该查询在本次分析中总的时间占比
- calls:执行次数,即本次分析总共有多少条这种类型的查询语句
- R/Call:平均每次执行的响应时间
- V/M:响应时间Variance-to-mean的比率
- Item:查询对象
第三部分, 每一种查询的详细统计结果
- ID:查询的ID号,和上图的Query ID对应
- Databases:数据库名
- Users:各个用户执行的次数(占比)
- Query_time distribution :查询时间分布, 长短体现区间占比。
- Tables:查询中涉及到的表
- Explain:SQL语句