通用说明
本页汇总所有 Percona Toolkit 工具共有的"其他信息"内容(已知问题、调试安全提示、系统要求基线、环境变量),避免在每个工具页重复。各工具页只保留其特有内容(作者、特殊依赖、致谢),并在文末附上本页链接与官方英文文档链接。
已知问题(BUGS)
所有工具的已知问题统一在 Percona 的 Jira 项目跟踪:https://jira.percona.com/projects/PT/issues
报告新问题时请尽量附上:
- 完整命令行;
--version输出;- 涉及的数据库版本(MySQL / MongoDB / PostgreSQL);
- 包含 STDERR 的完整输出;
- 相关输入文件;
- 如可能,用
PTDEBUG=1附上调试输出(见下方安全提示)。
调试与 PTDEBUG 安全提示
所有工具均支持 PTDEBUG=1 开启调试输出,帮助排查问题。注意两点:
- 调试输出量很大,可能达到数 MB;
- 调试输出会暴露命令行参数中的密码——开启后请勿在公共环境分享输出。
bash
PTDEBUG=1 pt-toolname ... > FILE 2>&1系统要求(基线)
所有工具需要:
- Perl(较新版本自带所需核心包);
- DBI 与 DBD::mysql(MySQL 系工具);
- MongoDB 系工具需要 Perl 的 MongoDB 驱动;PostgreSQL 系工具需要相应的 Perl / psql 依赖。
部分工具有额外依赖(例如 Bash v3+、gdb、elfutils 的 eu-stack、/proc 文件系统、seq 等),已在各工具页"其他信息"中注明。完整基线见 系统要求。
环境变量
所有工具均支持 PTDEBUG=1(见上方安全提示)。部分工具不使用其他环境变量,详见各工具页。更完整的变量说明见 环境变量。