PIDSTAT

Section: Linuxユーザーズマニュアル (1)
Updated: 2025年 1月
Index JM Home Page roff page
 

名前

pidstat - Linuxタスクの統計を報告します。

 

書式

pidstat [ -d ] [ -H ] [ -h ] [ -I ] [ -l ] [ -R ] [ -r ] [ -s ] [ -t ] [ -U [ username ] ] [ -u ] [ -V ] [ -v ] [ -w ] [ -C comm ] [ -G process_name ] [ --dec={ 0 | 1 | 2 } ] [ --human ] [ -o JSON ] [ -p { pid[,...] | SELF | ALL } ] [ -T { TASK | CHILD | ALL } ] [ interval [ count ] ] [ -e program args ]

 

説明

pidstat コマンドは、現在 Linux カーネルによって管理されている個々のタスクを監視するために使用されます。オプション -p で選択されたすべてのタスクか、オプション -p ALL が使用された場合は、Linuxカーネルによって管理されるすべてのタスクのアクティビティを標準出力に書き込みます。タスクを選択しない場合は、-p ALL を指定した場合と同じになります。ただし、レポートに表示されるのはアクティブタスク (統計情報の値が 0以外のタスク) のみです。

pidstat コマンドは、選択したタスクの子プロセスを監視するためにも使用できます。下記のオプション -T も参照してください。

interval パラメータは、各レポート間の時間間隔を秒単位で指定します。値がゼロの場合 (またはパラメータがまったくない場合)、システムの起動 (ブート) 以降のタスク統計情報がレポートされることを示します。count パラメータは、interval パラメータがゼロに設定されていない場合は、interval パラメータと組み合わせて指定できます。count の値は、interval 秒間隔で生成されるレポートの数を決定します。interval パラメータを指定せずにcount パラメータを指定した場合、pidstat コマンドはレポートを継続的に生成します。

フラグを使用して、特定のタスクアクティビティに関する情報を選択できます。フラグを指定しない場合は、CPU アクティビティのみが選択されます。

 

オプション

-C comm
コマンド名に文字列 comm が含まれるタスクのみを表示します。この文字列には正規表現を使用できます。
-d
I/O 統計情報をレポートします (カーネル2.6.20以降のみ)。以下の値が表示されます:
UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
kB_rd/s
タスクによってディスクから読み取られた 1秒あたりのキビバイト数。
kB_wr/s
タスクによってディスクに書き込まれた、または書き込まれることになる 1秒あたりのキビバイト数。
kB_ccwr/s
ディスクへの書き込みがタスクによってキャンセルされたキビバイト数。これは、タスクがダーティページキャッシュを切り捨てたときに発生する可能性があります。この場合、別のタスクが原因となっている一部の I/O は発生しません。
iodelay
監視対象タスクのブロック I/O 遅延です。クロックティック単位で測定されます。このメトリックには、同期ブロック I/O 補完およびスワップイン・ブロック I/O 補完の待機に費やされる遅延が含まれます。
Command
タスクのコマンド名。
--dec={ 0 | 1 | 2 }
小数点以下の桁数を指定します (0~2、既定値は2)。
-e program args
program を指定された引数 args で実行し、pidstat で監視します。pidstat は program が終了すると停止します。interval パラメーターには、ゼロ以外の値を指定する必要があります。
-G process_name
コマンド名に文字列 process_name が含まれるプロセスのみを表示します。この文字列には正規表現を使用できます。オプション -t をオプション -G とともに使用した場合、そのプロセスに属するスレッドも表示されます。これは、コマンド名に文字列 process_name が含まれない場合でも表示されます。
-H
時刻 (エポック) 以降のタイムスタンプを秒単位で表示します。
-h
すべてのアクティビティを 1行で水平に表示し、レポートの末尾に平均統計を表示しません。これは、他のプログラムによる解析を容易にすることを目的としています。
--human
人間が読める形式でサイズを印刷します (例:1.0k、1.2Mなど)。このオプションで表示される単位は、メトリクスに関連付けられている他の既定の単位 (例:キビバイト、セクタなど) よりも優先されます。
-I
SMP 環境では、タスクの CPU 使用量をオプション -u に表示されているようにプロセッサーの合計値で割るように指示します。
-l
プロセスのコマンド名とそのすべての引数を表示します。
-o JSON
統計情報を JSON (JavaScript Object Notation) 形式で表示します。JSON 出力フィールドの順序は未定義であり、将来新しいフィールドが追加される可能性があります。
-p { pid[,...] | SELF | ALL }
統計情報をレポートするタスク (プロセス) を選択します。pid はプロセスのID番号です。SELF キーワードは、pidstat プロセス自体について統計情報がレポートされることを示します。一方、ALL キーワードは、システムによって管理されるすべてのタスクについて統計情報がレポートされることを示します。
-R
リアルタイムの優先順位およびスケジューリングポリシー情報をレポートします。以下の値が表示されます:
UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
prio
監視されているタスクのリアルタイム優先度。
policy
監視対象のタスクのスケジューリングポリシー。
Command
タスクのコマンド名。
-r
ページフォルトとメモリ使用率をレポートします。

