Skip to content

PM: runtime: add new runtime metrics and summary

Joshua Crofts driver-core linux-pm lkml 2 versions – New

Get series with b4
b4 am [email protected] change-id 20261110-pm-runtime-summary-8dd29a1383bc

Versions newest first

  1. v2 Latest2 patches 0 repliesNew
  2. v13 patches 10 repliesSuperseded

Changes in v2 from the cover letter

- Drop sysfs patch as it would have a non-negligible impact on boot times and the debugfs summary is enough (Samuel Wu)
- Expand cover letter
- Fix Sashiko findings - typo in commit message, race condition, duplicate function call
- Link to v1: https://lore.kernel.org/r/[email protected]

Patches in v2 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/2PM: runtime: add additional suspend/resume metricsdrivers/base/power/runtime.c include/linux/pm.h+83 -50 replies
2/2PM: runtime: add debugfs entry for pm_runtime_summarydrivers/base/power/runtime.c+86 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.

Read the v2 thread

Cover letter [PATCH v2 0/2] PM: runtime: add new runtime metrics and summary

Add a new set additional PM runtime metrics to improve power management debugging and reporting (these metrics may be useful to userspace utilities such as Powertop).

MOTIVATION:
The current implementation only measures the duration a device spends in suspended or active mode, which is very limiting. We can't find out how many times a device changed state or what its shortest suspend cycle was.

This overview would be useful for detecting power "thrashing" and tuning autosuspend delays. Currently, sysfs only shows the total time a device spent in active and suspended mode; from an energy standpoint, a continuous 50 second suspension is different from a device cycling 1000 times for 50ms each (these transitions can be pretty power-hungry). This could help userspace utilities like PowerTOP to more effectively determine what is causing an increased power consumption.

NEW FEATURES:
This series introduces the following new metrics:
- resume_count : number of successful transitions to active
- suspend_count: number of successful transitions to suspended
- last_suspended_time: duration of the most recent sleep cycle (ns)
- min_suspended_time / max_suspended_time: shortest and longest sleep cycle durations to help detect power thrashing (ns)

By reading the debugfs file /sys/kernel/debug/pm_runtime_summary, you get the following table describing the power stats of each device with runtime PM enabled:

Device Status Resumes Suspends Active(ms) Suspend(ms) Last(ms) Min(ms) Max(ms)
--------------------------------------------------------------------------------------------------------------------------

0000:00:02.0                     active              1        0        45688            0          0          0          0
0000:00:1f.0                     active              1        0        45687            0          0          0          0
0000:00:1f.2                     active              1        0        45686            0          0          0          0
0000:00:1f.3                     suspended           1        1         1658        44028          0          0          0
00:03:0                          active             15       14        19627        25899         42          5      14811
00:03:0.0                        active             14       13        19626        25900         42          5      14811

TESTING:
Tested with an x86_64 defconfig kernel and QEMU.

AI ASSISTANCE:
Gemini was used to prepare this series.

---
Changes in v2:
- Drop sysfs patch as it would have a non-negligible impact on boot times and the debugfs summary is enough (Samuel Wu)
- Expand cover letter
- Fix Sashiko findings - typo in commit message, race condition, duplicate function call
- Link to v1: https://lore.kernel.org/r/[email protected]

---
Joshua Crofts (2):
PM: runtime: add additional suspend/resume metrics
PM: runtime: add debugfs entry for pm_runtime_summary

 drivers/base/power/runtime.c | 162 +++++++++++++++++++++++++++++++++++++++++--
 include/linux/pm.h           |  12 ++++
 2 files changed, 169 insertions(+), 5 deletions(-)

---
base-commit: 6628e7d4c6b25c8d18f1345e3a20d21829aae7e4
change-id: 20261110-pm-runtime-summary-8dd29a1383bc

Best regards,

Signature · 1 line
Joshua Crofts <[email protected]>