gpstate

Contents

Синтаксис
Описание
Параметры
Поля вывода
Примеры
См. также

Отображает состояние работающего кластера Greengage DB.

gpstate [ -d <master_data_directory> ]
        [ -B <parallel_processes> ]
        [ -s | -b | -Q | -e ]
        [ -m | -c ]
        [ -p ]
        [ -i ]
        [ -f ]
        [ -v | -q ]
        [ -x ]
        [ -l <log_directory> ]

gpstate -? | -h | --help

Описание

Утилита gpstate отображает информацию о работающем кластере Greengage DB. Поскольку кластер Greengage DB состоит из нескольких экземпляров PostgreSQL (сегментов), распределенных по разным хостам, утилита gpstate предоставляет дополнительную информацию о состоянии системы:

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

-b

(Опционально) Выводит краткую сводку о состоянии кластера Greengage DB. Параметр по умолчанию.

-B <parallel_processes>

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

-c

(Опционально) Выводит сопоставление основных и зеркальных сегментов.

-d <master_data_directory>

(Опционально) Каталог данных мастера. Если параметр не указан, будет использовано значение MASTER_DATA_DIRECTORY.

-e

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

Остановленные сегменты.
Пары основных и зеркальных сегментов не в своих предпочтительных ролях.
Несинхронизированные пары основных и зеркальных сегментов — включая количество несинхронизированных данных в байтах (в поле вывода WAL sync remaining bytes).

ПРИМЕЧАНИЕ

gpstate -e не отображает синхронизированные пары сегментов.

ПРИМЕЧАНИЕ

Для просмотра информации отслеживания сегментов, проходящих дифференциальное восстановление, требуется rsync версии 3.1.x или выше.

-f

Выводит информацию о резервном мастере, если он настроен.

-i

Выводит версию программного обеспечения Greengage DB для каждого экземпляра.

-m

(Опционально) Выводит список зеркальных сегментов и их текущие роли.

-p

Выводит используемые номера портов.

-q

(Опционально) Тихий режим. За исключением предупреждений, вывод команды не отображается на экране, но записывается в лог-файл.

-Q

(Опционально) Проверяет состояние сегментов в системном каталоге на мастер-хосте без опроса сегментов.

-s

(Опционально) Выводит детальную информацию о состоянии кластера Greengage DB.

-v

(Опционально) Выводит сообщения об ошибках и детальную информацию о состоянии и ходе выполнения.

-x

(Опционально) Выводит детальную информацию о ходе и состоянии расширения кластера Greengage DB.

-l <log_directory>

(Опционально) Каталог для записи лог-файла. По умолчанию используется ~/gpAdminLogs.

-? | -h | --help

Отображает справку.

Следующие поля вывода отображаются командой gpstate -s для мастера.

Данные вывода Описание

Данные вывода	Описание
Master host	Имя мастер-хоста
Master postgres process ID	PID процесса-обработчика базы данных мастера
Master data directory	Расположение каталога данных мастера
Master port	Порт процесса-обработчика `postgres` мастера
Master current role	`dispatch` — обычный режим работы; `utility` — режим обслуживания.
Greengage DB array configuration type	`Standard` — один сетевой интерфейс на хост; `Multi-Home` — несколько сетевых интерфейсов на хост.
Greengage initsystem version	Версия Greengage DB при первой инициализации системы
Greengage current version	Текущая версия Greengage DB
Postgres version	Версия PostgreSQL, на которой основан Greengage DB
Master standby	Имя хоста резервного мастера
Standby master state	Состояние резервного мастера: `active` или `passive`

Master host

Имя мастер-хоста

Master postgres process ID

PID процесса-обработчика базы данных мастера

Master data directory

Расположение каталога данных мастера

Master port

Порт процесса-обработчика postgres мастера

Master current role

dispatch — обычный режим работы;
utility — режим обслуживания.

Greengage DB array configuration type

Standard — один сетевой интерфейс на хост;
Multi-Home — несколько сетевых интерфейсов на хост.

Greengage initsystem version

Версия Greengage DB при первой инициализации системы

Greengage current version

Текущая версия Greengage DB

Postgres version

Версия PostgreSQL, на которой основан Greengage DB

Master standby

Имя хоста резервного мастера

Standby master state

Состояние резервного мастера: active или passive

Следующие поля вывода отображаются при вызове команды gpstate -s для каждого основного сегмента.

Данные вывода Описание

Данные вывода	Описание
Hostname	Системное имя хоста
Address	Имя хоста сетевого адреса (имя сетевого интерфейса)
Datadir	Расположение каталога данных сегмента
Port	Порт процесса-обработчика `postgres` сегмента
Current role	Текущая роль сегмента: `Mirror` или `Primary`
Preferred role	Роль во время инициализации системы: `Mirror` или `Primary`
Mirror status	Состояние пары основного/зеркального сегмента: `Synchronized` — данные актуальны на обоих сегментах; `Not in Sync` — зеркальный сегмент еще не синхронизирован с основным.
Current write location	Позиция, в которую основной сегмент записывает новые логи по мере поступления
Bytes remaining to send to mirror	Число байт, оставшихся для отправки от основного к зеркальному сегменту
PID	Идентификатор активного процесса сегмента
Configuration reports status as	Состояние сегмента, как оно указано в системном каталоге: `Up` или `Down`
Database status	Состояние Greengage DB для входящих запросов: `Up`, `Down` или `Suspended`. Состояние `Suspended` означает, что активность базы данных временно приостановлена, пока сегмент переходит из одного состояния в другое

