Действия с топологией кластера
Обзор
|
ПРИМЕЧАНИЕ
Кликните иконку |
Топология кластера отображается на странице Topology веб-интерфейса ADP Control. Вы можете выбрать кластер, для которого требуется представить топологию, из раскрывающегося списка Cluster в верхней части страницы. После выбора кластера в полях Postgres и Patroni, расположенных рядом с полем Cluster, будут отображены версии ADP/PostgreSQL и patroni соответственно. На схеме топологии показаны все ноды кластера с PostgreSQL/сервисом ADPG. Ноды соединены друг с другом стрелками, указывающими направление потоков репликации.
На схеме отображается следующая информация для каждой ноды:
-
Роль в кластере:
Leader,Async replica,Sync replica. -
Имя ноды.
-
Статус:
Running,Stopping,Initializing,Stopped,Failed,Unknown,Out of patroni.
Для нод-реплик на диаграмме топологии отображается lag (в байтах) — количество байт, на которое состояние реплики отстает от состояния лидера.
В таблице ниже показано сопоставление состояний нод patroni с состояниями, указанными на диаграмме.
| Статус ноды на диаграмме | Статус patroni |
|---|---|
Running |
running, streaming |
Stopping |
stopping |
Initializing |
|
Stopped |
stopped |
Failed |
|
Unknown |
Нода с неизвестным статусом |
Out of patroni |
Нода не находится в кластере, например, если на ноде остановлен сервис patroni |
Отображение сведений о ноде
Вы можете кликнуть ноду на диаграмме, чтобы отобразить следующие сведения:
-
CPU — процент использования CPU;
-
RAM — процент использования RAM;
-
Disk — процент использования диска;
-
Lag — количество байт, на которое состояние реплики отстает от состояния лидера;
-
Delay — задержка времени между созданием записи WAL на лидере и её воспроизведением на реплике, установленная через параметр recovery_min_apply_delay;
-
Timeline — timeline PostgreSQL;
-
Host — IP-адрес хоста;
-
Tags — теги patroni.
Панель инструментов, позволяющая закрыть окно со сведениями о состоянии ноды и масштабировать схему топологии, также отображается на странице Topology. На панели можно увидеть масштаб схемы в процентах.
Панель включает следующие кнопки:
-
— увеличить масштаб; -
— уменьшить масштаб; -
— развернуть схему на весь экран; -
— уменьшить размер схемы до 100%; -
— скрыть окно со сведениями о состоянии ноды.
Выполнение действий
На странице Topology вы можете выполнить следующие действия:
Чтобы выполнить действия, нажмите Actions в верхней части страницы.
Вы также можете запускать действия, связанные с определенной нодой, из меню ноды.
В этом случае ноду, для которой выполняется действие, нельзя изменить из окна действия — поле Candidate для Switchover и Failover, а также поле Instance для Reinit заполняются автоматически.
После запуска действия вверху страницы отображается индикатор его выполнения.
Все действия ADP Control регистрируются на странице Actions. На этой странице можно получить информацию об успешных действиях и ошибках, возникающих в случае сбоя.
|
ВАЖНО
Обратите внимание, что действия Failover и Switchover могут привести к потере данных. Это зависит от того, насколько актуальны данные реплики-кандидата по сравнению с лидером. Оба действия также прерывают текущие транзакции и сессии на лидере. |
Switchover
Действие Switchover передает роль лидера указанной ноде-реплике. Бывший лидер становится репликой. Если кластер содержит синхронные реплики, необходимо выбрать одну из синхронных реплик в качестве кандидата на переключение. Действие Switchover недоступно для асинхронных реплик, если в кластере включен режим синхронной репликации.
Это действие можно использовать, когда кластер исправен:
-
В кластере есть лидер.
-
В кластере с синхронной репликацией доступны синхронные реплики.
Если кластер неисправен, используйте Failover вместо действия Switchover.
Чтобы выполнить действие, нажмите Switchover в списке действий, укажите ноду-кандидат, которую необходимо сделать лидером (если она не определена), и нажмите Run.
Failover
Действие Failover может перенести роль лидера на асинхронную или синхронную реплику. Бывший лидер становится репликой.
Это действие можно использовать, когда кластер неисправен, например, в кластере нет лидера или в кластере с синхронной репликацией нет доступной синхронной реплики.
Вы можете запустить Failover и в работоспособном кластере, однако в этом случае рекомендуется использовать действие Switchover.
Чтобы выполнить действие, нажмите Failover в списке действий, укажите ноду-кандидат, которая должна быть назначена лидером (если она не определена), и нажмите Run. Также при указании ноды можно выбрать вариант Autoselect в выпадающем списке — нода-кандидат будет определена автоматически.
|
ПРИМЕЧАНИЕ
Если в кластере происходит автоматическое действие failover, оно не регистрируется на странице Actions. На этой странице регистрируются действия, запущенные только вручную.
|
Reinit
Действие Reinit повторно инициализирует ноду кластера. Все данные на этой ноде будут перезаписаны.
Reinit рекомендуется в случаях, когда база данных ADP на реплике не может "догнать" базу данных на лидере и patroni не способен автоматически восстановить ее. Reinit включает в себя удаление существующего каталога данных и создание новой реплики на основе текущего лидера.
Чтобы выполнить действие, нажмите Reinit в списке действий, укажите ноду, которая должна быть повторно инициализирована (если она не определена), и нажмите Run.
Pause cluster
Действие Pause cluster переключает patroni в режим паузы. В режиме паузы patroni не управляет кластером, но сохраняет состояние кластера в DCS. Режим паузы может быть полезен во время мажорного обновления версии или восстановления после сбоя. Такие операции часто запускают и останавливают ноды по причинам, неизвестным patroni. Некоторые ноды могут быть даже временно переведены в режим лидера, нарушая предположение о запуске только одного лидера. По этим причинам patroni должен иметь возможность перестать контролировать работающий кластер.
Чтобы выполнить действие, нажмите Pause cluster в списке действий и кликните Run в открывшемся окне.
После выполнения действия в верхней части страницы, в поле Status, отображается индикатор режима паузы.
Для выключения режима паузы используйте действие Resume cluster.
Resume cluster
Действие Resume cluster выключает режим паузы, возвращает контроль patroni и приводит кластер в рабочее состояние. Действие также разрешает ситуацию с несколькими лидерами, если она возникла.
Чтобы выполнить действие, нажмите Resume cluster в списке действий и кликните Run в открывшемся окне.
