pgd raft show#

概要#

pgd raft show コマンドは、EDB Postgres分散クラスターのRaftコンセンサス情報を表示します。デフォルトでは、3つのセクションが表示されます。

  • State すべてのノードのコンセンサス状態、bdr.stat_raft_state から取得。

  • フォロワー リーダーノードから見たフォロワーの状態、 bdr.stat_raft_followers_state からソース。

  • ジャーナル グローバルコンセンサスジャーナルの詳細、bdr.global_consensus_journal_details から出典。

3つすべてを表示するにはセクションフラグを指定せずにコマンドを実行するか、 --state 、--followers 、または--journal を使用してそのセクションのみを表示します。これらのフラグは相互排他的です。

ユーザーとロール#

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

構文#

pgd raft show [OPTIONS]

オプション#

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

セクションフラグ#

Short

Long

Description

--state

Stateセクションのみを表示します`bdr.stat_raft_state`からのコンセンサス状態

--followers

Followersセクション`bdr.stat_raft_followers_state`からのフォロワー状態のみを表示します。

--journal

Journalセクションのみを表示します`bdr.global_consensus_journal_details`からのグローバルジャーナルの詳細。

これらのフラグは相互排他的です。

セクションオプション#

Short

Long

Applies to

Default

Description

--group

All states

グループ名で出力をフィルタリングします。

-n

--limit

--journal

20

表示されるジャーナルエントリの数を制限します。

表形式の出力には、使用可能なフィールドのサブセットが表示されます。 leader_id 、voted_for_id 、およびnode_id は、完全なフィールドセットにのみ含まれます。完全なフィールドセットには--output json または--output markdown を使用します。

共通のグローバルオプションについては、 Global Options を参照してください。

例#

すべてのノードのRaftの状態を表示する#

pgd raft show --state
__OUTPUT__
Group Name    Node Name State         Leader Name Term Commit Index Apply Index Last Log Index Is Voting Nodes Voting Nodes Protocol Version
- ------------ --------- ------------- ----------- ---- ------------ ----------- -------------- --------- ----- ------------ ----------------
dc1_subgroup  kaftan    RAFT_LEADER   kaftan      1    4            4           4              true      3     3            0
dc1_subgroup  kaboom    RAFT_FOLLOWER kaftan      1    4            4           4              true      3     3            0
dc1_subgroup  kaolin    RAFT_FOLLOWER kaftan      1    4            4           4              true      3     3            0
democluster   kaftan    RAFT_LEADER   kaftan      0    335          335         335            true      3     3            5007
democluster   kaboom    RAFT_FOLLOWER kaftan      0    335          335         335            true      3     3            5007
democluster   kaolin    RAFT_FOLLOWER kaftan      0    335          335         335            true      3     3            5007

この出力では、 dc1_subgroup はローカルルーティングを使用するデータグループであり、 democluster はグローバルルーティングを使用するトップレベルグループです。

Term 列には、現在のRaft用語番号が表示されます。 Commit Index は、最後にコミットされたログエントリのインデックスを示します。 Apply Index およびLast Log Index は、ノードがそれぞれログエントリを適用および受信した範囲を示します。 Is Voting は、ノードがRaft選挙に参加するかどうかを示します。 Nodes は、グループ内のノードの合計数を示します。 Voting Nodes は、Raftコンセンサスに参加するノードの数を示します。 Protocol Version は、使用中のRaftプロトコルのバージョンを示します。

特定のグループのフォロワーの状態を表示する#

pgd raft show --followers --group dc1_subgroup
__OUTPUT__
Group Name    Node Name Sent Commit Index Match Index Clock Drift (ms)
- ------------ --------- ---------------- ----------- ----------------
dc1_subgroup  kaboom    4                4           -2
dc1_subgroup  kaolin    4                3           5

Sent Commit Index は、リーダーが各フォロワーに最後に送信したコミットインデックスです。 Match Index は、そのフォロワーでレプリケートされたことが確認された最大のログインデックスです。 Clock Drift (ms) は、ミリ秒単位のリーダーとフォロワー間のおおよそのクロック差です。

カスタム制限を使用して仕訳項目を表示する#

pgd raft show --journal --limit 5
__OUTPUT__
Group Name    Origin Log Index Term Message Type  Response Type
- ------------ ------ --------- ---- ------------- ---------------------------
democluster   kaftan 335       0    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE
democluster   kaftan 334       0    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE
democluster   kaftan 333       0    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE
democluster   kaftan 332       0    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE
democluster   kaftan 331       0    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE

特定のグループのすべてのセクションを表示する#

pgd raft show --group dc1_subgroup
__OUTPUT__

#  State

Group Name    Node Name State         Leader Name Term Commit Index Apply Index Last Log Index Is Voting Nodes Voting Nodes Protocol Version
- ------------ --------- ------------- ----------- ---- ------------ ----------- -------------- --------- ----- ------------ ----------------
dc1_subgroup  kaftan    RAFT_LEADER   kaftan      1    4            4           4              true      3     3            0
dc1_subgroup  kaboom    RAFT_FOLLOWER kaftan      1    4            4           4              true      3     3            0
dc1_subgroup  kaolin    RAFT_FOLLOWER kaftan      1    4            4           4              true      3     3            0

#  Followers

Group Name    Node Name Sent Commit Index Match Index Clock Drift (ms)
- ------------ --------- ---------------- ----------- ----------------
dc1_subgroup  kaboom    4                4           -2
dc1_subgroup  kaolin    4                3           5

#  Journal

Group Name    Origin Log Index Term Message Type  Response Type
- ------------ ------ --------- ---- ------------- ---------------------------
dc1_subgroup  kaftan 4         1    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE
dc1_subgroup  kaftan 3         1    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE
dc1_subgroup  kaftan 2         1    CONFIG_CHANGE CONFIG_CHANGE_RESPONSE