
pt-proc-stat
============

概要
----

各プロセスごとのI/O統計量を表示します。

実行方法
--------

.. code-block:: none

   pt-proc-stat [option...] [delay [count]]


``pt-proc-stat`` コマンドは、procファイルシステムを参照します。PostgreSQLの実行ユーザ、またはrootユーザで実行する必要があります。

オプション
----------

.. code-block:: none

  -D, --pgdata=DATADIR
  -P, --pid=PID
  --help

``-D``, ``--pgdata`` オプションは、データベースクラスタのディレクトリを指定します。

``-P``, ``--pid`` オプションは、PostmasterプロセスのプロセスIDを指定します。

``-D`` （または ``--pgdata`` ）, ``-P`` （または ``--pid`` ）のいずれも指定しなかった場合は、全プロセスの中からPostmasterプロセスを探して、そのプロセスIDを対象とします。

複数のPostmasterプロセスが見つかった場合には、（プロセスIDの大小とは無関係に）そのうちの1つのみを対象とします。

出力項目
--------

.. csv-table::

   ``PROCESS NAME``, プロセス名
   ``PID``, プロセスID
   ``STAT``, プロセスのステータス
   ``USR``, ユーザCPU使用時間（差分）
   ``SYS``, システムCPU使用時間（差分）
   ``VSZ``, 仮想メモリサイズ（MB単位）
   ``RSS``, 物理メモリ使用量（MB単位）＿
   ``READ``, 読み込みのディスクI/O量（KB単位、差分）
   ``WRITE``, 書き込みのディスクI/O量（KB単位、差分）
   ``READ2``, ``READ`` を除いた読み込みI/O量（KB単位、差分）
   ``WRITE2``, ``WRITE`` を除いた書き込みI/O量（KB単位、差分）

実行例
------

Postmasterプロセスを自動的に探し、Postmasterおよび子プロセスの統計を5秒間隔で2回表示して終了します。

.. code-block:: none

   $ sudo ./pt-proc-stat 5 2
   Fri May  1 22:23:39 JST 2015
           PROCESS NAME[  PID] STAT  USR  SYS  VSZ  RSS   READ  WRITE  READ2 WRITE2
             postmaster[24026]    S    4   13  100    9  23752 1290092 1090800 155357
                 logger[24028]    S    0    1   85    1      4     76     30    -45
           checkpointer[24030]    S    4  117  100    8    176  56768   -176 -46965
                 writer[24031]    S  104   66  100    9      0 291080      0 130560
             wal writer[24032]    S    8   19  100    1      0   2928      0      0
    autovacuum launcher[24033]    S    3    3  101    2      8      8    288      0
        stats collector[24034]    S   13   32   85    1      0   2140     34   -649
   snaga postgres 127.0[25473]    R   32    9  101    7    296   1472   1264      0
   snaga postgres 127.0[25474]    R   33    9  101    7    424   1384   1120      0
   snaga postgres 127.0[25475]    R   33    9  101    7    424   1448   1016      0
   snaga postgres 127.0[25476]    S   32    9  101    7    580   1400    780      0
   snaga postgres 127.0[25477]    R   32    9  101    7    908   1368    492      0
   
   Fri May  1 22:23:44 JST 2015
           PROCESS NAME[  PID] STAT  USR  SYS  VSZ  RSS   READ  WRITE  READ2 WRITE2
             postmaster[24026]    S    0    0  100    9      0      0      0      0
                 logger[24028]    S    0    0   85    1      0      0      0      0
           checkpointer[24030]    S    0    0  100    8      0      0      0      0
                 writer[24031]    S    4    1  100    9      0  11928      0    392
             wal writer[24032]    S    0    0  100    1      0      0      0      0
    autovacuum launcher[24033]    S    0    0  101    2      0      0      0      0
        stats collector[24034]    S    0    0   85    1      0      0      0      0
   snaga postgres 127.0[25473]    R   72   18  101   10   1772   3608   1740      0
   snaga postgres 127.0[25474]    R   68   20  101   10   1436   3920   2020      0
   snaga postgres 127.0[25475]    D   70   18  101   10   1304   4216   2368      0
   snaga postgres 127.0[25476]    R   70   20  101   10   1252   3384   2212      0
   snaga postgres 127.0[25477]    R   73   16  101   10   1464   3224   2080      0
   
   $