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 Идентификатор процесса (PID) процесса-прослушивателя мастера
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