使用說明
shell> pt-query-digest [OPTIONS] [DSN]
詳情可參考
shell>pt-query-digest --help
常用參數：
--create-review-table ：當使用--review參數把分析結果輸出到表中時，如果沒有表就自動創建。
--create-history-table：當使用--history參數把分析結果輸出到表中時，如果沒有表就自動創建。
--filter ： 對輸入的慢查詢按指定的字符串進行匹配過濾後再進行分析
--limit：限制輸出結果百分比或數量，默認值是20,即將最慢的20條語句輸出，如果是95%則按總響應時間佔比從大到小排序，輸出到總和達到95%位置截止。
--log=s ：指定輸出的日誌文件
--history 將分析結果保存到表中，分析結果比較詳細，下次再使用--history時，如果存在相同的語句，且查詢所在的時間區間和歷史表
中的不同，則會記錄到數據表中，可以通過查詢同一CHECKSUM來比較某類型查詢的歷史變化。
--review：將分析結果保存到表中，這個分析只是對查詢條件進行參數化，一個類型的查詢一條記錄，比較簡單。
當下次使用--review時，如果存在相同的語句分析，就不會記錄到數據表中。
--output 分析結果輸出類型，值可以是report(標準分析報告)、slowlog(Mysql slow log)、json、json-anon，一般使用report，以便於閱讀。
--since：從該指定日期開始分析。
--until：截止時間，配合—since可以分析一段時間內的慢查詢。
使用示例
a) pt-query-digest分析慢查詢日誌
shell> pt-query-digest --report slow.log
b) 報告最近半個小時的慢查詢：
shell> pt-query-digest --report --since 1800s slow.log
c) 報告一個時間段的慢查詢：
shell> pt-query-digest --report --since '2013-02-10 21:48:59' --until '2013-02-16 02:33:50' slow.log
d) 報告只含select語句的慢查詢:
shell> pt-query-digest --filter '$event->{fingerprint} =~ m/^select/i' slow.log
e) 報告針對某個用戶的慢查詢:
shell> pt-query-digest --filter '($event->{user} || "") =~ m/^root/i' slow.log
f) 報告所有的全表掃描或full join的慢查詢:
shell> pt-query-digest --filter '(($event->{Full_scan} || "") eq "yes") || (($event->{Full_join} || "") eq "yes")' slow.log
g) 把查詢保存到query_review表
shell> pt-query-digest --user=root –password=abc123 --review h=localhost,D=test,t=query_review
--create-review-table slow.log
h) 把查詢保存到query_history表
shell> pt-query-digest --user=root –password=abc123 --history h=localhost,D=test,t=query_history
--create-history-table slow.log
i) 通過tcpdump抓取mysql的tcp協議數據，然後再分析
shell> tcpdump -s 65535 -x -nn -q -tttt -i any -c 1000 port 3306 > mysql.tcp.txt
shell> pt-query-digest --type tcpdump mysql.tcp.txt> slow_report.log
j) 分析binlog
shell> mysqlbinlog mysql-bin.000093 > mysql-bin000093.sql
shell> pt-query-digest --type=binlog mysql-bin000093.sql > slow_report.log
k) 分析general log
shell> pt-query-digest --type=genlog localhost.log > slow_report.log
如下爲輸入結果示例：
pt-query-digest /var/lib/mysql/localhost-slow.log
# 70ms user time, 100ms system time, 25.46M rss, 222.04M vsz
# Current date: Sun Sep 4 19:41:48 2016
# Hostname: localhost.localdomain
# Files: /var/lib/mysql/localhost-slow.log
# Overall: 1 total, 1 unique, 0 QPS, 0x concurrency ______________________
# Time range: all events occurred at 2016-09-05T02:19:47
# Attribute total min max avg 95% stddev median
# ============ ======= ======= ======= ======= ======= ======= =======
# Exec time 12s 12s 12s 12s 12s 0 12s
# Lock time 19ms 19ms 19ms 19ms 19ms 0 19ms
# Rows sent 0 0 0 0 0 0 0
# Rows examine 785.25k 785.25k 785.25k 785.25k 785.25k 0 785.25k
# Query size 41 41 41 41 41 0 41
# Profile
# Rank Query ID Response time Calls R/Call V/M Item
# ==== ================== ============== ===== ======= ===== =============
# 1 0xE8455DF24FC49F59 11.5505 100.0% 1 11.5505 0.00 INSERT SELECT tb_slow
# Query 1: 0 QPS, 0x concurrency, ID 0xE8455DF24FC49F59 at byte 0 ________
# This item is included in the report because it matches --limit.
# Scores: V/M = 0.00
# Time range: all events occurred at 2016-09-05T02:19:47
# Attribute pct total min max avg 95% stddev median
# ============ === ======= ======= ======= ======= ======= ======= =======
# Count 100 1
# Exec time 100 12s 12s 12s 12s 12s 0 12s
# Lock time 100 19ms 19ms 19ms 19ms 19ms 0 19ms
# Rows sent 0 0 0 0 0 0 0 0
# Rows examine 100 785.25k 785.25k 785.25k 785.25k 785.25k 0 785.25k
# Query size 100 41 41 41 41 41 0 41
# String:
# Databases test
# Hosts localhost
# Users root
# Query_time distribution
# 1us
# 10us
# 100us
# 1ms
# 10ms
# 100ms
# 1s
# 10s+ ################################################################
# Tables
# SHOW TABLE STATUS FROM `test` LIKE 'tb_slow'\G
# SHOW CREATE TABLE `test`.`tb_slow`\G
insert into tb_slow select * from tb_slow\G
[root@localhost percona-toolkit]# pt-query-digest /var/lib/mysql/localhost-slow.log --user=root --password^C
[root@localhost percona-toolkit]# clear
[root@localhost percona-toolkit]# pt-query-digest /var/lib/mysql/localhost-slow.log --user=root --password=root --review h='localhost',D=test,t=global_query_review --no-report --create-review-table
*******************************************************************
Using the default of SSL_verify_mode of SSL_VERIFY_NONE for client
is deprecated! Please set SSL_verify_mode to SSL_VERIFY_PEER
together with SSL_ca_file|SSL_ca_path for verification.
If you really don't want to verify the certificate and keep the
connection open to Man-In-The-Middle attacks please set
SSL_verify_mode explicitly to SSL_VERIFY_NONE in your application.
*******************************************************************
at /usr/bin/pt-query-digest line 11879.
*******************************************************************
Using the default of SSL_verify_mode of SSL_VERIFY_NONE for client
is deprecated! Please set SSL_verify_mode to SSL_VERIFY_PEER
together with SSL_ca_file|SSL_ca_path for verification.
If you really don't want to verify the certificate and keep the
connection open to Man-In-The-Middle attacks please set
SSL_verify_mode explicitly to SSL_VERIFY_NONE in your application.
*******************************************************************
at /usr/bin/pt-query-digest line 11879.
將分析結果可視化
使用pt-query-digest分析慢查詢日誌並將查詢分析數據保存到MySQL數據庫表中.然後使用應用程序來展示分析結果.
目前有基於LAMP的Query-Digest-UI、Anemometer開源項目支持。
將慢日誌插入表中：
shell> pt-query-digest --user=root --password=abc224 --review h='10.10.10.134',D=test,t=global_query_review --history h='10.10.10.134',D=test,t=global_query_review_history --no-report --create-review-table --create-history-table --limit=20% slowquery.log
或者
shell> pt-query-digest --user=root --password=abc224 --review h='10.10.10.134',D=test,t=global_query_review --no-report --create-review-table slowquery.log
shell> pt-query-digest --user=root --password=abc224 --history h='10.10.10.134',D=test,t=global_query_review_history --no-report --create-history-table slowquery.log
mysql> select * from global_query_review limit 2 \G
*************************** 1. row ***************************
checksum: 300935684267402542
fingerprint: call test.confixinverstweek
sample: CALL test.confixinverstweek('2014-07-01','2014-07-10',0.0060)
first_seen: 2014-07-09 14:35:29
last_seen: 2014-07-14 08:04:11
reviewed_by: NULL
reviewed_on: NULL
comments: NULL
mysql> select * from global_query_review_history limit 1 \G
*************************** 1. row ***************************
checksum: 300935684267402542
sample: CALL test.confixinverstweek('2014-07-01','2014-07-10',0.0060)
ts_min: 2014-07-09 14:35:29
ts_max: 2014-07-14 08:04:11
ts_cnt: 4
Query_time_sum: 419674
Query_time_min: 13882.8
Query_time_max: 227433
Query_time_pct_95: 216908
Query_time_stddev: 90097.8
Query_time_median: 189384
Lock_time_sum: 0
Lock_time_min: 0
Lock_time_max: 0
Lock_time_pct_95: 0
Lock_time_stddev: 0
Lock_time_median: 0
Rows_sent_sum: 0
Rows_sent_min: 0
Rows_sent_max: 0
Rows_sent_pct_95: 0
Rows_sent_stddev: 0
Rows_sent_median: 0
Rows_examined_sum: 0
Rows_examined_min: 0
Rows_examined_max: 0
Rows_examined_pct_95: 0
Rows_examined_stddev: 0
Rows_examined_median: 0
Rows_affected_sum: NULL
Rows_affected_min: NULL
Rows_affected_max: NULL
Rows_affected_pct_95: NULL
Rows_affected_stddev: NULL
Rows_affected_median: NULL
Rows_read_sum: NULL
Rows_read_min: NULL
Rows_read_max: NULL
Rows_read_pct_95: NULL
Rows_read_stddev: NULL
Rows_read_median: NULL
Merge_passes_sum: NULL
Merge_passes_min: NULL
Merge_passes_max: NULL
Merge_passes_pct_95: NULL
Merge_passes_stddev: NULL
Merge_passes_median: NULL
InnoDB_IO_r_ops_min: NULL
InnoDB_IO_r_ops_max: NULL
InnoDB_IO_r_ops_pct_95: NULL
InnoDB_IO_r_ops_stddev: NULL
InnoDB_IO_r_ops_median: NULL
InnoDB_IO_r_bytes_min: NULL
InnoDB_IO_r_bytes_max: NULL
InnoDB_IO_r_bytes_pct_95: NULL
InnoDB_IO_r_bytes_stddev: NULL
InnoDB_IO_r_bytes_median: NULL
InnoDB_IO_r_wait_min: NULL
InnoDB_IO_r_wait_max: NULL
InnoDB_IO_r_wait_pct_95: NULL
InnoDB_IO_r_wait_stddev: NULL
InnoDB_IO_r_wait_median: NULL
InnoDB_rec_lock_wait_min: NULL
InnoDB_rec_lock_wait_max: NULL
InnoDB_rec_lock_wait_pct_95: NULL
InnoDB_rec_lock_wait_stddev: NULL
InnoDB_rec_lock_wait_median: NULL
InnoDB_queue_wait_min: NULL
InnoDB_queue_wait_max: NULL
InnoDB_queue_wait_pct_95: NULL
InnoDB_queue_wait_stddev: NULL
InnoDB_queue_wait_median: NULL
InnoDB_pages_distinct_min: NULL
InnoDB_pages_distinct_max: NULL
InnoDB_pages_distinct_pct_95: NULL
InnoDB_pages_distinct_stddev: NULL
InnoDB_pages_distinct_median: NULL
QC_Hit_cnt: NULL
QC_Hit_sum: NULL
Full_scan_cnt: NULL
Full_scan_sum: NULL
Full_join_cnt: NULL
Full_join_sum: NULL
Tmp_table_cnt: NULL
Tmp_table_sum: NULL
Tmp_table_on_disk_cnt: NULL
Tmp_table_on_disk_sum: NULL
Filesort_cnt: NULL
Filesort_sum: NULL
Filesort_on_disk_cnt: NULL
Filesort_on_disk_sum: NULL
1 row in set (0.00 sec)