pgd events show
===============

概要
----

``pgd events show`` コマンドは、 EDB
Postgres分散クラスターでイベントを表示するために使用されます。追加フラグがない場合、このコマンドは、すべてのノードとグループの最新の20件のイベントを表示します。

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

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

構文
----

.. code:: plaintext

   pgd events show [OPTIONS]

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

次の表は、\ ``pgd events show``
コマンドで使用可能なオプションをリストしています。

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

  "",`--node <NODE_NAME>`,指定された名前のノードのイベントのみを表示します。
  "",`--group <GROUP_NAME>`,指定された名前のグループのイベントのみを表示します。
  `-n`,`--limit <LIMIT>`,表示するイベントの数を制限します。デフォルト20

`Global Options <https://www.enterprisedb.com/docs/pgd/latest/reference/cli/command_ref/#global-options>`_  も参照してください。

ノードの状態
------------

.. csv-table::
  :header: State,Description
  :widths: 10,30
  :align: left
  :class: longtable

  NONE,ワーカーが起動したときにノードの状態は設定解除され、現在の既知の状態にすぐに設定されることが予想されます。
  CREATED,bdr.create_node()は実行されましたが、ノードはまだEDB Postgres分散クラスターのメンバーではありません。
  JOIN_START,bdr.join_node_group()は、ローカルノードの既存のEDB Postgres分散クラスターへの参加を開始します。
  JOINING,ノード参加が開始され、現在初期同期フェーズにあり、ノードにスキーマとデータを作成しています。
  CATCHUP,初期同期フェーズが完了しました。現在、結合は、結合が開始されてから上流のピアノードで実行されたトランザクションを取得および適用する最後のステップにあります。
  STANDBY,ノードの参加は完了しましたが、変更のブロードキャストはまだ開始されていません。すべての結合はこの状態でしばらく時間を費やしますが、論理スタンバイとして定義されている場合、ノードはこの状態で継続します。
  PROMOTE,ノードはロジカルスタンバイであり、bdr.promote_nodeを呼び出してノードの状態をACTIVEに移動したところです。これらの2つのPROMOTE状態は、1つのノードのみがSTANDBYより高いがACTIVEより低い状態になることができるという事実と一貫している必要があります。
  PROMOTING,ロジカルスタンバイからフルBDRノードへの昇格が進行中です。
  ACTIVE,ノードは完全なBDRノードであり、現在アクティブです。これは、最も一般的なノードのステータスです。
  PART_START,ノードがアクティブまたはスタンバイで、 bdr.part_nodeを呼び出してEDB Postgres分散クラスターからノードを削除したところです。
  PARTING,ノードは他のノードから切断し、コンセンサスまたはレプリケーションでそれ以上の役割を果たしません。
  PART_CATCHUP,非分割ノードは、最近分割されたノードからの欠落データを同期します。
  PARTED,これで、すべてのノードでノード分離操作が完了しました。

一度に1つのノードのみがPROMOTEまたはPROMOTINGの状態になります。
STANDBYは、ノードが読み取り専用状態にあることを示します。

例
--

最新5件のイベントを表示します
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: shell

   $ pgd events show -n 5
   __OUTPUT__
   Event Time                     Event Observer Event Subject Event Source Event Type Event Subtype Event Text    Event Detail                                                                                            
   - ----------------------------- -------------- ------------- ------------ ---------- ------------- ------------- --------------------------------------------------------------------------------------------------------
   2025-02-21 17:44:00.444902 UTC kaolin         kaftan        consensus    ROUTING    STATE_CHANGE  WRITE_LEADER  dc1_subgroup                                                                                            
   2025-02-21 17:44:00.445080 UTC kaolin         kaolin        consensus    ROUTING    STATE_CHANGE  RAFT_LEADER   {"raft_leader":"kaolin","group_name":"dc1_subgroup","read_nodes_version":1,"read_nodes":"kaboom,kaolin"}
   2025-02-21 17:44:00.452029 UTC kaftan         kaftan        consensus    ROUTING    STATE_CHANGE  LEADER_UPDATE                                                                                                         
   2025-02-21 17:44:00.456483 UTC kaboom         kaboom        consensus    ROUTING    STATE_CHANGE  LEADER_UPDATE                                                                                                         
   2025-02-21 17:44:00.456667 UTC kaolin         kaolin        consensus    ROUTING    STATE_CHANGE  LEADER_UPDATE     
