
pt-replication-stat
===================

概要
----

レプリケーションのマスターのノードの統計情報を参照してレプリケーションの実行状況を表示します。指定したインターバルごとに連続的に表示することも可能です。

PostgreSQL 9.1またはそれ以降のバージョンで動作します。PostgreSQL 9.0は ``pg_stat_replication`` システムビューが無いため、動作しません。

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

.. code-block:: none

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

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

.. code-block:: none

  -h, --host=HOSTNAME
  -p, --port=PORT
  -U, --username=USERNAME
  -d, --dbname=DBNAME


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

.. csv-table::

   ``PID``, マスターノードで動作しているWAL送信プロセスのプロセスID
   ``NAME``, レプリケーション先として登録されているスレーブノードの名称
   ``HOST``, スレーブノードのホスト名またはIPアドレス
   ``PORT``, スレーブノードに接続しているマスターノードのポート番号
   ``STATE``, スレーブノードの状態です。 ``startup`` 、 ``backup`` 、 ``catchup`` 、 ``streaming`` のいずれかを取る。
   ``SENT``, スレーブへ送信されたWAL上の位置
   ``WRITTTEN``, スレーブ上でのWALバッファへの書き込みされたWAL上の位置
   ``FLUSHED``, スレーブ上でのWALファイルへの同期書き込みされたWAL上の位置
   ``REPLAYED``, スレーブ上でのデータファイルへの適用されたWAL上の位置
   ``PRI``, スレーブノードが同期レプリケーションの場合の、ノードの優先度を表示します。
   ``MODE``, 動作しているモードを表示します。``sync`` は同期モード、``async`` は非同期モード、``potential`` は非同期モードで動作中ではあるが同期モードに昇格する可能性がある。


実行例
------

ホスト ``127.0.0.1`` のポート ``5433`` にユーザ ``postgres`` で接続し、5秒ごとに統計情報を2回表示して終了します。

.. code-block:: none

   $ pt-replication-stat -h 127.0.0.1 -p 5433 -U postgres 5 2
   Sat Mar 28 21:45:23 JST 2015
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   | PID  |   NAME   |    HOST   |  PORT |   STATE   |    SENT   |  WRITTTEN |  FLUSHED  |  REPLAYED | PRI |  MODE  |
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   |      |          |           |       | local     | 0/5F30398 | 0/5F300B0 |           |           |     | master |
   | 3323 | replica1 | 127.0.0.1 | 55580 | streaming | 0/5F300B0 | 0/5F300B0 | 0/5F300B0 | 0/5F2FE48 |   0 | async  |
   | 3367 | replica2 | 127.0.0.1 | 55589 | streaming | 0/5F300B0 | 0/5F300B0 | 0/5F2FE48 | 0/5F2FE48 |   0 | async  |
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   
   Sat Mar 28 21:45:28 JST 2015
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   | PID  |   NAME   |    HOST   |  PORT |   STATE   |    SENT   |  WRITTTEN |  FLUSHED  |  REPLAYED | PRI |  MODE  |
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   |      |          |           |       | local     | 0/608CD68 | 0/608CAC0 |           |           |     | master |
   | 3323 | replica1 | 127.0.0.1 | 55580 | streaming | 0/608CAC0 | 0/608CAC0 | 0/608C7D8 | 0/608C7D8 |   0 | async  |
   | 3367 | replica2 | 127.0.0.1 | 55589 | streaming | 0/608CAC0 | 0/608CAC0 | 0/608C7D8 | 0/608C7D8 |   0 | async  |
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   
   $

``localhost`` のデフォルトポート（``5432``）に接続して、5秒ごとに統計情報を表示し続けます。CTRL-Cで終了します。

.. code-block:: none

   $ pt-replication-stat -h localhost 5
   Sat Mar 28 21:45:23 JST 2015
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   | PID  |   NAME   |    HOST   |  PORT |   STATE   |    SENT   |  WRITTTEN |  FLUSHED  |  REPLAYED | PRI |  MODE  |
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   |      |          |           |       | local     | 0/5F30398 | 0/5F300B0 |           |           |     | master |
   | 3323 | replica1 | 127.0.0.1 | 55580 | streaming | 0/5F300B0 | 0/5F300B0 | 0/5F300B0 | 0/5F2FE48 |   0 | async  |
   | 3367 | replica2 | 127.0.0.1 | 55589 | streaming | 0/5F300B0 | 0/5F300B0 | 0/5F2FE48 | 0/5F2FE48 |   0 | async  |
   +------+----------+-----------+-------+-----------+-----------+-----------+-----------+-----------+-----+--------+
   
   ^C[2015-03-28 21:45:25] INFO: Terminated.
   $