mxstate

Отображает состояние запущенной системы баз данных YMatrix.

1 Описание

Утилита mxstate извлекает информацию о состоянии кластера базы данных.
Она предоставляет подробные сведения об операционном состоянии экземпляра базы данных YMatrix. Поскольку система базы данных YMatrix состоит из нескольких экземпляров PostgreSQL (сегментов), распределённых по нескольким машинам, дополнительная информация о состоянии необходима для мониторинга и администрирования. Инструмент mxstate обеспечивает такую расширенную видимость, включая:

Какие хосты сегментов недоступны?
Конфигурационные данные мастера и сегментов (хост, каталог данных и т.д.)
Порты, используемые системой
Сопоставление основных сегментов с соответствующими зеркальными сегментами

2 Параметры

Параметр	Описание
-c или --db-cluster-id	Указывает целевой идентификатор кластера базы данных. Используется значение по умолчанию, если параметр не указан.
-s или --detailed-status	Отображает подробное состояние, включая состояния отдельных сегментов.
-o или --from-etcd-only	Показывает состояние компонентов, считанное только из etcd.
-m или --list-mirrors	Выводит информацию о зеркальных сегментах.
-Q или --quick-status	Отображает информацию из каталоговых таблиц.
-e	Показывает сегменты в нестандартных состояниях.
-f или --show-standby-master-details	Отображает информацию о резервном мастере.
-i или --show-version	Отображает версионную информацию.
-q или --quiet	Работает в тихом режиме. Вывод подавляется на экране, но продолжает записываться в файлы журналов.
-t или --timeout	Устанавливает порог времени ожидания (в секундах) при чтении состояния. По умолчанию — 60 секунд, если не указано иное.
-h или --help	Отображает справочную информацию.

3 Определения полей вывода

Следующие поля отображаются утилитой mxstate -s для хоста:

Данные вывода	Описание
Master host	Имя хоста мастер-узла
Master postgres process ID	Идентификатор процесса слушателя мастера
Master data directory	Расположение каталога данных мастера в файловой системе
Master port	Номер порта слушателя postgres на мастере
Master current role	dispatch = нормальный режим работы, utility = режим обслуживания
Greenplum initsystem version	Версия Greenplum Database на момент инициализации системы
Greenplum current version	Текущая версия Greenplum Database
Postgres version	Версия PostgreSQL, лежащая в основе Greenplum Database
Greenplum mirroring status	Физическое зеркалирование включено или отключено
Master standby	Имя хоста резервного мастера
Standby master state	Состояние резервного мастера: active или passive

Следующие поля отображаются утилитой mxstate -s для каждого сегмента:

Данные вывода	Описание
Hostname	Настроенное имя хоста системы
Address	Сетевое имя адреса (имя сетевого интерфейса)
Datadir	Расположение каталога данных сегмента в файловой системе
Port	Номер порта процесса слушателя postgres сегмента
Current Role	Текущая роль сегмента: Mirror или Primary
Preferred Role	Роль, назначенная при инициализации системы: Mirror или Primary
Mirror Status	Состояние пары основной/зеркальный сегмент: Synchronized = данные актуальны на обоих узлах, Resynchronization = данные копируются между узлами, Change Tracking = сегмент остановлен, изменения отслеживаются на активном узле
PID	Идентификатор процесса сегмента
Configuration reports status as	Состояние, зафиксированное в системных каталогах: Up/Down
Database status	Фактическое состояние базы данных в режиме выполнения: Up/Down

Следующие поля отображаются утилитой mxstate -f для состояния репликации резервного мастера:

Данные вывода	Описание
Standby address	Имя хоста резервного мастера
Standby data dir	Расположение каталога данных резервного мастера в файловой системе
Standby port	Номер порта слушателя postgres резервного мастера
Standby PID	Идентификатор процесса резервного мастера
Standby status	Состояние резервного мастера: Standby host passive
WAL Sender State	Состояние потоковой передачи журнала предзаписи (WAL): streaming, startup, backup, catchup
Sync state	Состояние синхронизации отправителя WAL: sync
Sent Location	Позиция отправки записи журнала транзакций (xlog) отправителем WAL
Flush Location	Позиция сброса записи xlog получателем WAL
Replay Location	Позиция воспроизведения записи xlog на резервном мастере

4 Примеры

Отобразить состояние кластера базы данных по умолчанию:

mxstate

Отобразить подробное состояние кластера базы данных по умолчанию:

mxstate -s

#or

mxstate --detailed-status

Отобразить версионную информацию кластера базы данных по умолчанию:

mxstate -i

#or

mxstate --show-version

Отобразить информацию о зеркальных сегментах:

mxstate -m

#or

mxstate --list-mirrors

Отобразить детали конфигурации резервного мастера:

mxstate -f

#or

mxstate --show-standby-master-details

Отобразить сегменты в нестандартных состояниях:

mxstate -e

Включает следующие состояния:

Состояние	Информация об узле
двойной сбой	DEAD_WITH_MIRROR
выполняется отказоустойчивый переход	DEAD_MIRROR_DOWN, DEAD_PRIMARY_DOWN
отказоустойчивый переход завершён, требуется восстановление	OK_MIRROR_DOWN
репликация	NO_RESP
восстановление завершено, требуется балансировка	OK_MIRROR_IN_SYNC / OK_MIRROR_NOT_IN_SYNC
зеркало не синхронизировано	OK_MIRROR_NOT_IN_SYNC

Примечание!
YMatrix 6 представляет новую архитектуру базы данных. Для просмотра состояния кластера используйте mxstate. Он несовместим с gpstate. В более ранних версиях может использоваться утилита gpstate.

См. также: mxstart, mxstop

← Предыдущая

mxstart

mxstop