[POWERMON] POWERMON-581 0.5 Overview doc updates

gwynnemonahan · eromanova97 · commit 1484b6e152e4 · 2025-07-31T16:35:19.000+02:00
diff --git a/modules/power-monitoring-about-power-monitoring.adoc b/modules/power-monitoring-about-power-monitoring.adoc
@@ -6,7 +6,7 @@
 [id="power-monitoring-about-power-monitoring_{context}"]
 = About {PM-shortname}
 
-You can use {PM-title} to monitor the power usage and identify power-consuming containers running in an {product-title} cluster. {PM-shortname-c} collects and exports energy-related system statistics from various components, such as CPU and DRAM. It provides granular power consumption data for Kubernetes pods, namespaces, and nodes.
+You can use {PM-title} to monitor the power usage and identify power-consuming containers running in an {product-title} cluster. {PM-shortname-c} collects and exports energy-related system statistics from various components, such as CPU and DRAM. It provides estimates and granular power consumption data for Kubernetes pods and namespaces, and reads the power consumption of nodes.
 
 [WARNING]
 ====
diff --git a/modules/power-monitoring-hardware-support.adoc b/modules/power-monitoring-hardware-support.adoc
@@ -0,0 +1,12 @@
+// Module included in the following assemblies:
+//
+// * power_monitoring/power-monitoring-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="power-monitoring-hardware-support_{context}"]
+= {PM-kepler} hardware support
+
+{PM-kepler} is the key component of {PM-shortname} that collects real-time CPU power consumption data from a node through the RAPL Subsystem. By understanding the total power consumption of the node and calculating the percent of CPU time each process is using, it is able to estimate the power consumption at a per process and container level.
+
+Kernel Power Management Subsystem::
+* `rapl-sysfs`: This requires access to the `/sys/class/powercap/intel-rapl` directory.
diff --git a/modules/power-monitoring-hardware-virtualization-support.adoc b/modules/power-monitoring-hardware-virtualization-support.adoc
diff --git a/modules/power-monitoring-kepler-architecture.adoc b/modules/power-monitoring-kepler-architecture.adoc
@@ -8,6 +8,6 @@
 
 {PM-shortname-c} is made up of the following major components:
 
-The {PM-operator}:: For administrators, the {PM-operator} streamlines the monitoring of power usage for workloads by simplifying the deployment and management of {PM-kepler} in an {product-title} cluster. The setup and configuration for the {PM-operator} are simplified by adding a {PM-kepler} custom resource definition (CRD). The Operator also manages operations, such as upgrading, removing, configuring, and redeploying {PM-kepler}. 
+The {PM-operator}:: For administrators, the {PM-operator} streamlines the monitoring of power usage for workloads by simplifying the deployment and management of {PM-kepler} in an {product-title} cluster. The setup and configuration for the {PM-operator} are simplified by adding a `PowerMonitor` custom resource definition (CRD). The Operator also manages operations, such as upgrading, removing, configuring, and redeploying {PM-kepler}.
 
 {PM-kepler}:: {PM-kepler} is a key component of {PM-shortname}. It is responsible for monitoring the power usage of containers running in {product-title}. It generates metrics related to the power usage of both nodes and containers.
diff --git a/observability/power_monitoring/power-monitoring-overview.adoc b/observability/power_monitoring/power-monitoring-overview.adoc
@@ -13,7 +13,7 @@ include::modules/power-monitoring-about-power-monitoring.adoc[leveloffset=+1]
 
 include::modules/power-monitoring-kepler-architecture.adoc[leveloffset=+1]
 
-include::modules/power-monitoring-hardware-virtualization-support.adoc[leveloffset=+1]
+include::modules/power-monitoring-hardware-support.adoc[leveloffset=+1]
 
 include::modules/power-monitoring-fips-support.adoc[leveloffset=+1]
 
