9 PowerTOPコマンド・リファレンス
次の表に、powertop
コマンドの概要と、それで使用できるオプションを示します。
アクション | Command | 説明 |
---|---|---|
PowerTOPを対話モードで実行します。 |
sudo powertop
|
PowerTOPは、タブ付きインタフェースを使用して対話モードで起動されます。 タブには、「概要」、「アイドル統計」、「頻度統計」および「チューニング可能」があります。 |
HTMLレポートを生成します。 |
sudo powertop --html=filename
|
HTMLレポートが現在のディレクトリに作成されます。 ファイル名を指定しない場合、デフォルト名 |
CSVレポートを生成します。 |
sudo powertop --csv=filename
|
CSVレポートが現在のディレクトリに作成されます。 ファイル名を指定しない場合、デフォルト名 |
指定した時間間隔(「秒」)で指定した数のテスト(「反復」)を実行してHTMLレポートを生成 |
sudo powertop --html=filename --iteration=iterations --time=seconds
|
反復ごとにHTMLレポートが作成されます。 各HTMLファイルには、名前書式ファイル名を使用して名前が付けられます-たとえば、yyyyMMdd-hhmmss.html: |
指定した時間間隔(「秒」)で指定した数のテスト(「反復」)を実行してCSVレポートを生成 |
sudo powertop --csv=filename --iteration=iterations --time=seconds
|
反復ごとにCSVレポートが作成されます。 各CSVファイルには、名前書式ファイル名を使用して名前が付けられます-たとえば、yyyyMMdd-hhmmss.csvです: |
対話モードでのPowerTOPの使用
オプションを指定せずにpowertop
コマンドを実行して、対話モードでPowerTOPを使用します。
PowerTOPを対話モードで起動するには、次のコマンドを実行します:
sudo powertop
PowerTOPは、次の出力例に示すように、「概要」タブがアクティブになっているタブ付きインタフェースを使用して対話モードで起動します:
Overview Idle stats Frequency stats Device stats Tunables WakeUp
Summary: 1937.4 wakeups/second, 0.0 GPU ops/seconds, 0.0 VFS ops/sec and 18.2% CPU use
Usage Events/s Category Description
119.9 ms/s 1088.4 Process [PID 52069] /usr/libexec/qemu-kvm...
52.2 ms/s 663.9 Process [PID 52068] /usr/libexec/qemu-kvm -name ...
1.2 ms/s 60.4 Process [PID 1793] /usr/libexec/platform-pyth...
3.5 ms/s 24.7 Timer apic_timer_fn
80.0 µs/s 18.8 Process [PID 962] [xfsaild/dm-0]
60.1 µs/s 18.8 Process [PID 1459] [xfsaild/dm-1]
34.4 µs/s 10.9 Process [PID 15] [rcu_sched]
66.8 µs/s 9.9 kWork kvmclock_update_fn
670.7 µs/s 7.9 Timer tick_sched_timer
...
2.0 pkts/s Device nic:vnet0
1.0 pkts/s Device nic:virbr0
6.8 pkts/s Device Network interface: enp0s5 (virtio_net)
...
デフォルトでは、データは20秒ごとにリフレッシュされます。 リフレッシュ率を変更するには、キーボードの文字sを押し、新しい整数値を入力して、Enterを押します。
TabキーとShift+Tabキーを使用してタブ間を移動し、Arrowキーを使用して垂直方向と水平方向にスクロールできます。
次のリストは、対話モード・インタフェースの各タブの目的をまとめたものです。
概要
「概要」は、CPUおよびリソース使用率に基づいてプロセスおよびコンポーネントを降順にリストします。 「概要」タブには、次の列があります:
-
使用方法
システム内の各プロセスまたはコンポーネントのリソース使用率を表示します。
プロセス使用率は1秒当たりに割り当てられたCPU時間(
119.9 ms/s
など)で示され、ネットワーク・インタフェース使用率はパケットの処理速度(2.0 pkts/s
など)で示されます。 -
イベント/s
1秒当たりのウェイクアップ・イベントの数。 ウェイクアップの数が多いほど、消費電力は大きくなります。
-
カテゴリ
コンポーネントのタイプを示します。 たとえば、プロセス、タイマー、デバイスなどです。
-
説明
コンポーネントについて説明します。 たとえば、ネットワーク・インタフェースは次のように記述できます:
Network interface: enp0s5 (virtio_net)
.
アイドル統計
「アイドル統計」タブには、CPUコンポーネントが様々なC状態で使用している時間が表示されます。
C0
のC状態はアクティブ・コンポーネントに対応しますが、他のすべてのC状態(C1
、C2
...Cn
)はアイドル・スリープ状態(C番号が高いほどスリープ・モードが深い)に対応します。 使用可能なC状態は、システムで使用されているプロセッサによって異なります。
次の出力は、表示される情報のタイプの例を示しています:
Pkg(HW) | Core(HW) | CPU(OS) 0 CPU(OS) 64
| | C0 active 0.0% 0.0%
| | POLL 0.0% 0.0 ms 0.0% 0.0 ms
| | C1 0.0% 0.0 ms 0.0% 0.0 ms
C2 (pc2) 52.0% | | C1E 0.0% 0.5 ms 0.0% 0.0 ms
C3 (pc3) 0.0% | C3 (cc3) 0.0% |
C6 (pc6) 0.0% | C6 (cc6) 92.4% | C6 99.9% 59.4 ms100.0% 134.7 ms
C7 (pc7) 0.0% | C7 (cc7) 0.0% |
...
頻度統計
「頻度統計」タブには、プロセッサ・コンポーネントの頻度統計が表示されます。 低周波統計は、多くの場合、低消費電力を反映します。 次の出力は、表示される情報のタイプの例を示しています:
Package | Core | CPU 0 CPU 64
| | Average 3.2 GHz 1.7 GHz
Idle | Idle | Idle
800 MHz | 800 MHz | 800 MHz
3.40 GHz | 3.40 GHz | 3.40 GHz
| Core | CPU 1 CPU 65
| | Average 1.9 GHz 2.0 GHz
| Idle | Idle
| 800 MHz | 800 MHz
| 3.40 GHz | 3.40 GHz
...
チューニング可能
「チューニング可能」タブには、ステータス値が「正」または「不正」の電源チューニング設定がリストされます。 次の出力は、表示される情報のタイプの例を示しています:
PowerTOP 2.15 Overview Idle stats Frequency stats Device stats Tunables WakeUp
>> Bad Enable SATA link power management for host1
Bad Enable SATA link power management for host2
Bad Enable SATA link power management for host3
Bad VM writeback timeout
Bad Enable SATA link power management for host0
...
Good Autosuspend for USB device UHCI Host Controller [usb2]
Good Autosuspend for USB device UHCI Host Controller [usb4]
Good Autosuspend for USB device EHCI Host Controller [usb1]
...
「不正」と「正」を切り替えるには、Arrowキーを使用してカーソルを設定に移動し、Enterキーを押します。
ノート:
「チューニング可能」タブで行った変更はテストのみを目的としており、リブート後も保持されません。
ウェイクアップ
「ウェイクアップ」タブには、デバイスのウェイクアップ設定(「有効」または「無効」)が表示されます。 次の出力は、表示される情報のタイプの例を示しています:
>> Disabled Wake status for USB device usb3
Disabled Wake status for USB device usb1
Disabled Wake status for USB device 1-1
Disabled Wake status for USB device usb4
Disabled Wake status for USB device usb2
「無効」と「有効」を切り替えるには、Arrowキーを使用してカーソルを設定に移動し、Enterキーを押します。
ノート:
WakeUpタブで行った変更はテストのみを目的としており、リブート後も保持されません。
PowerTOPを使用したCSVレポートの生成
PowerTOPを使用して、レポートおよびデータ分析用のCSVレポートを生成します。
CSVレポートを生成するには、--csv
オプションを指定してpowertop
コマンドを実行します。 たとえば、現在のディレクトリにmy_csv_report.csv
というCSVレポートを生成するには、次のコマンドを実行します:
sudo powertop --csv=my_csv_report.csv
ファイル名を指定しない場合、レポートの名前はデフォルトでpowertop.csv
になります。
--iteration
および--time
オプションを使用して、指定した間隔で特定の数のレポートを生成することもできます。 たとえば、3つの新しいCSVレポートを60秒間隔で生成するには、次のコマンドを実行します:
sudo powertop --iteration=3 --time=60 --csv=my_csv_report.csv
出力は、次のようなものです。
...
Loaded 0 prior measurements
RAPL device for cpu 0
RAPL device for cpu 0
...
Preparing to take measurements
Taking 3 measurement(s) for a duration of 60 second(s) each.
PowerTOP outputting using base filename my_csv_report-20250117-135852.csv
PowerTOP outputting using base filename my_csv_report-20250117-135952.csv
PowerTOP outputting using base filename my_csv_report-20250117-140052.csv
...