From 9a666ace8174423a9f3fee1ff9e1b14bb86771fb Mon Sep 17 00:00:00 2001
From: Dominik Eisenberg <64131471+Dominik-esb@users.noreply.github.com>
Date: Tue, 30 Dec 2025 16:00:24 +0100
Subject: [PATCH] cpu: add example query for Task Manager-style CPU utilization
 (#2286)

Co-authored-by: EisenbergD <dominik.eisenberg@beiersdorf.com>
---
 docs/collector.cpu.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/collector.cpu.md b/docs/collector.cpu.md
index f031579b..9975ce18 100644
--- a/docs/collector.cpu.md
+++ b/docs/collector.cpu.md
@@ -48,6 +48,27 @@ Show per-cpu utilisation using the processor utility metrics
 ```
 rate(windows_cpu_processor_utility_total{instance="localhost"}[5m]) / rate(windows_cpu_processor_rtc_total{instance="localhost"}[5m])
 ```
+Show average CPU utilization percentage (like Windows Task Manager)
+```
+sum by (instance) (
+  clamp_max(
+    (
+      rate(windows_cpu_processor_utility_total{
+        job=~"$job",
+      }[1m])
+      /
+      rate(windows_cpu_processor_rtc_total{
+        job=~"$job",
+      }[1m])
+    ), 100
+  )
+) /
+count by (instance) (
+  windows_cpu_processor_utility_total{
+    job=~"$job"
+  }
+)
+```
 Show actual average CPU frequency in Hz
 ```
 avg by(instance) (