From da78bb3c59556c80200ec9ce25d65f77b85a2aa0 Mon Sep 17 00:00:00 2001 From: Aarya Shah <140880130+Aruisop@users.noreply.github.com> Date: Wed, 10 Jun 2026 19:53:00 +0530 Subject: [PATCH] powermetrics: add page (#22728) Co-authored-by: Lena Pastwa Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/osx/powermetrics.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 pages/osx/powermetrics.md diff --git a/pages/osx/powermetrics.md b/pages/osx/powermetrics.md new file mode 100644 index 0000000000..0301f14777 --- /dev/null +++ b/pages/osx/powermetrics.md @@ -0,0 +1,24 @@ +# powermetrics + +> Gather and display CPU usage, power, and interrupt wakeup statistics. +> More information: . + +- Display CPU, power, and wakeup metrics using the default 5-second sample interval: + +`sudo powermetrics` + +- Sample metrics every 2000 milliseconds taking 10 samples then exit: + +`sudo powermetrics {{[-i|--sample-rate]}} 2000 {{[-n|--sample-count]}} 10` + +- Save output to a file instead of `stdout`: + +`sudo powermetrics {{[-o|--output-file]}} {{path/to/output.txt}}` + +- Order the process list by the specified method (default: `composite`): + +`sudo powermetrics {{[-r|--order]}} {{pid|wakeups|cputime|composite}}` + +- Display output in machine-readable property list format and print a usage summary on exit: + +`sudo powermetrics {{[-f|--format]}} plist --show-usage-summary`