服务端工具gs_checkperf的部分解读

---

背景信息

openGauss提供了gs_checkperf工具来帮助对openGauss级别（主机CPU占用率、Gauss CPU占用率、I/O使用情况等）、节点级别（CPU使用情况、内存使用情况、I/O使用情况）、会话/进程级别（CPU使用情况、内存使用情况、I/O使用情况）、SSD性能（写入、读取性能）进行定期检查，让用户了解openGauss的负载情况，采取对应的改进措施。

---

前提条件

• openGauss运行状态正常且不为只读模式。
• 运行在数据库之上的业务运行正常。

---

注意事项

gs_checkperf工具的监控信息依赖于pmk模式下的表的数据。如果pmk模式下的表未执行analyze操作，则可能导致gs_checkperf工具执行失败。其报错示例信息如下:

LOG: Statistics in some tables or columns(pmk.pmk_snapshot.snapshot_id) are not collected.
HINT: Do analyze for them in order to generate optimized plan.

此时需要登录任一数据库主节点，连接postgres数据库执行如下SQL：

analyze pmk.pmk_configuration;
analyze pmk.pmk_meta_data;
analyze pmk.pmk_snapshot;
analyze pmk.pmk_snapshot_dbnode_stat;
analyze pmk.pmk_snapshot_datanode_stat;

---

语法

• 检查SSD性能（root用户）

gs_checkperf -U USER [-o OUTPUT] -i SSD [-l LOGFILE] 

• 检查openGauss性能（openGauss安装用户）

gs_checkperf [-U USER] [-o OUTPUT] [-i PMK] [--detail] [-l LOGFILE] 

• 显示帮助信息

gs_checkperf -? | --help

• 显示版本号信息

gs_checkperf -V | --version

---

参数说明

• -U
  运行openGauss的用户名称。
  取值范围：运行openGauss的用户名称。
  以root用户身份执行此命令必须指定该参数。

• -o
  指定性能检查报告输出到指定的文件。
  取值范围：指定的文件名称。
  不指定则将检查结果输出到屏幕上。

• -i
  指定检查项编号，-i参数值不区分大小写。格式：-i PMK、-i SSD。
  取值范围：PMK、SSD
  只有openGauss用户才能检查PMK选项。
  只有root用户才能检查SSD选项。
  如果不指定该参数，以openGauss用户身份默认检查PMK，以root用户身份默认
  检查SSD。

• –detail
  显示PMK检查结果详情。

• -l
  指定日志文件的存储路径。
  默认路径为：/var/log/gaussdb/omm/om/gs_checkperf-YYYY-MMDD_hhmmss.log

• -?, --help
  显示帮助信息。

• -V, --version
  显示版本号信息。

---

示例

以简要格式在屏幕上显示性能统计结果。

gs_checkperf -i pmk -U omm
Cluster statistics information:
 Host CPU busy time ratio : 1.43 %
 GaussDB CPU time % in busy time : 1.88 %
 Shared Buffer Hit ratio : 99.96 %
 In-memory sort ratio : 100.00 %
 Physical Reads : 4
 Physical Writes : 25
 DB size : 70 MB
 Total Physical writes : 25
 Active SQL count : 2
 Session count : 3

---