diff --git a/gpdb-doc/dita/ref_guide/gp_toolkit.xml b/gpdb-doc/dita/ref_guide/gp_toolkit.xml
index d072f0478a079822df9ce081d9b34eae22917af4..782aaffdc2e841e44a6325ec5bbf25bee636577d 100644
--- a/gpdb-doc/dita/ref_guide/gp_toolkit.xml
+++ b/gpdb-doc/dita/ref_guide/gp_toolkit.xml
@@ -1701,8 +1701,11 @@
cpu_usage
- The real-time CPU usage of the resource
- group on each Greenplum Database segment's host.
+ A set of key-value pairs. For each
+ segment instance (the key), the value is the real-time, per-segment instance CPU
+ core usage by a resource group. The value is the sum of the percentages (as a
+ decimal value) of CPU cores that are used by the resource group for the segment
+ instance.
memory_usage
@@ -1712,17 +1715,17 @@
-
The cpu_usage field is a JSON-formatted, key:value
- string that identifies, for each resource group, the per-segment CPU usage percentage. The
- key is segment id, the value is the percentage of CPU usage by the resource group on the
- segment host. The total CPU usage of all segments running on a segment host should not
- exceed the gp_resource_group_cpu_limit. Example
- cpu_usage column
- output:
-{"-1":0.01, "0":0.31, "1":0.31}
- In this example, segment 0 and segment 1 are running on
- the same host; their CPU usage is the same.
+ string that identifies, for each resource group, the per-segment instance CPU core usage.
+ The key is the segment id, the value is the sum of the percentages (as a decimal value) of
+ the CPU cores used by the segment instance's resource group on the segment host. For
+ example, if a segment host has 8 cores, the maximum value can be 8.00 (1.00 for 8 CPU
+ cores). The total CPU usage of all segment instances running on a host should not exceed
+ the gp_resource_group_cpu_limit. Example cpu_usage
+ column output:
+{"-1":0.01, "0":0.31, "1":0.31}In the example,
+ segment 0 and segment 1 are running on the same host;
+ their CPU usage is the same.
The memory_usage field is also a JSON-formatted,
key:value string. The string contents differ depending upon the type of resource group.
For each resource group that you assign to a role (default memory auditor
@@ -1778,8 +1781,9 @@
cpu
- The real-time CPU usage of the resource group on the
- host.
+ The real-time CPU core usage by the resource group on a host.
+ The value is the sum of the percentages (as a decimal value) of the CPU cores that
+ are used by the resource group on the host.
memory_used
@@ -1867,9 +1871,13 @@
segment host.
- cpu
- The real-time CPU usage of the resource group for the
- segment instance on the host.
+
+ cpu
+
+ The real-time, per-segment instance CPU core usage by the
+ resource group on the host. The value is the sum of the percentages (as a decimal
+ value) of the CPU cores that are used by the resource group for the segment
+ instance.
memory_used
diff --git a/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status.xml b/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status.xml
index 125d9e39cb9f734724855063f0b2c304cddb3646..1491ce9b1f99585896b052468617a84c6a947bd0 100644
--- a/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status.xml
+++ b/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status.xml
@@ -86,8 +86,11 @@
cpu_usage
json
-
- The real-time CPU usage of the resource group on each Greenplum Database segment's host.
+
+ A set of key-value pairs. For each segment instance (the key), the
+ value is the real-time, per-segment instance CPU core usage by a resource group. The
+ value is the sum of the percentages (as a decimal value) of CPU cores that are used by
+ the resource group for the segment instance.
diff --git a/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_host.xml b/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_host.xml
index 70763bb915f59158cac3ebbd9136565f76e94ff7..441f3a4046363d1305a79b0b555f148167288808 100644
--- a/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_host.xml
+++ b/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_host.xml
@@ -55,9 +55,10 @@
cpu
numeric
-
- The real-time CPU usage of the resource group on the
- host.
+
+ The real-time CPU core usage by the resource group on a host. The
+ value is the sum of the percentages (as a decimal value) of the CPU cores that are
+ used by the resource group on the host.
diff --git a/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_segment.xml b/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_segment.xml
index d60ce6c4739a6bcc255531912fec570ed1b85aab..38e0bc27b77433de17ec5e59958be234cd5d5c29 100644
--- a/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_segment.xml
+++ b/gpdb-doc/dita/ref_guide/system_catalogs/gp_resgroup_status_per_segment.xml
@@ -64,9 +64,10 @@
cpu
numeric
-
- The real-time CPU usage of the resource group for the
- segment instance on the host.
+
+ The real-time, per-segment instance CPU core usage by the resource
+ group on the host. The value is the sum of the percentages (as a decimal value) of the
+ CPU cores that are used by the resource group for the segment instance.