From e5c2b6ef34bbd139c6466c8d551e37bd09a83fa6 Mon Sep 17 00:00:00 2001 From: Gwynne Monahan Date: Fri, 18 Jul 2025 08:35:28 -0500 Subject: [PATCH] POWERMON-628 New assembly for Kepler power attribution guide --- _topic_maps/_topic_map.yml | 2 ++ ...-monitoring-kepler-power-attribution-guide.adoc | 7 +++++++ .../power-monitoring-references.adoc | 14 ++++++++++++++ 3 files changed, 23 insertions(+) create mode 100644 modules/power-monitoring-kepler-power-attribution-guide.adoc create mode 100644 observability/power_monitoring/power-monitoring-references.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index a5fe628000bf..3a00bc2d197b 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -3304,6 +3304,8 @@ Topics: File: visualizing-power-monitoring-metrics - Name: Uninstalling power monitoring File: uninstalling-power-monitoring + - Name: Power monitoring references + File: power-monitoring-references --- Name: Scalability and performance Dir: scalability_and_performance diff --git a/modules/power-monitoring-kepler-power-attribution-guide.adoc b/modules/power-monitoring-kepler-power-attribution-guide.adoc new file mode 100644 index 000000000000..f39116c38ed6 --- /dev/null +++ b/modules/power-monitoring-kepler-power-attribution-guide.adoc @@ -0,0 +1,7 @@ +:_mod-docs-content-type: REFERENCE +[id="power-monitoring-kepler-power-attribution-guide_{context}"] +== Power monitoring Kepler power attribution guide + +Kepler's power attribution system provides practical, proportional distribution of hardware energy consumption to individual workloads. While CPU-time-based attribution has inherent limitations due to modern CPU complexity, it offers a good balance between accuracy, simplicity, and performance overhead for most monitoring and optimization use cases. + +For more information about power attribution, see link:http://sustainable-computing.io/kepler/usage/power-attribution[Kepler Power Attribution Guide]. \ No newline at end of file diff --git a/observability/power_monitoring/power-monitoring-references.adoc b/observability/power_monitoring/power-monitoring-references.adoc new file mode 100644 index 000000000000..25ec189f2dd7 --- /dev/null +++ b/observability/power_monitoring/power-monitoring-references.adoc @@ -0,0 +1,14 @@ +:_mod-docs-content-type: ASSEMBLY +[id="power-monitoring-references_{context}"] += Power monitoring references +include::_attributes/common-attributes.adoc[] +:context: power-monitoring-references + +toc::[] + +:FeatureName: Power monitoring +include::snippets/technology-preview.adoc[leveloffset=+2] + +include::modules/power-monitoring-kepler-power-attribution-guide.adoc[Leveloffset=+1] + +//move API reference here post release. There may need to be additional IA updates for GA to better incorporate reference material. \ No newline at end of file