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工具执行失败。其报错示例信息如下:

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

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

    1. analyze pmk.pmk_configuration;
    2. analyze pmk.pmk_meta_data;
    3. analyze pmk.pmk_snapshot;
    4. analyze pmk.pmk_snapshot_dbnode_stat;
    5. analyze pmk.pmk_snapshot_datanode_stat;

语法

  • 检查SSD性能(root用户)

    1. gs_checkperf -U USER [-o OUTPUT] -i SSD [-l LOGFILE]
  • 检查openGauss性能(openGauss安装用户)

    1. gs_checkperf [-U USER] [-o OUTPUT] [-i PMK] [--detail] [-l LOGFILE]
  • 显示帮助信息

    1. gs_checkperf -? | --help
  • 显示版本号信息

    1. 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

    显示版本号信息。

表 1 性能检查项

分类

性能参数项

描述

openGauss级别

主机CPU占用率

主机CPU占用率。

Gauss CPU占用率

Gauss CPU占用率。

共享内存击中率

共享内存的击中率。

内存中排序比率

内存中完成的排序所占比率。

I/O使用情况

文件读写次数和时间。

磁盘使用情况

文件写次数和平均写时间、最大写时间等。

事务统计

当前SQL执行数和Session数。

节点级别

CPU使用情况

主机使用CPU情况,包括cpu busy time,cpu idle time等。

内存使用情况

主机使用内存情况,包括物理内存总量,已使用量等。

I/O使用情况

文件读写次数和时间。

会话/进程级别

CPU使用情况

会话使用CPU情况,包括cpu busy time,cpu idle time等。

内存使用情况

会话使用内存情况,包括物理内存总量,已使用量等。

I/O使用情况

会话共享缓冲区命中次数等。

SSD性能(只用root用户才能查看)

写入性能

使用dd命令(flag=direct bs=8M count=2560)向每个SSD写入内容,写入每个SSD时间应在10s左右。

读取性能

使用dd命令(flag=direct bs=8M count=2560)从每个SSD读取内容,读取每个SSD时间应在7s左右。

示例

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

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

