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 Отображает информацию из каталоговых таблиц.
-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

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

Смотрите также: mxstart, mxstop