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