個々のタスクの統計をレポートする場合、次の値が表示されることがあります。

UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
minflt/s
タスクが 1秒間に発生させた、ディスクからメモリページをロードする必要がなかったマイナーフォールトの合計値。
majflt/s
タスクが 1秒あたりに発生した、ディスクからメモリページをロードする必要があったメジャーフォールトの合計値。
VSZ
仮想サイズ: タスク全体の仮想メモリー使用量 (キビバイト)。
RSS
常駐セットサイズ: タスクによって使用される、スワップされない物理メモリー (キビバイト)。
%MEM
タスクが現在使用している、利用可能な物理メモリのシェアです。
Command
タスクのコマンド名。
タスクとそのすべての子のグローバル統計をレポートする場合、次の値が表示されることがあります。
UID
子とともに監視されているタスクの実際のユーザー識別番号。
USER
子とともに監視されているタスクを所有する実際のユーザーの名前。
PID
子とともに監視されているタスクの識別番号。
minflt-nr
計測期間中に収集された、タスクおよびそのすべての子によって発生したマイナー・フォルトの合計値。
majflt-nr
計測期間中に収集された、タスクおよびそのすべての子によって発生したメジャー・フォルトの合計値。
Command
子とともに監視されているタスクのコマンド名。
-s
スタック使用率をレポートします。以下の値が表示されます:
UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
StkSize
タスク用にスタックとして予約されているが、必ずしも使用されていないメモリの量 (キビバイト単位)。
StkRef
スタックとして使用され、タスクによって参照されるキビバイト単位のメモリ量。
Command
タスクのコマンド名。
-T { TASK | CHILD | ALL }
このオプションは、pidstat コマンドで何をモニターするかを指定します。TASK キーワードは、統計情報が個々のタスクについてレポートされることを示します (これは既定のオプションです)。一方、CHILD キーワードは、統計情報が選択したタスクとそのすべての子についてグローバルにレポートされることを示します。ALL キーワードは、統計が個々のタスクに対してレポートされ、また、選択したタスクとその子に対してグローバルにレポートされることを示します。

注意:タスクとそのすべての子のグローバル統計は、pidstat のすべてのオプションで使用できるわけではありません。また、これらの統計は、現在の時間間隔に必ずしも関連しているわけではありません。子プロセスの統計は、子プロセスが終了するか強制終了された場合にのみ収集されます。

-t
選択したタスクに関連付けられているスレッドの統計も表示します。

このオプションによって、レポートに次の値が追加されます。

TGID
スレッド・グループ・リーダーの識別番号。
TID
モニタされているスレッドの ID 番号。
-U [ username ]
UID の代わりに、監視されているタスクの実際のユーザー名を表示します。username が指定されている場合は、指定されたユーザーに属するタスクのみが表示されます。
-u
CPU使用率をレポートします。

個々のタスクの統計をレポートする場合、次の値が表示されることがあります。

UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
%usr
nice 優先順位の有無にかかわらず、ユーザーレベル (アプリケーション) での実行中にタスクが使用した CPU の割合。このフィールドには、仮想プロセッサの実行に費やされた時間は含まれないことに注意してください。
%system
システムレベル (カーネル) での実行中にタスクが使用した CPU の割合。
%guest
仮想マシン内のタスクが消費した CPU の割合 (仮想プロセッサを実行)。
%wait
実行待機中にタスクが消費した CPU の割合。
%CPU
タスクで使用される CPU 時間の合計割合。SMP 環境では、コマンド行上でオプション -I が入力されている場合、タスクの CPU 使用率は CPU の合計値で除算されます。
CPU
タスクがアタッチされているプロセッサ番号。
Command
タスクのコマンド名。
タスクとそのすべての子のグローバル統計をレポートする場合、次の値が表示されることがあります。
UID
子とともに監視されているタスクの実際のユーザー識別番号。
USER
子とともに監視されているタスクを所有する実際のユーザーの名前。
PID
子とともに監視されているタスクの識別番号。
usr-ms
計測期間中に収集された、ユーザーレベル (アプリケーション) での実行中に、nice 優先順位の有無にかかわらず、タスクおよびそのすべての子によって費やされたミリ秒の合計値。このフィールドには、仮想プロセッサの実行に費やされた時間は含まれないことに注意してください。
system-ms
計測時間中に、タスクおよびそのすべての子タスクがシステムレベル (カーネル) での実行中に消費した時間の合計 (ミリ秒単位) です。
guest-ms
仮想マシン (仮想プロセッサを実行している) でタスクとそのすべての子が費やしたミリ秒の合計。
Command
子とともに監視されているタスクのコマンド名。
-V
バージョン番号を出力して終了します。
-v
いくつかのカーネルテーブルの値をレポートします。以下の値が表示されます:
UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
threads
現在のタスクに関連付けられているスレッドの数。
fd-nr
現在のタスクに関連づけられているファイルディスクリプタの数。
Command
タスクのコマンド名。
-w
タスクの切り替えアクティビティ (カーネル2.6.23以降のみ) をレポートします。以下の値が表示されます:
UID
監視されているタスクの実ユーザー識別番号。
USER
監視対象のタスクを所有する実際のユーザーの名前。
PID
監視対象のタスクの ID 番号。
cswch/s
1秒あたりに作成されたタスクを切り替える自発的なコンテキストの合計値。自発的なコンテキストスイッチは、使用できないリソースを必要とするためにタスクがブロックされたときに発生します。
nvcswch/s
1秒あたりに作成されたタスクを切り替える非自発的コンテキストの総数。非自発的なコンテキストスイッチは、タスクがそのタイムスライスの間実行され、その後、強制的にプロセッサを放棄させられたときに発生します。
Command
タスクのコマンド名。

 

環境変数

pidstat コマンドは、次の環境変数を参照します。
S_COLORS
出力がターミナルに接続されている場合、既定では、端末ごとに統計情報がカラーで表示されます。この変数を使用して、設定を変更します。取り得る値は、never、always またはauto (後者は既定の設定と同等ですです。
値の表示に使用されている色 (赤、黄、またはその他の色) は、単に色が原因で何らかの問題が発生していることを示すものではありません。異なる値の範囲を示しているだけです。
S_COLORS_SGR
端末に関する統計情報の表示に使用する色およびその他の属性を指定します。その値は、コロンで区切られたケイパビリティのリストで、既定値は I=32;22:N=34;1:W=35;1:X=31;1:Z=34;22 です。サポートされる機能は次のとおりです:
I=
アイテムの値 (PID、UID、CPU番号など) のための SGR (Select Graphic Rendition) 部分文字列。
N=
ゼロ以外の統計値およびタスク名の SGR 部分文字列。
W= (又は M=)
75%から 90% (またはメトリックの意味に応じて 10%から 25%) の範囲の割合に対する SGR 部分文字列。
X= (又は H=)
割合が 90%以上のSGR 部分文字列 (あるいはメトリックの意味に応じて10%以下)。
Z=
ゼロ値およびスレッド名の SGR 部分文字列。
S_TIME_FORMAT
この変数が存在し、その値が ISO の場合、レポートヘッダーに日付を印刷するときに、現在のロケールが無視されます。pidstatコマンドは、代わりに ISO 8601 形式 (YYYY-MM-DD) を使用します。タイムスタンプも ISO 8601 形式に準拠します。

 

使用例

pidstat 2 5
システムのアクティブタスクごとに、CPU 統計のレポートを 2秒間隔で 5つ表示します。
pidstat -r -p 1643 2 5
PID 1643 のページフォルトとメモリ統計のレポートを 2秒間隔で 5つ表示します。
pidstat -C "fox|bird" -r -p ALL
コマンド名に文字列「fox」または「bird」を含むすべてのプロセスについて、グローバルページフォルトとメモリー統計を表示します。
pidstat -T CHILD -r 2 5
システム内のすべてのタスクの子プロセスについて、ページフォルト統計のレポートを 2秒間隔で 5つ表示します。統計情報の値が 0以外の子プロセスだけが表示されます。

 

バグ

pidstat コマンドが作動するためには、/proc ファイルシステムがマウントされている必要があります。

pidstat は、キロバイト (kB)、メガバイト (MB)…に対応するユニットを表示しますが、実際にはキビバイト (kiB)、メビバイト (MiB)…を使用します。キビバイトは 1024バイト、メビバイトは 1024キビバイトに相当します。

 

ファイル

/proc には、システム統計を含むさまざまなファイルが含まれています。

 

著者

Sebastien Godard (sysstat <at> orange.fr)

 

関連項目

sar(1), top(1), ps(1), mpstat(1), iostat(1), vmstat(8)

https://github.com/sysstat/sysstat
https://sysstat.github.io/


 

Index

名前
書式
説明
オプション
環境変数
使用例
バグ
ファイル
著者
関連項目

This document was created by man2html, using the manual pages.