人大金仓KingbaseES数据库问题诊断辅助工具

1. 工具概述 ¶

问题诊断辅助工具是针对KingbaseES V8R6数据库开发的一套问题诊断工具。方便用户在系统故障情况下，及时了解系统特定信息。

为了保证脚本的通用性，本工具使用bash语法编写脚本，实际运行环境必须支持bash。

本工具的使用需要获取查询语句及等待事件，要求开启track_activities参数。部分shell脚本还需要依赖于extension的开启，如：sys_stat_statement， sys_kwr，sys_ksh。以上插件的开启方法可以参照《 KingbaseES数据库性能调优指南 》文档。

以下表格列出脚本及扩展组件的依赖关系。

脚本名称	扩展组件依赖
chk_event_sql.sh	sys_kwr及相关参数 sys_stat_statements 及相关参数
chk_top_sql.sh	sys_stat_statements 及相关参数
chk_top_waitevent.sh	sys_stat_statements 及相关参数
chk_top_wal.sh	sys_stat_statements 及相关参数

如果当前数据库系统是高可用集群系统，需要将数据库集群的密码文件，复制到root用户的根目录下。如果数据库集群的系统用户是kingbase用户，则通常的复制命令如下：

kingbase$ su - root -c "cp $HOME/.encpwd ~ "

2. 脚本工具所在路径 ¶

本工具所涉及的脚本统一放在软件安装目录SupTools/kb_diagtool。

3. 配置数据库连接信息 ¶

在使用辅助工具前，先配置连接信息。用户读取通用参数文件(../suptools.ini)，设置环境变量。根据用户的实际需求，修改通用参数文件。(详见 通用环境变量参数文件 )