openGauss服务端工具——gs_checkperf

背景信息

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

前提条件

• openGauss运行状态正常且不为只读模式。

• 运行在数据库之上的业务运行正常。

 说明：

出于安全考虑，企业版安装方式下，gaussdbToolPath目录下该工具前置完成后会自动删除。

注意事项

• 使用流式容灾功能时，灾备集群不支持此工具。

• 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-MM-DD_hhmmss.log

• -?, –help

  显示帮助信息。

• -V, –version

  显示版本号信息。