pt-sift
浏览 pt-stalk 生成的样本文件，交互式查看故障现场摘要。
语法
bash
pt-sift FILE|PREFIX|DIRECTORY用法示例
pt-sift 是纯本机工具，浏览 pt-stalk 生成的诊断样本，不连接数据库。命令可直接复制运行，运行后按 1/d/i/m/n 等键交互查看（见功能说明按键表）。
场景：浏览默认目录全部样本
在一台长期运行 pt-stalk 的机器上，直接浏览 /var/lib/pt-stalk 里所有采集样本：
bash
pt-sift场景：浏览某个时间点前缀的样本
知道某次故障发生时刻，用该时间戳前缀直接定位到对应样本（其余同前缀文件一并载入）：
bash
pt-sift 2024_01_15_14_02_02场景：浏览指定目录的样本
把别处拷来的样本放到一个目录里，直接指定目录整体浏览：
bash
pt-sift /data/pt-stalk-samples场景：从具体样本文件入手
手上只有一个样本文件，用该 FILE 打开，工具会自动关联同目录下同前缀的其余文件：
bash
pt-sift /var/lib/pt-stalk/2024_01_15_14_02_02-diskstats.txt功能说明
pt-sift 用于浏览 pt-stalk 创建的文件：
- 不带参数时，浏览
/var/lib/pt-stalk（若存在）或当前工作目录下的所有 pt-stalk 文件。 - 给定 FILE 时，浏览该文件所在目录中同前缀的文件。
- 给定 PREFIX 时，浏览
/var/lib/pt-stalk（或当前目录）中同前缀的文件。 - 给定 DIRECTORY 时，浏览其中的所有 pt-stalk 文件。
工具会先下载可能用到的其他工具（如 pt-diskstats），然后列出目录中所有文件的时间戳前缀。 如果用户在命令行指定了时间戳，则从该样本开始；否则先列出时间戳并提示选择。 选定样本后显示摘要，用户可以通过按键导航和查看。可用按键：
| 按键 | 作用 |
|---|---|
d | 启动 pt-diskstats 查看样本的磁盘性能统计 |
i | 用 less 查看第一个 INNODB STATUS 样本 |
m | 用 pt-mext 并排显示前 4 次 SHOW STATUS 计数器样本 |
n | 以两种方式汇总第一个 netstat 样本：按来源主机、按连接状态 |
j | 选择下一个时间戳作为活动样本 |
k | 选择上一个时间戳作为活动样本 |
q | 退出程序 |
1 | 将每个样本的动作设为默认：查看样本摘要 |
0 | 将动作设为仅列出样本中的文件 |
- | 将动作设为用 less 查看样本的全部文件 |
选项
| 选项 | 说明 |
|---|---|
--help | 显示帮助并退出 |
--version | 显示版本并退出 |
其他信息
系统要求：需要 Bash v3，以及 pt-diskstats、pt-pmp、pt-mext、pt-align；若这些工具不在 PATH 中且有 curl，会自动从网络获取。
环境变量：本工具不使用环境变量（所有 Percona Toolkit 工具均支持
PTDEBUG=1调试，注意调试输出会暴露命令行中的密码）通用说明：已知问题的反馈方式、PTDEBUG 调试安全提示、系统要求基线，见 通用说明。
更多细节请阅读 官方文档。