Управление эксплуатацией

Документ представляет инструменты для регулярных операций и обслуживания YMatrix, разделённые на две части:

Использование командных инструментов для запуска и остановки кластера, проверки его состояния, изменения конфигураций и т.д.
Использование графического интерфейса для просмотра информации о кластере.

Примечание!
Все командные инструменты управляются через главный узел (Master), поэтому они должны выполняться именно на Master-узле.

YMatrix 6 использует те же инструменты управления кластером, что и YMatrix 5. Мы предоставляем следующие средства обслуживания: mxstart, mxstop, mxstate.

Примечание!
YMatrix 4 (MatrixDB 4) по умолчанию по-прежнему использует инструменты обслуживания серии Greenplum. Подробности см. в разделе Базовое управление кластером YMatrix 4.

1 Командные инструменты

1.1 Запуск кластера

Используйте команду mxstart -a для запуска кластера YMatrix.

[mxadmin@mdw ~]$ mxstart -a

1.2 Остановка кластера

Команда mxstop -a останавливает работающий кластер YMatrix.

Режим mxstop	Параметр	Отказ от новых подключений	Ожидание завершения активных процессов	Режим по умолчанию?
smart	-M smart	Да	Да	Да
fast	-M fast	Да	Нет, разрывает подключения, откатывает транзакции	Нет
immediate	-M immediate	Да	Нет, немедленно завершает процессы	Нет

[mxadmin@mdw ~]$ mxstop -a -M fast

Выберите один режим для остановки кластера. Для большинства сценариев использования YMatrix рекомендуется режим fast. Если режим не указан (mxstop -a), система по умолчанию использует режим smart, позволяя текущим операциям завершиться естественным образом — хотя это может занять больше времени. Команда блокирует новые подключения, но не влияет на текущее использование кластера.

1.2.1 Перезапуск кластера

Используйте mxstop -ar для перезапуска кластера.

1.2.2 Перезагрузка конфигурации авторизации

После изменения конфигурации авторизации в файле pg_hba.conf используйте mxstop -u для её перезагрузки.

1.3 Проверка состояния кластера

Используйте mxstate для проверки операционного состояния кластера, включая:

Конфигурацию Master-узла.
Конфигурацию сегментов.
Информацию о зеркальных узлах и т.д.

[mxadmin@mdw ~]$ mxstate

1.4 Изменение конфигурации кластера

Используйте gpconfig для просмотра или изменения параметров в файле конфигурации postgresql.conf.

1.4.1 Просмотр конфигурации

Используйте gpconfig -s с указанием имени параметра для просмотра его значения:

[mxadmin@mdw ~]$ gpconfig -s shared_buffers
Values on all segments are consistent
GUC          : shared_buffers
Master  value: 1078464kB
Segment value: 1078464kB

1.4.2 Изменение конфигурации

Используйте gpconfig -c {configuration_name} -v {value} для изменения параметра:

[mxadmin@mdw ~]$ gpconfig -c shared_buffers -v 128MB
20210723:17:13:35:004318 gpconfig:sdw2:mxadmin-[INFO]:-completed successfully with parameters '-c shared_buffers -v 128MB'

Перезапустите кластер, чтобы изменения вступили в силу:

[mxadmin@mdw ~]$ mxstop -ar

После перезапуска проверьте обновлённую конфигурацию:

[mxadmin@mdw ~]$ gpconfig -s shared_buffers
Values on all segments are consistent
GUC          : shared_buffers
Master  value: 128MB
Segment value: 128MB

Примечание!
Подробное использование gpconfig см. в документации gpconfig

2 Графический интерфейс

Обычно для получения метаданных кластера вы можете запрашивать системные каталоги, такие как pg_database, pg_class.
Для удобства и наглядности просмотра этой информации (например, баз данных, таблиц, их размеров, типов, времени доступа и т.д.) YMatrix предоставляет графический веб-интерфейс. Простыми кликами вы можете быстро получить нужные данные.

2.1 Предварительные требования

Сначала войдите в графический интерфейс. В браузере введите IP-адрес (по умолчанию — IP Master-узла) и порт, на котором запущен сервис MXUI:

http://<IP>:8240

2.2 Управление кластером

2.2.1 Просмотр метрик

После входа вы попадаете на страницу «Управление кластером», которая по умолчанию отображает «Просмотр метрик». Она состоит из двух разделов:

Информация о кластере: включает статус кластера, количество узлов данных и версию базы данных.
Информация о метриках: показывает использование ресурсов, таких как активные подключения к базе данных, и ключевые метрики каждого узла. YMatrix автоматически собирает и отображает эти метрики каждые 5 секунд, включая использование CPU, памяти, дискового ввода-вывода, сетевого ввода-вывода и количество подключений.

2.2.2 Просмотр экземпляров

Переключитесь на «Просмотр экземпляров». Информация об узлах изменяется с метрик на статус и распределение экземпляров.

Наведите курсор на любой экземпляр, чтобы просмотреть его подробную информацию.

2.2.3 Табличный просмотр

Переключитесь на «Табличный просмотр» для отображения информации об узлах в табличном формате, включая статус экземпляра, DBID, порт, путь хранения и т.д.

2.3 Информация о таблицах

2.3.1 Основная информация о таблицах

Нажмите на опцию «Таблицы» слева, чтобы перейти на страницу таблиц. Отображаются все базы данных:

Вы также можете выбрать конкретную базу данных из списка:

Отобразится список всех таблиц в выбранной базе данных с показателями: имя таблицы, имя базы данных, схема, количество партиций, размер, владелец, оценённое количество строк, время последнего доступа, время последнего изменения и время последнего обновления статистики.