Hostname

Системное имя хоста

Address

Имя хоста сетевого адреса (имя сетевого интерфейса)

Datadir

Расположение каталога данных сегмента

Port

Порт процесса-обработчика postgres сегмента

Current role

Текущая роль сегмента: Mirror или Primary

Preferred role

Роль во время инициализации системы: Mirror или Primary

Mirror status

Состояние пары основного/зеркального сегмента:

Synchronized — данные актуальны на обоих сегментах;
Not in Sync — зеркальный сегмент еще не синхронизирован с основным.

Current write location

Позиция, в которую основной сегмент записывает новые логи по мере поступления

Bytes remaining to send to mirror

Число байт, оставшихся для отправки от основного к зеркальному сегменту

PID

Идентификатор активного процесса сегмента

Configuration reports status as

Состояние сегмента, как оно указано в системном каталоге: Up или Down

Database status

Состояние Greengage DB для входящих запросов: Up, Down или Suspended. Состояние Suspended означает, что активность базы данных временно приостановлена, пока сегмент переходит из одного состояния в другое

Следующие поля вывода отображаются при вызове команды gpstate -s для каждого зеркального сегмента.

Данные вывода Описание

Данные вывода	Описание
Hostname	Системное имя хоста
Address	Имя хоста сетевого адреса (имя сетевого интерфейса)
Datadir	Расположение каталога данных сегмента
Port	Порт процесса-обработчика `postgres` сегмента
Current role	Текущая роль сегмента: `Mirror` или `Primary`
Preferred role	Роль во время инициализации системы: `Mirror` или `Primary`
Mirror status	Состояние пары основного/зеркального сегмента: `Synchronized` — данные актуальны на обоих сегментах; `Not in Sync` — зеркальный сегмент еще не синхронизирован с основным.
WAL Sent Location	Позиция лога, до которой основной сегмент отправил данные логов зеркальному сегменту
WAL Flush Location	Позиция лога, до которой зеркальный сегмент сбросил данные логов на диск
WAL Replay Location	Позиция лога, до которой зеркальный сегмент воспроизвел логи локально
Bytes received but remain to flush	Разница между позицией сброшенного лога и позицией отправленного лога
Bytes received but remain to replay	Разница между позицией воспроизведенного лога и позицией отправленного лога
PID	Идентификатор активного процесса сегмента
Configuration reports status as	Состояние сегмента, как оно указано в системном каталоге: `Up` или `Down`
Database status	Состояние Greengage DB для входящих запросов: `Up`, `Down` или `Suspended`. Состояние `Suspended` означает, что активность базы данных временно приостановлена, пока сегмент переходит из одного состояния в другое

Hostname

Системное имя хоста

Address

Имя хоста сетевого адреса (имя сетевого интерфейса)

Datadir

Расположение каталога данных сегмента

Port

Порт процесса-обработчика postgres сегмента

Current role

Текущая роль сегмента: Mirror или Primary

Preferred role

Роль во время инициализации системы: Mirror или Primary

Mirror status

Состояние пары основного/зеркального сегмента:

Synchronized — данные актуальны на обоих сегментах;
Not in Sync — зеркальный сегмент еще не синхронизирован с основным.

WAL Sent Location

Позиция лога, до которой основной сегмент отправил данные логов зеркальному сегменту

WAL Flush Location

Позиция лога, до которой зеркальный сегмент сбросил данные логов на диск

WAL Replay Location

Позиция лога, до которой зеркальный сегмент воспроизвел логи локально

Bytes received but remain to flush

Разница между позицией сброшенного лога и позицией отправленного лога

Bytes received but remain to replay

Разница между позицией воспроизведенного лога и позицией отправленного лога

PID

Идентификатор активного процесса сегмента

Configuration reports status as

Состояние сегмента, как оно указано в системном каталоге: Up или Down

Database status

ПРИМЕЧАНИЕ

Когда нет подключения между основным сегментом и его зеркалом, gpstate -s отображает Unknown в следующих полях:

Bytes remaining to send to mirror
WAL Sent Location
WAL Flush Location
WAL Replay Location
Bytes received but remain to flush
Bytes received but remain to replay

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

Данные вывода Описание

Данные вывода	Описание
Standby address	Имя хоста резервного мастера
Standby data directory	Расположение каталога данных резервного мастера
Standby port	Порт процесса-обработчика `postgres` резервного мастера
Standby PID	ID процесса резервного мастера
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 резервного мастера

Standby address

Имя хоста резервного мастера

Standby data directory

Расположение каталога данных резервного мастера

Standby port

Порт процесса-обработчика postgres резервного мастера

Standby PID

ID процесса резервного мастера

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 резервного мастера

Показать детальную информацию о состоянии системы Greengage DB:

$ gpstate -s

Выполнить быструю проверку остановленных сегментов в системном каталоге мастер-хоста:

$ gpstate -Q

Показать информацию о зеркальных экземплярах сегментов:

$ gpstate -m

Показать информацию о конфигурации резервного мастера:

$ gpstate -f

Вывести информацию о версии программного обеспечения Greengage DB:

$ gpstate -i

gpstart

gpstop

gpstate

Синтаксис

Описание

Параметры

Поля вывода

Примеры

См. также