pgd replication show
====================

概要
----

``pgd replication show`` コマンドは、 EDB
Postgres分散クラスターでのレプリケーションステータスを表示するために使用されます。

オプションなしのデフォルトでは、次のレポートを生成します。

- ノードレプリケーションの進行状況
  ノード間のレプリケーションステータスのマトリックス。

- Replication Slots
  各ノードのスロットのレプリケーションスロットステータス。

- サブスクリプション
  ノード間の各サブスクリプションのサブスクリプションステータス。

- 分析レプリケーション 各ノードの分析レプリケーションステータス。

オプションを使用して、出力を上記のレポートのいずれかに制限できます。
``--verbose``
オプションを使用して、デフォルトレポートの詳細を増やし、各ノードの他のノードへの接続のLSNとレプリケーションラグを表示できます。

ユーザーとロール
^^^^^^^^^^^^^^^^

``bdr_monitor`` ロール以上が必要です。 :ref:`ユーザーロール <ユーザーロール>` 
を参照してください。

構文
----

.. code:: plaintext

   pgd replication show [OPTIONS]

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

``pgd replication show`` コマンドでは、次のオプションが使用できます。

.. csv-table::
  :header: Short,Long,Description
  :widths: 12,10,25
  :align: left
  :class: longtable

  "",--nodes,ノード間のレプリケーション状態のみをマトリックス形式で表示します。
  "",--slots,各ノードのレプリケーションスロットを表示します。
  "",--subscriptions,ノード間の各サブスクリプションのサブスクリプションステータスを表示します。
  "",--analytics,各ノードの分析レプリケーションステータスを表示します。
  -v,--verbose,レプリケーションステータスに関する詳細情報を表示します。

共通のグローバルオプションについては、 :ref:`グローバルオプション <グローバルオプション>` を参照してください。

–slots
^^^^^^

これは、 BDRレプリケーションスロットのステータスを示します。
verboseフラグを使用した出力は、スロットがアクティブか、レプリケーション状態切断、ストリーミング、キャッチアップ、おおよその遅延などの詳細を提供します。

.. csv-table::
  :header: Symbol,Meaning
  :widths: 10,30
  :align: left
  :class: longtable

  `*`,ok
  `~`,warning (lag > 10M)
  `!`,critical (lag > 100M OR slot is 'inactive' OR 'disconnected')
  `x`,down / unreachable
  `-`,n/a

マトリックスビューでは、バイトラグが括弧内に表示される場合があります。
maxOf(WriteLag, FlushLag, ReplayLag, SentLag)です。

例
--

EDB Postgres分散クラスターでのレプリケーションステータスの表示
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: shell

   pgd replication show
   __OUTPUT__

   #  Node Replication Progress

   Node   kaboom kaftan kaolin
   - ----- ------ ------ ------
   kaboom -       **      
   kaftan  *-*      
   kaolin  **       -     

   #  Replication Slots

   Group Name   Origin Node Target Node Slot Name                      Active State     Write Lag Replay Lag Sent Lag Bytes Write Lag Bytes Replay Lag Bytes
   - ----------- ----------- ----------- ------------------------------ ------ --------- --------- ---------- -------------- --------------- ----------------
   dc1_subgroup kaboom      kaftan      bdr_pgddb_democluster15_kaftan t      streaming 00:00:00  00:00:00   0              0               0               
   dc1_subgroup kaboom      kaolin      bdr_pgddb_democluster15_kaolin t      streaming 00:00:00  00:00:00   0              0               0               
   dc1_subgroup kaftan      kaboom      bdr_pgddb_democluster15_kaboom t      streaming 00:00:00  00:00:00   0              0               0               
   dc1_subgroup kaftan      kaolin      bdr_pgddb_democluster15_kaolin t      streaming 00:00:00  00:00:00   0              0               0               
   dc1_subgroup kaolin      kaboom      bdr_pgddb_democluster15_kaboom t      streaming 00:00:00  00:00:00   0              0               0               
   dc1_subgroup kaolin      kaftan      bdr_pgddb_democluster15_kaftan t      streaming 00:00:00  00:00:00   0              0               0               

   #  Subscriptions

   Origin Node Target Node Last Applied Tx Timestamp      Last Applied Tx Age Subscription Status
   - ---------- ----------- ------------------------------ ------------------- -------------------
   kaboom      kaftan      2025-02-21 19:18:12.661520 UTC 00:00:18.616        replicating        
   kaboom      kaolin      2025-02-21 19:18:12.661520 UTC 00:00:18.939        replicating        
   kaftan      kaboom      2025-02-21 19:18:12.658069 UTC 00:00:18.787        replicating        
   kaftan      kaolin      2025-02-21 19:18:12.658069 UTC 00:00:18.943        replicating        
   kaolin      kaboom      2025-02-21 19:18:12.663201 UTC 00:00:18.782        replicating        
   kaolin      kaftan      2025-02-21 19:18:12.663201 UTC 00:00:18.614        replicating        

   #  Analytics Replication Progress

   Origin Node Replicating Node Replicated LSN Last Updated
   - ---------- ---------------- -------------- ------------

ノード間のレプリケーション状態のみをマトリックス形式で表示する
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: shell

   pgd replication show --nodes
   __OUTPUT__
   Node   kaboom kaftan kaolin
   - ----- ------ ------ ------
   kaboom -       **      
   kaftan  *-*      
   kaolin  **       -   
