refactor(cpu-usage): improve comment

Author: markuslf

check-plugins/cpu-usage/README.md

@@ -44,7 +44,8 @@ focusing on sustained load. Perfdata is emitted for every field to enable full
 graphing. Extended stats (context switches, interrupts, etc.) are included if
 supported on this platform. With `--top`, the most CPU-intensive processes are
 also listed for quick diagnosis. This check is cross-platform and works on
-Linux, Windows, and all psutil-supported systems.
+Linux, Windows, and all psutil-supported systems. The check stores its short
+trend state locally in an SQLite DB to evaluate sustained load across runs.
 
 options:
   -h, --help           show this help message and exit

check-plugins/cpu-usage/cpu-usage

@@ -33,19 +33,20 @@ __author__ = 'Linuxfabrik GmbH, Zurich/Switzerland'
 __version__ = '2025090701'
 
 DESCRIPTION = """Reports CPU utilization percentages for all available time categories
-                 (user, system, idle, nice, iowait, irq, softirq, steal, guest, guest_nice) plus
-                 the overall cpu-usage (100 − idle − nice).
+(user, system, idle, nice, iowait, irq, softirq, steal, guest, guest_nice) plus the overall
+cpu-usage (100 − idle − nice).
 
-                 Thresholds (WARN/CRIT) are checked against user, system, iowait, and cpu-usage.
-                 An alert is raised only if the threshold is exceeded for COUNT consecutive runs,
-                 suppressing short spikes and focusing on sustained load.
+Thresholds (WARN/CRIT) are checked against user, system, iowait, and cpu-usage. An alert is raised
+only if the threshold is exceeded for COUNT consecutive runs, suppressing short spikes and focusing
+on sustained load.
 
-                 Perfdata is emitted for every field to enable full graphing. Extended stats
-                 (context switches, interrupts, etc.) are included if supported on this platform.
-                 With `--top`, the most CPU-intensive processes are also listed for quick diagnosis.
+Perfdata is emitted for every field to enable full graphing. Extended stats (context switches,
+interrupts, etc.) are included if supported on this platform. With `--top`, the most CPU-intensive
+processes are also listed for quick diagnosis.
 
-                 This check is cross-platform and works on Linux, Windows, and all psutil-supported
-                 systems."""
+This check is cross-platform and works on Linux, Windows, and all psutil-supported systems.
+The check stores its short trend state locally in an SQLite DB to evaluate sustained load across
+runs."""
 
 
 DEFAULT_COUNT = 5 # measurements; if check runs once per minute, this is a 5 minute interval

check-plugins/cpu-usage/icingaweb2-module-director/cpu-usage.json

@@ -162,7 +162,7 @@
                 "tpl-service-generic"
             ],
             "max_check_attempts": 5,
-            "notes": "Reports CPU utilization percentages for all available time categories (user, system, idle, nice, iowait, irq, softirq, steal, guest, guest_nice) plus the overall cpu-usage (100 \u2212 idle \u2212 nice). Thresholds (WARN/CRIT) are checked against user, system, iowait, and cpu-usage. An alert is raised only if the threshold is exceeded for COUNT consecutive runs, suppressing short spikes and focusing on sustained load. Perfdata is emitted for every field to enable full graphing. Extended stats (context switches, interrupts, etc.) are included if supported on this platform. With `--top`, the most CPU-intensive processes are also listed for quick diagnosis. This check is cross-platform and works on Linux, Windows, and all psutil-supported systems.",
+            "notes": "Reports CPU utilization percentages for all available time categories (user, system, idle, nice, iowait, irq, softirq, steal, guest, guest_nice) plus the overall cpu-usage (100 \u2212 idle \u2212 nice). Thresholds (WARN/CRIT) are checked against user, system, iowait, and cpu-usage. An alert is raised only if the threshold is exceeded for COUNT consecutive runs, suppressing short spikes and focusing on sustained load. Perfdata is emitted for every field to enable full graphing. Extended stats (context switches, interrupts, etc.) are included if supported on this platform. With `--top`, the most CPU-intensive processes are also listed for quick diagnosis. This check is cross-platform and works on Linux, Windows, and all psutil-supported systems. The check stores its short trend state locally in an SQLite DB to evaluate sustained load across runs.",
             "notes_url": "https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/cpu-usage",
             "object_name": "tpl-service-cpu-usage",
             "object_type": "template",
@@ -212,7 +212,7 @@
                 "tpl-service-generic"
             ],
             "max_check_attempts": 5,
-            "notes": "Reports CPU utilization percentages for all available time categories (user, system, idle, nice, iowait, irq, softirq, steal, guest, guest_nice) plus the overall cpu-usage (100 \u2212 idle \u2212 nice). Thresholds (WARN/CRIT) are checked against user, system, iowait, and cpu-usage. An alert is raised only if the threshold is exceeded for COUNT consecutive runs, suppressing short spikes and focusing on sustained load. Perfdata is emitted for every field to enable full graphing. Extended stats (context switches, interrupts, etc.) are included if supported on this platform. With `--top`, the most CPU-intensive processes are also listed for quick diagnosis. This check is cross-platform and works on Linux, Windows, and all psutil-supported systems.",
+            "notes": "Reports CPU utilization percentages for all available time categories (user, system, idle, nice, iowait, irq, softirq, steal, guest, guest_nice) plus the overall cpu-usage (100 \u2212 idle \u2212 nice). Thresholds (WARN/CRIT) are checked against user, system, iowait, and cpu-usage. An alert is raised only if the threshold is exceeded for COUNT consecutive runs, suppressing short spikes and focusing on sustained load. Perfdata is emitted for every field to enable full graphing. Extended stats (context switches, interrupts, etc.) are included if supported on this platform. With `--top`, the most CPU-intensive processes are also listed for quick diagnosis. This check is cross-platform and works on Linux, Windows, and all psutil-supported systems. The check stores its short trend state locally in an SQLite DB to evaluate sustained load across runs.",
             "notes_url": "https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/cpu-usage",
             "object_name": "tpl-service-cpu-usage-windows",
             "object_type": "template",