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       %
  96. Session Memory statistics:
  97. 1 dn_6005_6006-postgres-dbazt:
  98.     Buffer Reads                                 :    8989
  99.     Shared Buffer Hit ratio                      :    96.97
  100.     In Memory sorts                              :    136
  101.     In Disk sorts                                :    0
  102.     In Memory sorts ratio                        :    100.00
  103.     Total Memory Size                            :    21593048
  104.     Used Memory Size                             :    18496600
  105. 2 dn_6003_6004-postgres-dbazt:
  106.     Buffer Reads                                 :    9030
  107.     Shared Buffer Hit ratio                      :    96.94
  108.     In Memory sorts                              :    133
  109.     In Disk sorts                                :    0
  110.     In Memory sorts ratio                        :    100.00
  111.     Total Memory Size                            :    21576664
  112.     Used Memory Size                             :    18495688
  113. 3 dn_6001_6002-postgres-dbazt:
  114.     Buffer Reads                                 :    8668
  115.     Shared Buffer Hit ratio                      :    96.97
  116.     In Memory sorts                              :    138
  117.     In Disk sorts                                :    0
  118.     In Memory sorts ratio                        :    100.00
  119.     Total Memory Size                            :    21258856
  120.     Used Memory Size                             :    18159736
  122. Session IO statistics:
  123. 1 dn_6003_6004-postgres-dbazt:
  124.     Physical Reads                               :    285
  125.     Read Time                                    :    5320
  126. 2 dn_6005_6006-postgres-dbazt:
  127.     Physical Reads                               :    281
  128.     Read Time                                    :    5811
  129. 3 dn_6001_6002-postgres-dbazt:
  130.     Physical Reads                               :    271
  131.     Read Time                                    :    4662

相关命令

gs_check，gs_checkos