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.