Added new z16 partition power metrics

Details: * Added support for the new power consumption metrics in z16 (issue #448): In metric group 'zcpc-environmentals-and-power': - 'total_partition_power_watt' - Total power consumption of all partitions - 'total_infrastructure_power_watt' - Total power consumption of infrastructure components - 'total_unassigned_power_watt' - Total power consumption of unassigned components In metric group 'logical-partition-usage': - 'partition_power_watt' - Power consumption of the partition Signed-off-by: Andreas Maier <[email protected]>
zhmcclient · Feb 21, 2024 · 9be7610 · 9be7610
1 parent 69487c0
commit 9be7610
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 1 deletion.
diff --git a/docs/changes.rst b/docs/changes.rst
@@ -76,6 +76,20 @@ will also work with the prior version of the file (but not vice versa).
     and 'logical-partition-resource' (only returned for SE versions between
     2.14.0+MCLs and 2.15.0)
 
+* Added support for the new power consumption metrics in z16 (issue #448):
+
+  In metric group 'zcpc-environmentals-and-power':
+
+  - 'total_partition_power_watt' - Total power consumption of all partitions
+  - 'total_infrastructure_power_watt' - Total power consumption of all
+    infrastructure components
+  - 'total_unassigned_power_watt' - Total power consumption of all unassigned
+    components
+
+  In metric group 'logical-partition-usage':
+
+  - 'partition_power_watt' - Power consumption of the partition
+
 **Cleanup:**
 
 * Increased versions of GitHub Actions plugins to increase node.js runtime

diff --git a/examples/metrics.yaml b/examples/metrics.yaml
@@ -337,6 +337,11 @@ metrics:
       percent: false
       exporter_name: zvm_paging_rate_pages_per_second
       exporter_desc: z/VM paging rate in pages/sec
+    power-consumption:
+      if: "'environmental-metrics' in se_features"
+      percent: false
+      exporter_name: partition_power_watt
+      exporter_desc: Power consumption of the partition; not present before SE feature environmental-metrics
 
   channel-usage:
     channel-usage:
@@ -1098,7 +1103,7 @@ metrics:
     - property_name: cylinders
       if: "'cylinders' in resource_obj.properties"  # Only for FC-type storage groups
       exporter_name: cylinders
-      exporter_desc: "Size of ECKD volume in cylinders (0 for ECKD alias volumes, not present for non-ECKD volumes)"
+      exporter_desc: "Size of ECKD volume in cylinders (0 for ECKD alias volumes); not present for non-ECKD volumes"
 
   # Available for CPCs in any mode
 
@@ -1135,6 +1140,21 @@ metrics:
       percent: false
       exporter_name: exhaust_temperature_celsius
       exporter_desc: Exhaust temperature of the CPC
+    total-partition-power-consumption-watts:
+      if: "'environmental-metrics' in se_features"
+      percent: false
+      exporter_name: total_partition_power_watt
+      exporter_desc: Total power consumption of all partitions of the CPC; not present before SE feature environmental-metrics
+    total-infrastructure-power-consumption-watts:
+      if: "'environmental-metrics' in se_features"
+      percent: false
+      exporter_name: total_infrastructure_power_watt
+      exporter_desc: Total power consumption of all infrastructure components of the CPC (including top of rack switches, SE/HMAs, and PDUs); not present before SE feature environmental-metrics
+    total-unassigned-power-consumption-watts:
+      if: "'environmental-metrics' in se_features"
+      percent: false
+      exporter_name: total_unassigned_power_watt
+      exporter_desc: Total power consumption of all unassigned components of the CPC (unused I/O adapters, standby components); not present before SE feature environmental-metrics
 
   environmental-power-status:
     linecord-one-power-phase-A: