
pt-xact-stat
============

概要
----

複数ノードのトランザクションの統計状況を表示します。指定したインターバルごとに連続的に表示することも可能です。

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

.. code-block:: none

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

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

.. code-block:: none

  -h, --host=HOSTNAME
  -p, --port=PORT
  -H, --host-list=HOSTLIST
  -U, --username=USERNAME
  -d, --dbname=DBNAME
  -H, --host-list=HOSTNAME:PORT,HOSTNAME:PORT[,...]

``-h``, ``--host`` オプションは、接続するPostgreSQLデータベースのサーバ名またはIPアドレスを指定します。オプションが指定されない場合は、PGHOST環境変数に設定された値が使われます。PGHOST環境変数が設定されていない場合には、デフォルトの値として ``localhost`` が使われます。

``-p``, ``--port`` オプションは、接続するPostgreSQLデータベースのポート番号を指定します。オプションが指定されない場合は、PGPORT環境変数に設定された値が使われます。PGPORT環境変数が設定されていない場合には、デフォルトの値として ``5432`` が使われます。

``-H``, ``--host-list`` オプションは、接続するPostgreSQLサーバが複数ある場合にデータベースのサーバ名またはIPアドレスとポート番号の組み合わせを複数指定します。書式は ``192.168.1.101:5432,192.168.1.102:5433`` のように、一組のサーバ名とポート番号をコロン ``:`` で連結し、複数のサーバをカンマ ``,`` で連結します。ポート番号は省略可能で、省略した場合はデフォルトのポート番号が使われます。

``-U``, ``--username`` オプションは、PostgreSQLデータベースに接続するユーザ名を指定します。オプションが指定されない場合は、PGUSER環境変数に設定された値が使われます。PGUSER環境変数が設定されていない場合には、USER環境変数に設定された値が使われます。

``-d``, ``--dbname`` オプションは、接続するデータベース名を指定します。オプションが指定されない場合は、PGDATABASE環境変数に設定された値が使われます。PGDATABASE環境変数が設定されていない場合には、データベースに接続するユーザ名と同じ名前のデータベースに接続します。


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

.. csv-table::

   ``HOST``, PostgreSQLサーバのホスト名
   ``PORT``, PostgreSQLサーバのポート番号
   ``DBNAME``, データベース名
   ``CONN``, データベースに接続しているセッション数
   ``COMMITS``, コミットされたトランザクション総数
   ``ROLLBACKS``, ロールバックされたトランザクション総数
   ``B_READ``, ディスクから読み込まれたテーブルのブロック数
   ``B_HIT``, 共有バッファから読み込まれたテーブルのページ数


実行例
------

ローカルホストのポート5432とポート5433で動作している2つのPostgreSQLインスタンスに接続して、各インスタンスのトランザクションの統計情報を5秒おきに2回表示します。

.. code-block:: none

   $ pt-xact-stat --host-list 127.0.0.1:5432,127.0.0.1:5433,127.0.0.1:5434 -d postgres 5 2
   Sat Mar 28 20:47:50 JST 2015
   +-----------+------+----------+------+---------+-----------+--------+-------+
   |    HOST   | PORT |  DBNAME  | CONN | COMMITS | ROLLBACKS | B_READ | B_HIT |
   +-----------+------+----------+------+---------+-----------+--------+-------+
   | 127.0.0.1 | 5432 | postgres |    1 |     137 |         1 |    104 | 10273 |
   | 127.0.0.1 | 5433 | postgres |    1 |       8 |         0 |    104 |  1350 |
   | 127.0.0.1 | 5434 | postgres |    1 |      76 |         0 |    104 |  7708 |
   +-----------+------+----------+------+---------+-----------+--------+-------+
   
   Sat Mar 28 20:47:55 JST 2015
   +-----------+------+----------+------+---------+-----------+--------+-------+
   |    HOST   | PORT |  DBNAME  | CONN | COMMITS | ROLLBACKS | B_READ | B_HIT |
   +-----------+------+----------+------+---------+-----------+--------+-------+
   | 127.0.0.1 | 5432 | postgres |    1 |     139 |         1 |    104 | 10460 |
   | 127.0.0.1 | 5433 | postgres |    1 |      10 |         0 |    104 |  1537 |
   | 127.0.0.1 | 5434 | postgres |    1 |      78 |         0 |    104 |  7895 |
   +-----------+------+----------+------+---------+-----------+--------+-------+
   
   $

ローカルホストのポート5432, ポート5433, ポート5434で動作している3つのPostgreSQLインスタンスに接続して、各インスタンスのトランザクションの統計情報を1回表示して終了します。

.. code-block:: none

   $ pt-xact-stat --host-list 127.0.0.1:5432,127.0.0.1:5433,127.0.0.1:5434 -d postgres
   Sat Mar 28 21:05:48 JST 2015
   +-----------+------+----------+------+---------+-----------+--------+-------+
   |    HOST   | PORT |  DBNAME  | CONN | COMMITS | ROLLBACKS | B_READ | B_HIT |
   +-----------+------+----------+------+---------+-----------+--------+-------+
   | 127.0.0.1 | 5432 | postgres |    1 |      12 |         0 |    104 |  1400 |
   | 127.0.0.1 | 5433 | postgres |    1 |       4 |         0 |    104 |   976 |
   | 127.0.0.1 | 5434 | postgres |    1 |       4 |         0 |    104 |   976 |
   +-----------+------+----------+------+---------+-----------+--------+-------+
   
   $