显示 Patroni 集群状态、拓扑和历史

命令

# Members, roles, state, timeline and lag (MB):
patronictl -c /etc/patroni/patroni.yml list <cluster>
# Extended info (pending restart, tags) + timestamp, refresh every 5 s:
patronictl -c /etc/patroni/patroni.yml list <cluster> -e -t -w 5
# Leader -> replica tree (including cascading replicas):
patronictl -c /etc/patroni/patroni.yml topology <cluster>
# Past failovers/switchovers (timeline, LSN, reason, time):
patronictl -c /etc/patroni/patroni.yml history <cluster>

作用

显示 Patroni 从 DCS 获取的集群视图：leader/replica 角色、成员状态（running/streaming）、timeline、复制延迟和待处理的重启；history 列出 timeline 变化及其发生时的 LSN。

适用场景

每次主备切换/故障转移/维护前后，以及告警触发时的首个诊断步骤。

注意

输出反映的是 DCS 中存储的内容；如果 DCS 不可达，命令会失败或可能显示过时数据。在确认所有成员处于同一 timeline 且 Lag in MB 低于 maximum_lag_on_failover 之前，不要开始主备切换。