示例二:以详细格式在屏幕上显示性能统计结果。

  1. gs_checkperf -i pmk -U omm --detail
  2. Cluster statistics information:
  3. Host CPU usage rate:
  4. Host total CPU time : 42386.667 Jiffies
  5. Host CPU busy time : 1873.333 Jiffies
  6. Host CPU iowait time : 20.000 Jiffies
  7. Host CPU busy time ratio : 4.42 %
  8. Host CPU iowait time ratio : .05 %
  9. GaussDB CPU usage rate:
  10. GaussDB CPU time % in busy time : 19.04 %
  11. GaussDB CPU time % in total time : .84 %
  12. Shared buffer hit rate:
  13. Shared Buffer Reads : 0
  14. Shared Buffer Hits : 24129
  15. Shared Buffer Hit ratio : 100.00 % In-memory sort ratio : 100.00 %I/O usage:
  16. Number of files : 537
  17. Physical Reads : 0
  18. Physical Writes : 0
  19. Read Time : 0 ms
  20. Write Time : 0 ms
  21. Disk usage:
  22. DB size : 70 MB
  23. Total Physical writes : 0
  24. Average Physical write : 0
  25. Maximum Physical write : 0
  26. Activity statistics:
  27. Active SQL count : 2
  28. Session count : 3
  29. Node statistics information:
  30. dn_6001_6002:
  31. GaussDB CPU Time : 200 Jiffies
  32. Host CPU Busy Time : 3490 Jiffies
  33. Host CPU Total Time : 42330 Jiffies
  34. GaussDB CPU Time % in Busy Time : 5.73 %
  35. GaussDB CPU Time % in Total Time : .47 %
  36. Physical memory : 8231776256 Bytes
  37. DB Memory usage : 877236224 Bytes
  38. Shared buffer size : 33554432 Bytes
  39. Shared buffer hit ratio : 100.00 %
  40. Sorts in memory : 123
  41. Sorts in disk : 0
  42. In-memory sort ratio : 100.00 %
  43. Number of files : 149
  44. Physical Reads : 0
  45. Physical Writes : 0
  46. Read Time : 0
  47. Write Time : 0
  48. dn_6003_6004:
  49. GaussDB CPU Time : 170 Jiffies Host CPU Busy Time : 1030 Jiffies
  50. Host CPU Total Time : 42470 Jiffies GaussDB CPU Time % in Busy Time : 16.50 %
  51. GaussDB CPU Time % in Total Time : .40 %
  52. Physical memory : 8231776256 Bytes
  53. DB Memory usage : 881434624 Bytes Shared buffer size : 33554432 Bytes
  54. Shared buffer hit ratio : 100.00 %
  55. Sorts in memory : 119
  56. Sorts in disk : 0
  57. In-memory sort ratio : 100.00 %
  58. Number of files : 165
  59. Physical Reads : 0
  60. Physical Writes : 0
  61. Read Time : 0
  62. Write Time : 0
  63. dn_6005_6006:
  64. GaussDB CPU Time : 220 Jiffies
  65. Host CPU Busy Time : 1100 Jiffies
  66. Host CPU Total Time : 42360 Jiffies
  67. GaussDB CPU Time % in Busy Time : 20.00 %
  68. GaussDB CPU Time % in Total Time : .52 %
  69. Physical memory : 8231776256 Bytes
  70. DB Memory usage : 881430528 Bytes
  71. Shared buffer size : 33554432 Bytes
  72. Shared buffer hit ratio : 100.00 %
  73. Sorts in memory : 122
  74. Sorts in disk : 0
  75. In-memory sort ratio : 100.00 %
  76. Number of files : 115
  77. Physical Reads : 0
  78. Physical Writes : 0
  79. Read Time : 0
  80. Write Time : 0
  81. Session statistics information(Top 10):
  82. Session CPU statistics:
  83. 1 dn_6003_6004-postgres-dbazt:
  84. Session CPU time : 1211
  85. Database CPU time : 37670
  86. Session CPU time % : 3.21 %
  87. 2 dn_6005_6006-postgres-dbazt:
  88. Session CPU time : 1204
  89. Database CPU time : 35730
  90. Session CPU time % : 3.37 %
  91. 3 dn_6001_6002-postgres-dbazt:
  92. Session CPU time : 1064
  93. Database CPU time : 34120
  94. Session CPU time % : 3.12 %
  95. Session Memory statistics:
  96. 1 dn_6005_6006-postgres-dbazt:
  97. Buffer Reads : 8989
  98. Shared Buffer Hit ratio : 96.97
  99. In Memory sorts : 136
  100. In Disk sorts : 0
  101. In Memory sorts ratio : 100.00
  102. Total Memory Size : 21593048
  103. Used Memory Size : 18496600
  104. 2 dn_6003_6004-postgres-dbazt:
  105. Buffer Reads : 9030
  106. Shared Buffer Hit ratio : 96.94
  107. In Memory sorts : 133
  108. In Disk sorts : 0
  109. In Memory sorts ratio : 100.00
  110. Total Memory Size : 21576664
  111. Used Memory Size : 18495688
  112. 3 dn_6001_6002-postgres-dbazt:
  113. Buffer Reads : 8668
  114. Shared Buffer Hit ratio : 96.97
  115. In Memory sorts : 138
  116. In Disk sorts : 0
  117. In Memory sorts ratio : 100.00
  118. Total Memory Size : 21258856
  119. Used Memory Size : 18159736
  120. Session IO statistics:
  121. 1 dn_6003_6004-postgres-dbazt:
  122. Physical Reads : 285
  123. Read Time : 5320
  124. 2 dn_6005_6006-postgres-dbazt:
  125. Physical Reads : 281
  126. Read Time : 5811
  127. 3 dn_6001_6002-postgres-dbazt:
  128. Physical Reads : 271
  129. Read Time : 4662

相关命令

gs_checkgs_checkos