Использование PPEM

Вход в веб-приложение

В веб-приложение можно войти после установки PPEM.

Чтобы войти в веб-приложение, выполните следующие действия:

В адресной строке браузера введите IP-адрес сервера, на котором установлен менеджер. Дополнительно может потребоваться указать номер порта, на котором сервер прослушивает входящие подключения. Если в сети настроена служба DNS, можно ввести сетевое имя сервера.
IP-адрес и номер порта сервера можно указать в конфигурационном файле менеджера /etc/ppem-manager.yml с помощью параметров http.server.address и http.server.port.
На странице авторизации введите логин и пароль, после чего нажмите АВТОРИЗАЦИЯ. При первом входе в веб-приложение используйте пользователя по умолчанию с логином admin и паролем admin.

Откроется страница Главная в разделе УПРАВЛЕНИЕ левой панели.

Рекомендуется выполнить следующие действия после первого входа в веб-приложение:

Отредактируйте пользователя по умолчанию с логином admin и измените его пароль.
Создайте для себя отдельного пользователя.

Дашборд

Страница описывает Дашборд - главный обзорный экран интерфейса PPEM.

Панель навигации

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

Разделы панели навигации разделены на две секции:

Управление - основные функции PPEM для управления экземплярами СУБД.
Система - функции настройки системы PPEM.

Основные разделы секции "Управление":

Дашборд - главный обзорный экран системы PPEM, содержит общую и сводную информацию о ресурсах, добавленных в PPEM и доступных для взаимодействия через PPEM.
Кластеры - наблюдение и управление за системами, объединенными в кластеры (как правило потоковой репликации) экземпляров СУБД.
Экземпляры - наблюдение и управление за отдельными экземплярами СУБД.
Журнал сообщений - работа с журналами сообщений экземпляров СУБД.
Консоль заданий - управление командами которые можно выполнять на экземплярах СУБД с помощью PPEM.
Резервное копирование - просмотр и настройка резервных копий и другие задачи, связанные с резервным копированием.
Визуализация - визуализация текстовых планов запросов EXPLAIN в диаграммы.

Основные разделы секции "Система":

Управление пользователями - управление внутренними пользователями и группами пользователей PPEM.
Настройки - настройки PPEM.

Дашборд

Дашборд является обзорным экраном, имеет информативный характер и содержит сводную информацию об инфраструктуре, наблюдаемой и управляемой из PPEM. Дашборд состоит из следующих элементов:

Экземпляры - общее количество экземпляров СУБД, добавленных в PPEM.
Кластеры - общее количество кластеров репликации, обнаруженных и добавленных в PPEM.
Базы данных - общее количество баз данных, обнаруженных во всех экземплярах СУБД (включая системные базы данных и шаблоны).
Общий размер БД - общий размер всех баз данных (в байтах), обнаруженных во всех экземплярах СУБД (включая системные базы данных и шаблоны).
Последние уведомления - список последних непрочитанных уведомлений текущего пользователя.
Последние сообщения - список последних сообщений из журналов событий экземпляров СУБД.

Панель инструментов

Панель инструментов размещается наверху экрана и состоит из следующих компонентов:

Логотип PPEM - является ссылкой на Дашборд.
Кнопка отображения Панели навигации - позволяет сворачивать и разворачивать Панель навигации в краткий вариант и полный варианты.
Глобальный поиск - позволяет искать в PPEM различные объекты по именам и ключевым словам.
Кнопка переключения интерфейса между дневной и ночной схемой.
Кнопка выбора языка интерфейса.
Кнопка панели уведомлений - показывает список уведомлений о выполненных фоновых операциях. Каждое уведомление в списке может быть прочитано и содержит следующую информацию:
- Заголовок уведомления, в зависимости от типа уведомления и успешности операции, может быть окрашен в разные цвета:
  - info - синий
  - ok - зелёный
  - error - красный
  - warning - жёлтый
  - text - чёрный
- Текст сообщения.
- Дата и время получения.
- Также доступна кнопка для отметки всех уведомлений как прочитанных.
Кнопка профиля пользователя.
Кнопка завершения сеанса.

Настройка системы

В этом разделе содержится информация об управлении агентами и тегами.

Управление агентами

Страница "Управление агентами" предназначена для просмотра и управления существующими агентами PPEM.

На странице представлены:

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

Просмотр списка агентов

Таблица-список агентов содержит список агентов, добавленных в систему. В таблице доступна следующая информация.

Агент - уникальное имя агента. Слева от имени отображается статус-индикатор агента, который отображает состояние агента. Для поля доступен фильтр и сортировка.
URL - адрес подключения к API агента. Адрес используется для внутренней коммуникации между менеджером и агентом. Для поля доступен фильтр.
Ключ аутентификации - ключ, используемый агентом для аутентификации и установки сеансов с менеджером.
Версия - версия агента. В поле могут выводиться предупреждения в случае, если версия агента отличается от версии менеджера.
Список действий включает в себя:
- Редактирование информации об агенте.
- Удаление агента из списка.

При внесении каких-либо изменений в систему, например при установке и запуске новых агентов, может потребоваться обновить список - для этого нужно нажать кнопку "Обновить данные" в верхнем правом углу.

Добавление агента

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

Название - уникальное имя агента.
Хост - адрес сервера, на котором запущен агент. Сервер также должен быть добавлен в систему.
Порт - порт, на котором агент прослушивает входящие подключения.
Протокол - протокол, который используется агентом для коммуникации. Доступен выбор из http и https.

На основе адреса сервера, порта и протокола формируется URL, который будет использоваться менеджером при обращении к агенту.

После заполнения полей следует нажать кнопку "Сохранить", агент добавится в список.

Редактирование информации об агенте

Для редактирования информации об агенте нужно нажать кнопку "Редактировать" в поле "Действия". В открывшейся форме можно изменить информацию об агенте. Для изменения доступны поля аналогичные те, что нужно заполнить при добавлении агента. Важно отметить, что агент, работающий в режиме авто-обновления сведений (режим по умолчанию), автоматически обновляет информацию о себе, и все изменения, сделанные администратором, будут перезаписаны агентом.

Удаление агента

Для удаления агента из списка необходимо нажать кнопку "Удалить" в поле "Действия". Для полного удаления агента из системы служба агента должна быть остановлена, а пакет удален с сервера. В противном случае, после удаления агента из списка активный агент вновь автоматически зарегистрируется в системе.

Управление тегами

Страница "Теги" предназначена для просмотра и создания тегов.

Теги являются особыми метками, которые можно назначать на объекты и ресурсы PPEM. Используя теги, можно осуществлять быстрый поиск ресурсов в соответствующих таблицах и Глобальном поиске.

На данный момент поддержка тегов реализована только для Экземпляров.

Просмотр тегов

Для просмотра тегов на странице приведена таблица со следующей информацией:

Отображаемое имя - уникальное имя тега, отличающее его от других тегов. Для поля доступна сортировка.
Описание - дополнительный текст, описывающий смысловое содержимое тега. Для поля доступна сортировка.
Действия - список действий, доступных над тегами:
- Редактирование, позволяет изменить атрибуты тега.
- Удаление, позволяет удалить тег.

Создание тегов

Для создания тега нужно нажать кнопку "Добавить тег" в верхнем правом углу.

В открывшейся форме заполнить поля:

Отображаемое имя, обязательное поле.
Описание, обязательное поле.

После ввода значений следует нажать кнопку "Сохранить", добавленный тег отобразится в списке.

Редактирование тегов

Для редактирования тега нужно нажать кнопку "Редактировать" в поле "Действия". В открывшейся форме можно изменить атрибуты тега. Для сохранения нужно нажать кнопку "Сохранить".

Удаление тегов

Для удаления тега, нужно нажать кнопку "Удалить" в полей "Действия". В открывшейся форме следует подтвердить удаление и нажать кнопку "Удалить".

При удалении тега все ассоциации тега с ресурсами и объектам удаляются автоматически.

Пользователи PPEM

Пользователи управляют PPEM с помощью веб-приложения. При необходимости пользователей можно объединять в группы для централизованного управления. Уровень доступа пользователей к различным операциям определяется ролями. Каждая роль имеет предопределённый набор привилегий. Роли можно назначать как отдельным пользователям, так и группам.

За подробной информацией о ролях и привилегиях обратитесь к разделу Ролевая модель доступа (RBAC).

В этом разделе описано, как управлять пользователями и группами, а также приведена информация о существующих ролях и привилегиях.

Управление пользователями

В этом разделе описано, как управлять пользователями, и приведены следующие инструкции:

Просмотр пользователей

Чтобы просмотреть пользователей, в разделе СИСТЕМА левой панели перейдите на страницу Пользователи.

Отобразится таблица Управление пользователями со следующими столбцами:

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

Чтобы обновить таблицу пользователей, в правом верхнем углу страницы нажмите Обновить данные .

Фильтрация и сортировка пользователей

Пользователей можно фильтровать и сортировать по следующим критериям:

Имя и фамилия:
- Чтобы отобразить пользователей с конкретными именами и фамилиями, выполните следующие действия:
  1. Нажмите на значок фильтра рядом с именем столбца Имя пользователя.
  2. В меню установите флажки рядом с именами и фамилиями пользователей. Имя и фамилию пользователя можно найти, введя их в поле поиска в верхней части меню.
    При необходимости снять установленные флажки в правом верхнем углу меню нажмите Сбросить.
  3. Нажмите ПРИМЕНИТЬ.
- Чтобы отобразить пользователей по алфавиту в восходящем или нисходящем порядке на основании имени и фамилии, нажмите на стрелку вверх или стрелку вниз рядом с именем столбца Имя пользователя.
Логин:
- Чтобы отобразить пользователей с конкретными логинами, выполните следующие действия:
  1. Нажмите на значок фильтра рядом с именем столбца Логин.
  2. В меню установите флажки рядом с логинами. Логин можно найти, введя его в поле поиска в верхней части меню.
    При необходимости снять установленные флажки в правом верхнем углу меню нажмите Сбросить.
  3. Нажмите ПРИМЕНИТЬ.
- Чтобы отобразить пользователей по алфавиту в восходящем или нисходящем порядке на основании логина, нажмите на стрелку вверх или стрелку вниз рядом с именем столбца Логин.
Адрес эл. почты:
- Чтобы отобразить пользователей с конкретными адресами эл. почты, выполните следующие действия:
  1. Нажмите на значок фильтра рядом с именем столбца Почта.
  2. В меню установите флажки рядом с адресами эл. почты. Адрес эл. почты можно найти, введя его в поле поиска в верхней части меню.
    При необходимости снять установленные флажки в правом верхнем углу меню нажмите Сбросить.
  3. Нажмите ПРИМЕНИТЬ.
- Чтобы отобразить пользователей по алфавиту в восходящем или нисходящем порядке на основании эл. почты, нажмите на стрелку вверх или стрелку вниз рядом с именем столбца Почта.
Роль. Чтобы отобразить пользователей, которым назначены конкретные роли, выполните следующие действия:
1. Нажмите на значок фильтра рядом с именем столбца Личные роли.
2. В меню установите флажки рядом с ролями. Роль можно найти, введя её имя в поле поиска в верхней части меню.
  При необходимости снять установленные флажки в правом верхнем углу меню нажмите Сбросить.
3. Нажмите ПРИМЕНИТЬ.

Чтобы сбросить все фильтры, в правом верхнем углу страницы нажмите Сбросить фильтры.

Создание пользователя

Чтобы создать пользователя, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи.
Отобразится таблица Управление пользователями.
В правом верхнем углу страницы нажмите ДОБАВИТЬ ПОЛЬЗОВАТЕЛЯ.
Откроется окно Добавить пользователя.
Укажите подробную информацию о новом пользователе (помеченные звёздочкой параметры являются обязательными):
- Имя: имя пользователя.
- Фамилия: фамилия пользователя.
- Эл. почта: адрес эл. почты пользователя.
- Логин: логин пользователя для входа в веб-приложение.
- Пароль: пароль пользователя для входа в веб-приложение. Минимальная длина пароля — 8 символов.
- Должность: должность пользователя в вашей организации.
- Телефон: номер телефона пользователя.
- Группа: группы, в которые будет добавлен пользователь. Выбор группы можно отменить, нажав на крестик рядом с её именем.
  Вы также можете добавить пользователя в группу при создании и редактировании этой группы.
- Права доступа: роли, которые будут назначены пользователю. Чтобы назначить роль пользователю, нажмите ДОБАВИТЬ РОЛЬ + и выберите роль из выпадающего списка. Роль можно отозвать, нажав на значок корзины рядом с ней.
  При выборе определённых ролей выберите из выпадающего списка объекты, к которым эти роли будут предоставлять доступ. Объект можно отозвать, нажав на крестик рядом с его именем.
- Статус: статус доступа пользователя к веб-приложению после создания. Возможные значения:
  - Доступ разрешен: пользователь может входить в веб-приложение.
  - Доступ заблокирован: пользователю запрещён вход в веб-приложение. Чтобы у пользователя появился доступ к веб-приложению, отредактируйте пользователя и выберите Доступ разрешен из выпадающего списка Статус.
Нажмите СОХРАНИТЬ.

Пользователь будет создан и появится в таблице пользователей.

Редактирование пользователя

Чтобы отредактировать пользователя, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи.
Отобразится таблица Управление пользователями.
Нажмите Редактировать рядом с пользователем, которого необходимо отредактировать.
Откроется окно Редактировать пользователя.
Измените параметры пользователя.
Нажмите СОХРАНИТЬ.

Удаление пользователя

Пользователи, которые были удалены, восстановлению не подлежат.

Чтобы удалить пользователя, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи.
Отобразится таблица Управление пользователями.
Нажмите Удалить рядом с пользователем, которого необходимо удалить.
Откроется окно Удаление пользователя.
Нажмите ДА, УДАЛИТЬ.

Пользователь будет удалён и перестанет отображаться в таблице.

Управление группами пользователей

В этом разделе описано, как управлять группами пользователей, и приведены следующие инструкции:

Просмотр групп пользователей

Чтобы просмотреть группы пользователей, в разделе СИСТЕМА левой панели перейдите на страницу Пользователи → Группы.

Отобразится таблица Группы пользователей со следующими столбцами:

Группа: уникальное имя группы пользователей.
Описание: краткое описание группы пользователей.
Группа LDAP: группа LDAP, которая относится к группе пользователей.
Действия: действия, которые можно выполнить с группой пользователей. За подробной информацией о действиях с группами пользователей обратитесь к другим инструкциям в этом разделе.

Отображение столбцов таблицы Группы пользователей можно настроить, выполнив следующие действия:

Чтобы изменить ширину столбца, потяние его границу с помощью мыши.
Чтобы изменить порядок отображения столбцов, в правом верхнем углу таблицы нажмите РЕДАКТИРОВАТЬ, после чего в меню перетащите имена столбцов с помощью мыши. Столбец в верхней части меню отображается первым в таблице.
Чтобы скрыть или показать столбцы, в правом верхнем углу страницы нажмите РЕДАКТИРОВАТЬ, после чего в меню деактивируйте или активируйте переключатели рядом с именами столбцов.

Чтобы обновить таблицу Группы пользователей, в правом верхнем углу страницы нажмите Обновить данные .

Фильтрация и сортировка групп пользователей

Группы пользователей можно фильтровать и сортировать по имени:

Чтобы отобразить группы пользователей с конкретными именами, выполните следующие действия:
1. Нажмите на значок фильтра рядом с именем столбца Группа.
2. В меню установите флажки рядом с именами групп пользователей. Имя группы пользователей можно найти, введя его в поле поиска в верхней части меню.
  При необходимости снять установленные флажки в правом верхнем углу меню нажмите Сбросить.
3. Нажмите ПРИМЕНИТЬ.
Чтобы отобразить группы пользователей по алфавиту в восходящем или нисходящем порядке на основании имени, нажмите на стрелку вверх или стрелку вниз рядом с именем столбца Группа.

Создание группы пользователей

Чтобы создать группу пользователей, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи → Группы.
Отобразится таблица Группы пользователей.
В правом верхнем углу страницы нажмите СОЗДАТЬ ГРУППУ.
Откроется окно СОЗДАНИЕ ГРУППЫ.
Укажите подробную информацию о новой группе пользователей (помеченные звёздочкой параметры являются обязательными):
- Название: уникальное имя группы пользователей.
- Описание: краткое описание группы пользователей.
- Группа LDAP: группа LDAP, которая будет относится к группе пользователей.
- Пользователи: пользователи, которые будут добавлены в группу. Выбор пользователя можно отменить, нажав на крестик рядом с его именем.
  Вы также можете добавить пользователя в группу при создании и редактировании этого пользователя.
- Права доступа: роли, которые будут назначены группе пользователей. Чтобы назначить роль группе пользователей, нажмите ДОБАВИТЬ РОЛЬ + и выберите роль из выпадающего списка. Роль можно отозвать, нажав на значок корзины рядом с ней.
  При выборе определённых ролей выберите из выпадающего списка объекты, к которым эти роли будут предоставлять доступ. Объект можно отозвать, нажав на крестик рядом с его именем.
Нажмите СОХРАНИТЬ.

Группа пользователей будет создана и появится в таблице групп пользователей.

Просмотр информации о группе пользователей

Вы можете просмотреть, какие пользователи добавлены в группу, а также какие группе назначены роли.

Чтобы просмотреть информацию о группе пользователей, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи → Группы.
Отобразится таблица Группы пользователей.
Нажмите на значок трёх вертикальных точек → Показать детали рядом с группой пользователей, информацию о которой необходимо просмотреть.

Откроется окно с информацией о группе пользователей.

Редактирование группы пользователей

Чтобы отредактировать группу пользователей, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи → Группы.
Отобразится таблица Группы пользователей.
Нажмите на значок трёх вертикальных точек → Редактировать рядом с группой пользователей, которую необходимо отредактировать.
Откроется окно РЕДАКТИРОВАНИЕ ГРУППЫ.
Измените параметры группы пользователей.
Нажмите СОХРАНИТЬ.

Удаление группы пользователей

Группы пользователей, которые были удалены, восстановлению не подлежат. При удалении группы добавленные в неё пользователи не удаляются, но у них отзываются все роли, назначенные в рамках группы. Если требуется, пользователей можно удалить отдельно или отредактировать и повторно назначить им роли.

Чтобы удалить группу пользователей, выполните следующие действия:

В разделе СИСТЕМА левой панели перейдите на страницу Пользователи → Группы.
Отобразится таблица Группы пользователей.
Нажмите на значок трёх вертикальных точек → Удалить рядом с группой пользователей, которую необходимо удалить.
Откроется окно Удаление группы.
Нажмите УДАЛИТЬ.

Группа пользователей будет удалена и перестанет отображаться в таблице.

Роли и привилегии

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

Описание ролей

В PPEM существуют следующие роли:

System administrator role: имеет полный набор привилегий.
Guest role: может просматривать ограниченное количество объектов.
Instance objects administrator role: может управлять объектами экземпляра.
Instance objects viewer role: может просматривать объекты экземпляра.
Instance administrator role: может управлять экземпляром.
Пользователь консоли: может запускать psql в рамках экземпляра.
Access administrator role: может управлять ролями пользователей и групп.
Repositories and packages administrator: может управлять репозиториями и пакетами.

В веб-приложении невозможно создавать новые роли и редактировать существующие, однако это можно сделать с помощью API.

Описание привилегий

Роли могут иметь следующие привилегии:

privilege_view: просмотр привилегий и их описаний.
role_create: создание ролей.
role_view: просмотр ролей и их параметров.
role_edit: редактирование ролей.
role_delete: удаление ролей.
user_create: создание пользователей.
user_view_all: просмотр любых пользователей и их параметров.
user_edit_all: редактирование любых пользователей.
user_delete: удаление пользователей.
project_create: создание проектов.
project_view: просмотр проектов и их параметров.
project_edit: редактирование проектов.
project_delete: удаление проектов.
notification_create: создание уведомлений.
notification_view: просмотр уведомлений и их параметров.
notification_edit: редактирование уведомлений.
notification_delete: удаление уведомлений.
group_create: создание групп пользователей.
group_view: просмотр групп пользователей и их параметров.
group_edit: редактирование групп пользователей.
group_delete: удаление групп пользователей.
host_create: создание серверов.
host_view: просмотр серверов и их параметров.
host_edit: редактирование серверов.
host_delete: удаление серверов.
agent_create: создание агентов.
agent_view: просмотр агентов и их параметров.
agent_edit: редактирование агентов.
agent_delete: удаление агентов.
instance_create: создание экземпляров.
instance_view: просмотр экземпляров.
instance_edit: редактирование экземпляров.
instance_delete: удаление экземпляров.
session_view_all: просмотр любых пользовательских сеансов.
session_delete_all: удаление любых пользовательских сеансов.
session_update: обновление пользовательских сеансов.
command_create: создание команд.
command_view_all: просмотр любых команд.
command_edit_all: редактирование любых команд.
command_delete_all: отмена любых команд.
instance_object_view: просмотр объектов экземпляра и их параметров.
metrics_view: просмотр метрик.
job_create: создание заданий.
job_view_all: просмотр любых заданий.
job_edit_all: редактирование любых заданий.
job_delete_all: удаление любых заданий.
backup_create: создание резервных копий.
backup_view: просмотр резервных копий.
backup_edit: редактирование резервных копий.
backup_delete: удаление резервных копий.
datasource_create: создание хранилищ данных.
datasource_view: просмотр хранилищ данных.
datasource_edit: редактирование хранилищ данных.
datasource_delete: удаление хранилищ данных.
maintenance_create: выполнение команд технического обслуживания.
instance_service_control: выполнение служебных команд.
instance_settings_create: создание параметров экземпляров. Это сервисная привилегия, необходимая агентам для добавления параметров экземпляров в базу данных репозитория.
instance_settings_view: просмотр параметров экземпляров.
instance_settings_edit: редактирование параметров экземляров.
query_state_read: выполнение команды pg_query_state.
logs_view: просмотр журналов.
chart_create: создание графиков.
chart_view: просмотр графиков.
chart_edit: редактирование графиков.
chart_delete: удаление графиков.
chart_group_create: создание групп графиков.
chart_group_view: просмотр групп графиков.
chart_group_edit: редактирование групп графиков.
chart_group_delete: удаление групп графиков.
stat_activity_view: просмотр статистики представления pg_stat_activity.
stat_statements_view: просмотр любых операторов SQL, выполненных сервером.
overview_view: просмотр обзорной информации о системе.
tag_create: создание тегов.
tag_view: просмотр тегов и их параметров.
tag_edit: редактирование тегов.
tag_delete: удаление тегов.
progress_stats_view: просмотр статистики представлений pg_stat_progress_*.
about_view: просмотр информации о системе.
pgpro_pwr_databases_view: просмотр расширений pgpro_pwr.
pgpro_pwr_servers_delete: удаление серверов pgpro_pwr.
pgpro_pwr_servers_view: просмотр серверов pgpro_pwr.
create_replication_nodes: cоздание узлов репликации.
pgpro_pwr_servers_add: добавление серверов pgpro_pwr.
pgpro_pwr_servers_patch: установка патчей для расширений pgpro_pwr.
stat_locktree_view: просмотр дерева блокировок (locktree).
pgpro_pwr_samples_create: создание выборок pgpro_pwr.
pgpro_pwr_samples_get: просмотр выборок pgpro_pwr.
pgpro_pwr_samples_delete: удаление выборок pgpro_pwr.
pgpro_pwr_report_create: cоздание отчётов pgpro_pwr.
pgpro_pwr_report_delete: удаление отчётов pgpro_pwr.
view_replication_nodes: просмотр узлов репликации.
pgpro_pwr_report_view: просмотр отчётов pgpro_pwr.
settings_preset_view: просмотр пресетов.
pgpro_pwr_overview: просмотр содержимого отчётов pgpro_pwr.
manage_user_roles: назначение и отзыв ролей пользователей.
manage_group_roles: назначение и отзыв ролей групп пользователей.
manage_user_groups: добавление и удаление пользователей из групп.
job_run_all: запуск любых заданий.

Просмотр ролей и привилегий

Чтобы просмотреть роли и привилегии, в разделе СИСТЕМА левой панели перейдите на страницу Пользователи → Роли.

Отобразятся роли. Для каждой роли отображается класс объектов, к которым она предоставляет доступ, а также таблица привилегий со следующими столбцами:

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

Чтобы отобразить таблицу привилегий конкретной роли, в левом верхнем углу страницы выберите роль из выпадающего списка.

Кластеры репликации

Страница описывает кластеры репликации, обслуживаемые PPEM и позволяет просматривать информацию о кластерах репликации.

Страница состоит из основной таблицы со списком серверов.

Термины

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

Структура (или иерархия связей между узлами) кластера репликации представляет собой ацикличный граф (не допускает цикличных связей) или так называемое "дерево".

Просмотр кластеров

Для просмотра кластеров доступна таблица со следующим списком полей:

Кластер - название и идентификатор кластера.
Экземпляр - название экземпляра, который является узлом кластера.
Узел выше - название экземпляра, который в этом кластере является ведущим узлом для текущего узла кластера.
Статус - последняя известное значение роли узла в кластере.
Состояние - последнее известное состояние узла в кластере.
Сетевой адрес - сетевой адрес узла.
Пользователь - пользователь, от имени которого осуществляется подключение для репликации.
Приложение - идентификатор приложения, которое используется в подключении репликации.
Время подключения - время установки подключения репликации.
Горизонт видимости - транзакционный горизонт видимости.
Отставание - задержка репликации, т.е. объем данных отставания узла от ведущего.
Время отставания - временная задержка репликации, т.е. время отставания узла от ведущего.
Последнее обновление - время последнего обновления информации о состоянии всего кластера.
Синхронный режим - информация о работе синхронной репликации.
Время ответа - время, когда ведущий узел получил сведения от ведомого узла.

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

Заметка. Большая часть данных о кластерах репликации формируются на основе данных из представлений pg_stat_replication ведущих узлов и pg_stat_wal_receiver с ведомых узлов.

Экземпляры

Страница предоставляет возможности для просмотра и управления экземплярами СУБД, добавленных в PPEM. Для управления экземплярами предоставлены базовые функции.

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

Список экземпляров представлен в виде основной таблицы и содержит следующую информацию об экземплярах:

Название - имя экземпляра и дополнительные информационные сведения: номер сетевого порта, каталог данных, версия ПО. Для поля доступен фильтр и сортировка.
Сервер - имя сервера, на котором размещается экземпляр и дополнительная информация о сервере: адрес и последнее известное состояние сервера. Для поля доступен фильтр.
Роль - роль экземпляра:
- отдельный - узел является отдельным экземпляром и не является участником кластеров репликации.
- ведущий - экземпляр является ведущим узлом в кластере потоковой репликации и обеспечивает репликацию данных на ведомые узлы.
- ведомый - экземпляр является ведомым узлом в кластере потоковой репликации и является приемником данных репликации.
- каскадный - экземпляр является ведомым узлом в кластере потоковой репликации и одновременно выполняет репликацию данных другим узлам.
База данных - содержит сведения о базах данных экземпляра (количество баз данных) и некоторую информацию о производительности: количество обрабатываемых транзакций в секунду, количество установленных соединений, средняя нагрузка на процессор.
Теги - список тегов, присвоенных экземпляру. Для поля доступен фильтр.
Действия - список действий, доступных над экземпляром:
- остановить - выполняет завершение экземпляра, при нажатии на кнопку открывается окно подтверждения;
- запустить - выполняет запуск ранее остановленного экземпляра;
- перезапустить - выполняет перезапуск экземпляра, при нажатии на кнопку открывается окно подтверждения;
- создать резервную копию - запустить процесс резервного копирования (необходимо наличие pg_probackup);
- пресеты конфигурации - применить группу настроек конфигурации (пресет) на экземпляр;
- редактировать - позволяет редактировать некоторые атрибуты экземпляра;
- удаление из EM - позволяет удалить экземпляр из PPEM.

Управление экземплярами

Добавление экземпляра с помощью агента

Агент PPEM при запуске выполняет поиск активных экземпляров СУБД и автоматически добавляет их в PPEM. Автоматический поиск экземпляров и регистрация в PPEM может настраиваться через конфигурацию агента.

Во время автоматического поиска агент выполняет сбор основных сведений об экземпляре и добавляет экземпляр в PPEM.

Создание нового экземпляра

Создание нового экземпляра подразумевает инициализацию основного каталога данных (data directory) и запуск службы СУБД. Для создания нового экземпляра нужно нажать кнопку "Добавить экземпляр" в верхнем правом углу страницы. В открывшейся форме следует выбрать пункт "Создать новый экземпляр" и нажать кнопку "Далее". На следующем шаге следует заполнить поля:

Название - название экземпляра в системе PPEM. Обязательное поле.
Сервер - сервер на котором следует создать экземпляр. Обязательное поле.
Версия - номер версии PostgreSQL. Зависит от наличия версий, которые установлены на сервере.
Системный пользователь - системный пользователь операционной системы, которому будут принадлежать файлы и каталоги экземпляра и от имени которого будет запущена служба экземпляра. Как правило, это пользователь postgres, но могут быть и исключения. Указанный пользователь должен существовать в операционной системе. Обязательное поле.
Основной каталог данных - путь к каталогу, в котором будут размещены основные каталоги и файлы экземпляра. Обязательное поле.
Адрес подключения - сетевой адрес, который будет использоваться экземпляром для приема клиентских подключений. По умолчанию имеет значение localhost. Обязательное поле.
Порт подключения - номер порта, который будет использоваться экземпляром для приема клиентских подключений. Обязательное поле.
Метод аутентификации - метод аутентификации, который будет использоваться для проверки пользователей при установке клиентских соединений. Доступны следующие варианты:
- scram-sha-256 - основной и широко используемый метод парольной аутентификации.
- md5 - устаревший метод аутентификации, сохранен для совместимости.
- trust - не выполнять аутентификацию, рекомендуется для использования только в тестовых средах и окружениях.
Супер-пользователь БД - имя пользователя с привилегиями SUPERUSER, который будет создан при создании кластера. По умолчанию postgres.
Пароль супер-пользователя БД - пароль, используемый при подключении от имени супер-пользователя.
Запустить экземпляр после создания - указывает на необходимость запуска службы экземпляра после создания. По умолчанию включено.
Теги - добавить теги на создаваемый экземпляр.

После заполнения обязательных полей следует нажать кнопку "Выполнить". Новый экземпляр будет добавлен в список экземпляров, при этом создание экземпляра выполняется в фоновом режиме.

Добавление существующего экземпляра

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

Для добавления существующего экземпляра нужно нажать кнопку "Добавить экземпляр" в верхнем правом углу страницы. В открывшейся форме, следует выбрать пункт "Добавить существующий экземпляр" и нажать кнопку "Далее". На следующем шаге следует заполнить поля:

Название - название экземпляра в системе PPEM. Обязательное поле.
Сервер - сервер, на котором работает экземпляр. Обязательное поле.
Основной каталог данных - путь к каталогу, в котором размещаются основные каталоги и файлы экземпляра. Обязательное поле.
Адрес подключения - сетевой адрес, который уже используется экземпляром для приема клиентских подключений. По умолчанию имеет значение localhost. Обязательное поле.
Порт подключения - номер порта, который уже используется экземпляром для приема клиентских подключений. Обязательное поле.
Супер-пользователь БД - имя пользователя с привилегиями SUPERUSER, которое следует использовать для подключения к экземпляру. По умолчанию postgres.
Пароль супер-пользователя БД - пароль, используемый при подключении от имени супер-пользователя.
Теги - добавить теги к экземпляру.

После заполнения обязательных полей следует нажать кнопку "Выполнить". Экземпляр будет добавлен в список экземпляров, добавление экземпляра и проверка его состояния выполняется в фоновом режиме.

Создание экземпляра из резервной копии

При наличии резервных копий с их помощью можно создать новый экземпляр. Для создания экземпляра нужно нажать кнопку "Добавить экземпляр" в верхнем правом углу страницы. В открывшейся форме следует выбрать пункт "Создать новый экземпляр из резервной копии" и нажать кнопку "Далее". На следующем шаге следует заполнить поля:

Каталог - каталог с целевой резервной копией, которая будет использоваться для восстановления.
Экземпляр - имя экземпляра (внутри каталога), с которым ассоциированы резервные копии в каталоге.
Период - интервал времени, в котором была создана целевая резервная копия.
Резервная копия - целевая резервная копия, которая будет использоваться для восстановления.

После выбора резервной копии, следует нажать кнопку "Далее" и перейти к заполнению параметров экземпляра:

Название - название экземпляра в системе PPEM. Обязательное поле.
Сервер - сервер, на котором работает экземпляр. Обязательное поле.
Системный пользователь - системный пользователь операционной системы, которому будут принадлежать файлы и каталоги экземпляра и от имени которого будет запущена служба экземпляра. Как правило, это пользователь postgres, но могут быть и исключения. Указанный пользователь должен существовать в операционной системе. Обязательное поле.
Основной каталог данных - путь к каталогу, в котором будут размещены основные каталоги и файлы экземпляра. Обязательное поле.
Адрес подключения - сетевой адрес, который будет использоваться экземпляром для приема клиентских подключений. По умолчанию имеет значение localhost. Обязательное поле.
Порт подключения - номер порта, который будет использоваться экземпляром для приема клиентских подключений. Обязательное поле.
Теги - добавить теги к экземпляру.
Точка восстановления - использование процедуры Point-in-Time-Recovery (PITR) с указанием цели восстановления, возможны следующие варианты:
- Время - восстановление на указанный момент времени.
- LSN - восстановление до указанной позиции в журнале транзакций (WAL).
- Транзакция - восстановление до указанного номера транзакции.
Частичное восстановление - позволяет выборочно восстановить отдельные базы данных или, наоборот, выборочно исключить отдельные базы данных в процессе восстановления из резервной копии. При указании частичного восстановления следует указать имена целевых баз данных.

После заполнения параметров следует нажать кнопку "Выполнить", после чего экземпляр появится в списке экземпляров, а процесс восстановления будет запущен в фоновом режиме.

Редактирование экземпляра

Для редактирования экземпляра нужно нажать кнопку "Редактировать" в поле "Действия". При нажатии на кнопку откроется форма редактирования, в которой доступны следующие поля:

Название - позволяет указать новое имя экземпляра
Экземпляр репозитория - позволяет отметить экземпляр, в котором размещается база данных репозитория. Более подробную информацию можно получить в разделе "Экземпляр репозитория PPEM".

После ввода новых значений нужно нажать кнопку "Сохранить".

Остановка экземпляра

Для остановки экземпляра нужно нажать кнопку "Остановить" в поле "Действия". При нажатии на кнопку откроется форма подтверждения, дальше следует нажать кнопку "Остановить", после чего экземпляр будет остановлен.

Запуск экземпляра

Для запуска экземпляра нужно нажать кнопку "Запустить", после этого будет выполнен запуск экземпляра.

Перезапуск экземпляра

Для перезапуска экземпляра нужно нажать кнопку "Перезапустить" в поле "Действия". При нажатии на кнопку откроется форма подтверждения, дальше следует нажать кнопку "Перезапустить", после чего будет выполнен перезапуск экземпляра.

Выполнить резервное копирование

Выполнить резервное копирование экземпляра. Необходимо наличие pg_probackup на сервере экземпляра. Более подробное о резервном копировании можно прочитать в разделе "Резервное копирование".

Пресеты конфигурации

Установить пресет конфигурации. Позволяет применить к экземпляру группу настроек и при необходимости перезапустить экземпляр.

Удаление экземпляра

Для удаления экземпляра нужно нажать кнопку "Удалить из EM" в списке "Действия". При нажатии на кнопку откроется форма подтверждения, дальше следует нажать кнопку "Удалить", после чего экземпляр будет удален.

Удаление экземпляра выполняется из базы репозитория. Следовательно, никаких реальных действий по остановке и удалению экземпляра на сервере не выполняется.

Экземпляр репозитория PPEM

Менеджер PPEM использует экземпляр СУБД для хранения собственных данных, следовательно, этот экземпляр также может быть добавлен в PPEM. После запуска PPEM рекомендуется выбрать экземпляр репозитория PPEM из списка экземпляров. Если экземпляр репозитория не выбран, то в качестве подсказки на странице (под заголовком) будет сообщение с текстом о необходимости указать экземпляр репозитория.

Для отметки экземпляра репозитория нужно у целевого экземпляра в поле "Действия" нажать кнопку "Редактировать". В открывшейся форме нужно установить "Экземпляр репозитория" во включённое состояние и нажать кнопку "Сохранить". После этого в основном списке экземпляром напротив имени экземпляра отоборазится иконка с изображением короны, которая и указывает на то, что экземпляр является Экземпляром репозитория.

Табличные пространства

Табличные пространства позволяют управлять логикой размещения файлов объектов базы данных в файловой системе. В табличных пространствах можно размещать как отдельные таблицы и индексы, так базы данных целиком.

Более подробно про табличные пространства можно прочитать в документации PostgreSQL: https://postgrespro.ru/docs/postgrespro/current/manage-ag-tablespaces

Страница "Табличные пространства" позволяет управлять табличными пространствами, которые есть в экземпляре, и содержит следующий элементы:

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

Просмотр табличных пространств

Для просмотра списка табличных пространств на странице доступна таблица-список со следующим набором полей:

Название - обязательное название табличного пространства; поле содержит фильтр и сортировку.
Экземпляр - название экземпляра, которому принадлежит табличное пространство.
Владелец - пользователь СУБД, являющийся владельцем табличного пространства.
Путь - каталог табличного пространства на файловой системе.
Конфигурационные параметры - дополнительные параметры конфигурации, специфичные для табличных пространств.
Размер - общий размер объектов внутри табличного пространства.
Действия - список действий доступных над табличным пространством:
- редактирование
- удаление

Создание табличных пространств

Для создания табличного пространства нужно нажать кнопку "Создать пространство". Форма создания содержит следующие поля:

Экземпляр - название экземпляра, которому будет принадлежать табличное пространство. Поле носит информационный характер и недоступно для редактирования.
Название - обязательное название табличного пространства.
Каталог - путь до каталога, в котором будет размещаться табличное пространства.
Владелец БД - пользователь СУБД, которому будет принадлежать табличное пространство.
seq_page_cost - значение параметра seq_page_cost, которое будет присвоено табличному пространству.
random_page_cost - значение параметра random_page_cost, которое будет присвоено табличному пространству.
effective_io_concurrency - значение параметра effective_io_concurrency, которое будет присвоено табличному пространству.
maintenance_io_concurrency - значение параметра maintenance_io_concurrency, которое будет присвоено табличному пространству.
compression - использование файловой системы с функцией сжатия (CFS); возможность доступна только в редакции PostgresPro Enterprise.
- Да - включить использование CFS.
- Нет - выключить использование CFS.
- Не определено (значение по умолчанию).

При создании табличного пространства создается каталог в файловой системе и затем создается табличное пространство с помощью CREATE TABLESPACE. Создание табличного пространства может быть выполнено в уже существующем каталоге, однако в таком случае каталог должен быть пуст.

Редактирование табличных пространств

Для редактирования табличного пространства в основной таблице в колонке "Действия" нужно нажать кнопку "Редактирование". В открывшейся форме редактирования доступно только изменение имени.

Редактирование табличных пространств выполняется с помощью команды ALTER TABLESPACE.

Удаление табличных пространств

Для удаления табличного пространства в основной таблице в колонке "Действия" нужно нажать кнопку "Удалить". В открывшейся форме следует подтвердить удаление.

Примечание: Перед удалением табличного пространства все находящиеся в нем объекты следует переместить или удалить. Удаление непустого табличного пространства завершится ошибкой.

Удаление табличных пространств выполняется с помощью команды DROP TABLESPACE.

Базы данных

Postgres Pro Enterprise Manager позволяет работать с базами данных, схемами, таблицами, индексами, функциями и последовательностями.

Управление базами данных

В этом разделе описано, как создавать, просматривать, переименовывать и удалять базы данных, а также запускать их переиндексацию, запускать терминал PSQL, собирать статистику планировщика и запускать очистку таблиц.

Создание базы данных

Чтобы создать базу данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В правом верхнем углу страницы нажмите СОЗДАТЬ БАЗУ ДАННЫХ.
Откроется окно создания базы данных.
Укажите подробную информацию о новой базе данных (помеченные звёздочкой параметры являются обязательными):
- Экземпляр: экземпляр СУБД, в котором будет создана база данных.
- Название БД: уникальное имя базы данных.
- Владелец БД: владелец базы данных.
- Кодировка (ENCODING): кодировка символов в новой базе данных.
- Категория сортировки (LC_COLLATE): устанавливает значение LC_COLLATE в окружении операционной системы сервера баз данных.
- Категория типов символов (LC_CTYPE): устанавливает значение LC_CTYPE в окружении операционной системы сервера баз данных.
- Табличное пространство: табличное пространство, в котором будет создана база данных.
- Разрешить соединение: указывает на то, будет ли база данных доступна для подключений.
- Ограничение количества соединений: лимит одновременно установленных сеансов к базе данных.
- Является ли шаблоном: указывает на то, будет ли созданная база данных шаблоном.
- Шаблон: шаблон базы данных.
Нажмите СОХРАНИТЬ.

База данных будет создана и появится в таблице Базы данных.

Просмотр баз данных

Чтобы просмотреть базы данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.

Отобразится таблица Базы данных со следующими столбцами:

Имя БД: уникальное имя базы данных. БД можно фильтровать и сортировать, нажимая на соответствующие значки.
Общий размер: размер базы данных. Горизонтальный индикатор показывает размер таблиц, раздувания и индексов.
Wraparound: количество свободных идентификаторов транзакций в базе данных (в процентах).
Экземпляр: уникальное имя экземпляра.
Сбор данных: объём, в котором агенты собирают служебную информацию с экземпляров.
Таблицы: общая информация о таблицах:
- Количество таблиц
- Размер таблиц
- Процент раздувания таблиц
Индексы: общая информация об индексах:
- Количество индексов
- Размер индексов
- Процент раздувания индексов
Действия: действия, которые можно выполнить с базой данных. Эти операции затрагивают все объекты в базе данных:
- Analyze: сбор статистики планировщика. Выполняется SQL-команда ANALYZE.
- Reindex: перестроение всех индексов в базе данных. Выполняется SQL-команда REINDEX.
- Vacuum: очистка от устаревших версий строк по всем таблицам базы данных. Выполняется SQL-команда VACUUM.
- Rename: переименование базы данных. Выполняется SQL-команда ALTER DATABASE с предложением RENAME TO.
- Drop: удаление базы данных. Выполняется SQL-команда DROP DATABASE.

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

ПРЕДУПРЕЖДЕНИЕ
Если база данных создаётся за пределами Postgres Pro Enterprise Manager, информация о ней в интерфейсе решения может появляться с задержкой. Длительность задержки зависит от настроек агента Postgres Pro Enterprise Manager и по умолчанию равна одной минуте.

Запуск терминала PSQL

Терминал PSQL предоставляет низкоуровневый доступ к экземпляру СУБД и предназначен для тех случаев, когда возможностей Postgres Pro Enterprise Manager недостаточно. Он предоставляет большую часть функциональности классического psql, но всё же имеет ограничения. Например, вызов мета-команды \! для запуска shell-команд запрещён.

При запуске терминала используются параметры подключения к экземпляру СУБД.

Чтобы запустить терминал PSQL, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В столбце Действия нажмите PSQL рядом с базой данных, для которой необходимо запустить терминал.

Откроется окно терминала PSQL. В правом верхнем углу окна можно развернуть терминал на полный экран, открыть в отдельном окне или закрыть и выйти из него.

Сбор статистики планировщика

Чтобы запустить сбор статистики планировщика, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В столбце Действия нажмите Analyze рядом с базой данных, для которой необходимо запустить сбор статистики.
Откроется окно Analyze.
Задайте необходимые параметры (помеченные звёздочкой параметры являются обязательными):
- Задать выполнение cron-строкой: позволяет задать расписание выполнения операции в формате crontab.
- Планирование задачи: позволяет запланировать выполнение задачи.
Нажмите ПРИМЕНИТЬ.
Подтвердите выполнение операции.

Сбор статистики будет запущен в асинхронном режиме.

ПРИМЕЧАНИЕ
Для сбора статистики планировщика используется SQL-команда ANALYZE. Как правило, сбор статистики не требует значительных ресурсов. Тем не менее его продолжительность зависит от количества таблиц и столбцов и может занимать длительное время.

Чтобы отследить ход сбора статистики планировщика, выполните следующие действия:

Выберите базу данных в таблице Базы данных.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Активность.
Откроется страница Активность с разными вкладками.
Перейдите на вкладку СБОР СТАТИСТИКИ.

Отобразится статистика планировщика.

Переиндексация

Чтобы запустить перестроение всех индексов базы данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В столбце Действия нажмите Reindex рядом с базой данных, для которой необходимо перестроить индексы.
Откроется окно Reindex.
Задайте необходимые параметры (помеченные звёздочкой параметры являются обязательными):
- Concurrently: указывает на то, следует ли выполнить операцию в неблокирующем режиме. Это наиболее безопасный режим, который позволяет избежать блокировки работы соседних сеансов за счёт некоторого замедления самого процесса переиндексации. Это режим по умолчанию.
- Табличное пространство: табличное пространство, в котором будут создаваться новые индексы.
- Задать выполнение cron-строкой: позволяет задать расписание выполнения операции в формате crontab.
- Планирование задачи: позволяет запланировать выполнение задачи.
Нажмите ПРИМЕНИТЬ.
Подтвердите выполнение операции.

Задача на перестроение индексов будет запущена.

ПРИМЕЧАНИЕ
Для переиндексации используется SQL-команда REINDEX. Чтобы выполнить эту операцию, могут потребоваться значительные ресурсы в зависимости от количества и размера индексов, поэтому ход перестроения индексов рекомендуется отслеживать.

Чтобы отследить ход перестроения индексов, выполните следующие действия:

Выберите базу данных в таблице Базы данных.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Активность.
Откроется страница Активность с разными вкладками.
Перейдите на вкладку ИНДЕКСАЦИЯ.

Отобразится информация о перестроении индексов базы данных.

Запуск очистки

Чтобы запустить очистку устаревших версий строк, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В столбце Действия нажмите Vacuum рядом с базой данных, для которой необходимо запустить очистку.
Откроется окно Vacuum.
Задайте необходимые параметры (помеченные звёздочкой параметры являются обязательными):
- Режимы: режимы очистки таблиц. Возможные значения:
  - Analyze: обновляет статистику, которую планировщик использует для выбора наиболее эффективного способа выполнения запроса.
  - Full: выполняет полную очистку через перестроение файлов таблицы. Обратите внимание, что на время выполнения очистки в этом режиме все сеансы, работающие с перестраиваемыми таблицами, будут заблокированы.
  - Freeze: выполняет агрессивную «заморозку» строк для продвижения горизонта заморозки и освобождения индентификаторов транзакций для дальнейшего переиспользования. Агрессивная заморозка всегда выполняется при перезаписи таблицы, поэтому если выбран режим Full, режим Freeze выбирать не нужно.
- Задать выполнение cron-строкой: позволяет задать расписание выполнения операции в формате crontab.
- Планирование задачи: позволяет запланировать выполнение задачи.
Нажмите ПРИМЕНИТЬ.
Подтвердите выполнение операции.

Задача на очистку будет запущена.

ПРИМЕЧАНИЕ
Для очистки таблиц используется SQL-команда VACUUM. Чтобы выполнить эту операцию, могут потребоваться значительные ресурсы в зависимости от количества и размера таблиц, поэтому ход очистки рекомендуется отслеживать.

Чтобы отследить ход перестроения индексов, выполните следующие действия:

Выберите базу данных в таблице Базы данных.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Активность.
Откроется страница Активность с разными вкладками.
Перейдите на вкладку ОЧИСТКА или КЛАСТЕРИЗАЦИЯ, если для очистки был выбран режим Full.

Отобразится информация об очистке таблиц.

Переименование базы данных

Чтобы переименовать базу данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В столбце Действия нажмите Rename рядом с базой данных, которую необходимо переименовать.
Откроется окно Переименование базы данных.
Задайте необходимые параметры (помеченные звёздочкой параметры являются обязательными):
- Название: новое имя базы данных.
Нажмите СОХРАНИТЬ.

База данных будет переименована, изменение отразится в таблице Базы данных.

Удаление базы данных

Чтобы удалить базу данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
В столбце Действия нажмите Drop рядом с базой данных, которую необходимо удалить.
Откроется окно Удаление базы данных.
Нажмите УДАЛИТЬ.
Подтвердите выполнение операции.

База данных будет удалена.

ПРЕДУПРЕЖДЕНИЕ
Для удаления базы данных используется SQL-команда DROP DATABASE. После подтверждения операции база данных и данные будут безвозвратно удалены. Отменить или откатить операцию не получится.

Схемы

В этом разделе описано, как создавать, просматривать, редактировать и удалять схемы баз данных.

Создание схемы

Чтобы создать схему базы данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в которой необходимо создать схему.
Отобразится страница выбранной базы данных.
В правом верхнем углу страницы нажмите СОЗДАТЬ СХЕМУ.
Откроется окно создания схемы.
Укажите подробную информацию о новой схеме (помеченные звёздочкой параметры являются обязательными):
- Название: уникальное имя схемы.
- Владелец: владелец схемы.
Нажмите СОЗДАТЬ.

Схема будет создана и появится на странице соответствующей базы данных.

Просмотр схем

Чтобы просмотреть схемы базы данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в которой необходимо просмотреть схемы.

Отобразится таблица со следующими столбцами:

Схемы: уникальное имя схемы. Схемы можно фильтровать и сортировать, нажимая на соответствующие значки.
Общий размер: размер всех объектов, входящих в схему. Горизонтальный индикатор показывает размер таблиц, раздувания и индексов.
Владелец: владелец схемы.
Таблицы: общая информация о таблицах:
- Количество таблиц
- Размер таблиц
- Процент раздувания таблиц
Индексы: общая информация об индексах:
- Количество индексов
- Размер индексов
- Процент раздувания индексов
Действия: действия, которые можно выполнить со схемой. Эти операции затрагивают все объекты в схеме:
- Редактировать: редактирование параметров схемы.
- Удалить: удаление схемы.

Размер объектов схемы рассчитывается как сумма размеров всех входящих в неё реляционных объектов.

ПРЕДУПРЕЖДЕНИЕ
Если схема базы данных создаётся за пределами Postgres Pro Enterprise Manager, информация о ней в интерфейсе решения может появляться с задержкой. Длительность задержки зависит от настроек агента Postgres Pro Enterprise Manager и по умолчанию равна одной минуте.

Редактирование схемы

Чтобы отредактировать схему базы данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в которой необходимо отредактировать схему.
Отобразится страница выбранной базы данных.
В столбце Действия нажмите Редактировать рядом со схемой, которую необходимо отредактировать.
Откроется окно редактирования схемы.
В окне измените параметры схемы.
Нажмите СОХРАНИТЬ.

Схема будет отредактирована, изменения отразятся в таблице.

Удаление схемы

Чтобы удалить базу данных, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в которой необходимо удалить схему.
Отобразится страница выбранной базы данных.
В столбце Действия нажмите Удалить рядом со схемой, которую необходимо удалить.
Откроется окно удаления схемы.
Нажмите УДАЛИТЬ. Чтобы удалить все вложенные объекты схемы, активируйте переключатель Каскадное удаление.
Подтвердите выполнение операции.

Схема будет удалена.

ПРЕДУПРЕЖДЕНИЕ
Для удаления схемы базы данных используется SQL-команда DROP SCHEMA. После подтверждения операции схема будет безвозвратно удалена. Отменить или откатить операцию не получится.

Таблицы

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

Создание таблицы

Чтобы создать таблицу, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в схеме которой необходимо создать таблицу.
Откроется страница выбранной базы данных.
Выберите схему, в которой необходимо создать таблицу.
Откроется страница выбранной схемы.
В правом верхнем углу страницы нажмите СОЗДАТЬ ТАБЛИЦУ.
Откроется окно создания таблицы.
Укажите подробную информацию о новой таблице (помеченные звёздочкой параметры являются обязательными):
- Название: уникальное имя таблицы.
- Табличное пространство: табличное пространство, в котором будет создана таблица.
- Колонки: столбцы создаваемой таблицы. Чтобы добавить столбец таблицы, выполните следующие действия:
  1. Нажмите ДОБАВИТЬ + и задайте параметры столбца (помеченные звёздочкой параметры являются обязательными):
    - Название: уникальное имя столбца.
    - Тип: тип данных столбца.
    - NOT NULL: указывает на то, что столбец не принимает значения NULL.
    - Значение по умолчанию: значение по умолчанию, заданное в столбце.
    - Первичный ключ: ограничение PRIMARY KEY определяет, что столбец или столбцы таблицы могут содержать только уникальные (без повторений) значения, отличные от NULL.
      1. Нажмите ДОБАВИТЬ +, чтобы указать параметры хранения первичного ключа:
        fillfactor
        deduplicate_items
    - Уникальный ключ: ограничение UNIQUE определяет, что группа из одного или нескольких столбцов таблицы может содержать только уникальные значения.
      1. Нажмите ДОБАВИТЬ +, чтобы указать параметры хранения уникального ключа:
        fillfactor
        deduplicate_items
    - Выражение ограничения: ограничение столбца.
    - Метод сжатия: метод сжатия для столбца. Возможные значения:
      - pglz
      - lz4
  2. Нажмите СОХРАНИТЬ.
- Параметры хранения: параметры хранения таблицы.
- UNLOGGED: указывает на то, что созданная таблица будет нежурналируемой.
Нажмите СОХРАНИТЬ.

Таблица будет создана и появится на странице соответствующей схемы.

Просмотр таблиц

Чтобы просмотреть таблицы схемы, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в схеме которой необходимо просмотреть таблицы.
Отобразится страница выбранной базы данных.
Выберите схему, в которой необходимо просмотреть таблицы.

Отобразится страница выбранной схемы. Вкладка ТАБЛИЦЫ содержит следующие столбцы:

Таблицы: уникальное имя таблицы в пределах схемы. Таблицы можно фильтровать и сортировать, нажимая на соответствующие значки.
Общий размер: размер таблицы в байтах. Горизонтальный индикатор показывает:
- Размер пользовательских данных таблицы и отдельный учёт раздувания.
- Общий размер всех индексов таблицы и отдельный учёт раздувания в этих индексах.
- Размер служебного TOAST-хранилища без учёта раздувания.
CFS: указывает на то, используется ли для таблицы сжатие CFS. Актуально только для редакции Postgres Pro Enterprise.
Данные: размер данных в байтах, отдельно в процентах указано раздувание.
Индексы: общее количество индексов, размер индексов в байтах и раздувание в процентах.
TOAST: размер служебного TOAST-хранилища без учёта раздувания.
Действия: действия, которые можно выполнить с таблицей:
- Analyze: обновление статистики планировщика. Действие доступно при нажатии на значок трёх вертикальных точек .
- Reindex: перестроение индексов в таблице. Действие доступно при нажатии на значок трёх вертикальных точек .
- Vacuum: очистка от устаревших версий строк в таблице. Действие доступно при нажатии на значок трёх вертикальных точек .
- Редактировать: редактирование параметров схемы.
- Удалить: удаление схемы.

ПРИМЕЧАНИЕ
После завершения операций обслуживания таблицы информация о размерах обновляется асинхронно.

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

Информация о конкретной таблице

Чтобы отобразить информацию о конкретной таблице при просмотре таблиц схемы, выполните следующие действия:

На вкладке ТАБЛИЦЫ выберите таблицу, подробную информацию о которой необходимо просмотреть.

Отобразится страница выбранной таблицы со следующими вкладками:

СТРУКТУРА: информация о логической структуре таблицы и составе полей. Таблица вкладки содержит следующие столбцы:
- Num: порядковый номер столбца в таблице.
- Column name: уникальное имя столбца.
- Data type: тип данных столбца.
- Is nullable: указывает на то, можно ли в столбце хранить значения NULL.
- Column default: значение по умолчанию в столбце.
- Description: описание столбца в свободной форме.
- Действия: действия, которые можно выполнить со столбцом:
  - Редактировать: редактирование столбца. Доступные параметры для редактирования:
    - Тип: тип данных.
    - NOT NULL: указывает на то, можно ли в столбце хранить значения NULL.
    - Значение по умолчанию: значение по умолчанию в столбце.
  - Удалить: удаление столбца.
ИНДЕКСЫ: информация об индексах таблицы. Таблица вкладки содержит следующие столбцы:
- Индексы: уникальное имя индекса. Индексы можно фильтровать и сортировать, нажимая на соответствующие значки.
- Общий размер: общий размер индекса.
- CFS: указывает на то, используется ли для индекса сжатие CFS.
- Статус: статус индекса. Индексы можно фильтровать по статусам, нажимая на значок фильтра . Возможные значения:
  - valid: нормальное состояние индекса, при котором он доступен для использования в запросах.
  - invalid: индекс недоступен для использования в запросах. Этот статус указывает на то, что индекс находится в процессе создания или был поврежден.
- Действия: действия, которые можно выполнить с индексом:
  - REINDEX: запустить перестроение индекса.
  - Редактировать: редактирование индекса. Доступные параметры для редактирования:
    - Название: уникальное имя индекса.
    - Табличное пространство: табличное пространство, в котором будет размещён индекс.
  - Удалить: удаление индекса.
ОГРАНИЧЕНИЯ: ограничения таблицы. Таблица вкладки содержит следующие столбцы:
- Name: уникальное имя ограничения.
- Definition: определение ограничения.
ХРАНЕНИЕ: cтруктура хранения таблицы на диске. Для хранения основных и служебных данных таблицы используются следующие слои:
- Основной слой (main): слой хранения основных пользовательских данных.
- Карта свободного пространства (FSM): служебный слой с информацией о свободных участках в основном слое хранения.
- Карта видимости (VM): служебный слой с информацией о видимых строках в основном слое хранения.
- CFM: служебный слой для сжатия CFS.
- TOAST: служебный слой для размещения больших значений, превышающих ограничения стандартного страничного хранения данных.
Для каждого слоя в таблице приведены следующие столбцы:
- Размер: размер файла слоя.
- Табличное пространство: табличное пространство, в котором размещен слой.
- Путь к файлу: путь к файлу слоя.

Редактирование таблицы

Чтобы отредактировать таблицу схемы, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в схеме которой необходимо отредактировать таблицу.
Отобразится страница выбранной базы данных.
Выберите схему, в которой необходимо отредактировать таблицу.
Отобразится страница выбранной схемы с вкладкой ТАБЛИЦЫ, активной по умолчанию.
В столбце Действия нажмите Редактировать рядом с таблицей, которую необходимо отредактировать.
Откроется окно редактирования таблицы.
В окне измените параметры таблицы. Доступные параметры хранения перечислены в разделе Параметры хранения таблиц.
Нажмите СОХРАНИТЬ.

Таблица будет отредактирована.

Удаление таблицы

Чтобы удалить таблицу схемы, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных, в схеме которой необходимо удалить таблицу.
Отобразится страница выбранной базы данных.
Выберите схему, в которой необходимо удалить таблицу.
Отобразится страница выбранной схемы.
В столбце Действия нажмите Удалить рядом с таблицей, которую необходимо удалить.
Откроется окно удаления таблицы.
Нажмите УДАЛИТЬ.

Таблица будет удалена.

Параметры хранения таблиц

При создании или редактировании таблиц можно задать следующие параметры хранения:

fillfactor (integer)
toast_tuple_target (integer)
parallel_workers (integer)
autovacuum_enabled (boolean)
toast.autovacuum_enabled (boolean)
vacuum_index_cleanup (enum)
toast.vacuum_index_cleanup (enum)
vacuum_truncate (boolean)
toast.vacuum_truncate (boolean)
autovacuum_vacuum_threshold (integer)
toast.autovacuum_vacuum_threshold (integer)
autovacuum_vacuum_scale_factor (floating point)
toast.autovacuum_vacuum_scale_factor (floating point)
autovacuum_analyze_threshold (integer)
autovacuum_analyze_scale_factor (floating point)
autovacuum_vacuum_cost_delay (floating point)
toast.autovacuum_vacuum_cost_delay (floating point)
autovacuum_vacuum_cost_limit (integer)
toast.autovacuum_vacuum_cost_limit (integer)
autovacuum_freeze_min_age (integer)
toast.autovacuum_freeze_min_age (integer)
autovacuum_freeze_max_age (integer)
toast.autovacuum_freeze_max_age (integer)
autovacuum_freeze_table_age (integer)
toast.autovacuum_freeze_table_age (integer)
autovacuum_multixact_freeze_min_age (integer)
toast.autovacuum_multixact_freeze_min_age (integer)
autovacuum_multixact_freeze_max_age (integer)
toast.autovacuum_multixact_freeze_max_age (integer)
autovacuum_multixact_freeze_table_age (integer)
toast.autovacuum_multixact_freeze_table_age (integer)
log_autovacuum_min_duration (integer)
toast.log_autovacuum_min_duration (integer)
user_catalog_table (boolean)

Индексы

В этом разделе описано, как создавать, просматривать, редактировать и удалять индексы, а также выполнять переиндексацию.

Создание индекса

Чтобы создать индекс, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Выберите таблицу, в которой необходимо создать индекс.
Откроется страница выбранной таблицы.
В правом верхнем углу страницы нажмите СОЗДАТЬ ИНДЕКС.
Откроется окно создания индекса.
Укажите подробную информацию о новом индексе (помеченные звёздочкой параметры являются обязательными):
- Название: уникальное имя индекса.
- Concurrently построение: указывает на то, что индекс будет создан в особом режиме, который минимизирует количество блокировок и снижает их риск при конкурентной рабочей нагрузке.
- Unique индекс: указывает на то, что индекс будет создан с контролем повторяющихся значений в таблице. Контроль будет осуществляться как при создании индекса, так и при дальнейшем добавлении новых значений в индекс.
- Столбцы: столбцы, которые войдут в индекс. Доступные действия:
  - Чтобы добавить столбец, нажмите ДОБАВИТЬ СТОЛБЕЦ + и выберите столбец из списка.
  - Чтобы удалить столбец, нажмите на значок корзины .
(Необязательно) Активируйте переключатель Расширенные настройки в правом верхнем углу окна, чтобы задать дополнительные параметры:
- Табличное пространство: табличное пространство, в котором будет размещён индекс.
- Using предикат: указывает метод доступа. Возможные значения:
  - btree (значение по умолчанию)
  - gin
  - gist
  - brin
  - hash
- Where предикат: указывает условие индекса.
- Столбцы:
  - Столбец: столбец из списка.
  - Класс операторов
  - Правило сортировки
  - Сортировка: порядок сортировки. Возможные значения:
    - По умолчанию
    - По возрастанию
    - По убыванию
  - Порядок Null: порядок сортировки значений NULL. Возможные значения:
    - По умолчанию
    - NULL вверху
    - NULL внизу
Нажмите СОЗДАТЬ.

Индекс будет создан и появится на вкладке ИНДЕКСЫ страницы соответствующей таблицы или страницы схемы, в которой создана таблица.

Просмотр индексов

Чтобы просмотреть индексы, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Выберите таблицу, в которой необходимо просмотреть индексы.
Откроется страница выбранной таблицы.
Перейдите на вкладку ИНДЕКСЫ.

Отобразится таблица со следующими столбцами:

Индексы: уникальное имя индекса. Индексы можно фильтровать и сортировать, нажимая на соответствующие значки.
Общий размер: общий размер индекса.
CFS: указывает на то, используется ли для индекса сжатие CFS.
Статус: статус индекса. Индексы можно фильтровать по статусам, нажимая на значок фильтра . Возможные значения:
- valid: нормальное состояние индекса, при котором он доступен для использования в запросах.
- invalid: индекс недоступен для использования в запросах. Этот статус указывает на то, что индекс находится в процессе создания или был поврежден.
Действия: действия, которые можно выполнить с индексом:
- REINDEX: запустить перестроение индекса.
- Редактировать: редактирование индекса. Доступные параметры для редактирования:
  - Название: уникальное имя индекса.
  - Табличное пространство: табличное пространство, в котором будет размещён индекс.
- Удалить: удаление индекса.

ПРЕДУПРЕЖДЕНИЕ
Если индекс создаётся за пределами Postgres Pro Enterprise Manager, информация о нём в интерфейсе решения может появляться с задержкой. Длительность задержки зависит от настроек агента Postgres Pro Enterprise Manager и по умолчанию равна одной минуте.

Редактирование индекса

Чтобы отредактировать индекс, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Выберите таблицу, в которой необходимо отредактировать индекс.
Откроется страница выбранной таблицы.
Перейдите на вкладку ИНДЕКСЫ.
Откроется таблица индексов.
В столбце Действия нажмите Редактировать рядом с индексом, который необходимо отредактировать.
Откроется окно редактирования индекса.
В окне измените параметры индекса.
Нажмите СОХРАНИТЬ.

Индекс будет отредактирован, изменения отразятся в таблице индексов.

Переиндексация

Чтобы перестроить индекс, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Выберите таблицу, в которой необходимо перестроить индекс.
Откроется страница выбранной таблицы.
Перейдите на вкладку ИНДЕКСЫ.
Отобразится таблица индексов.
В столбце Действия нажмите REINDEX рядом с индексом, который хотите перестроить.
Откроется окно подтверждения операции со следующими параметрами:
- Concurrently: указывает на то, следует ли выполнить операцию в неблокирующем режиме. Это наиболее безопасный режим, который позволяет избежать блокировки работы соседних сеансов за счёт некоторого замедления самого процесса переиндексации. Это режим по умолчанию. Возможные значения:
  - Да
  - Нет
- Табличное пространство: табличное пространство, в котором будет выполнено перестроение индекса.
Нажмите ВЫПОЛНИТЬ.

Будет запущена задача на перестроение индекса.

ПРИМЕЧАНИЕ
Для переиндексации используется SQL-команда REINDEX. Чтобы выполнить эту операцию, могут потребоваться значительные ресурсы, поэтому ход перестроения индексов рекомендуется отслеживать.

Чтобы отследить ход перестроения индексов, выполните следующие действия:

Выберите базу данных в таблице Базы данных.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Активность.
Откроется страница Активность с разными вкладками.
Перейдите на вкладку ИНДЕКСАЦИЯ.

Отобразится информация о перестроении индексов.

Удаление индекса

Чтобы удалить индекс, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Выберите таблицу, в которой необходимо удалить индекс.
Откроется страница выбранной таблицы.
Перейдите на вкладку ИНДЕКСЫ.
Откроется таблица индексов.
В столбце Действия нажмите Удалить рядом с индексом, который необходимо удалить.
Откроется окно удаления индекса.
Нажмите УДАЛИТЬ.

Индекс будет удалён, изменения отразятся в таблице индексов.

Функции

В этом разделе описано, как создавать, просматривать, редактировать и удалять функции.

Создание функции

Чтобы создать функцию, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ФУНКЦИИ.
В правом верхнем углу страницы нажмите СОЗДАТЬ ФУНКЦИЮ.
Откроется окно создания функции.
Укажите подробную информацию о новой функции (помеченные звёздочкой параметры являются обязательными):
- Название: уникальное имя функции.
- Язык: процедурный язык функции.
- Аргументы: аргументы функции. Возможные значения:
  - Имя: имя аргумента.
  - Режим аргумента: режим добавляемого аргумента. Возможные значения:
    - IN (входной), это значение по умолчанию
    - OUT (выходной)
    - INOUT (входной и выходной)
    - VARIADIC (переменный)
  - Тип: тип данных аргумента.
  - Значение по умолчанию: значение по умолчанию добавляемого аргумента.
Нажмите ДОБАВИТЬ АРГУМЕНТ +, чтобы добавить аргумент.
- Функция возвращает таблицу: указывает на то, что функция будет возвращать таблицу. При активации переключателя заполните параметры возвращаемой таблицы:
  - Имя: имя возвращаемого значения.
  - Тип: тип данных возвращаемого значения.
Нажмите ДОБАВИТЬ ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ +, чтобы добавить возвращаемое значение.
- Тип возвращаемого значения: тип данных значения, которое будет возвращать создаваемая функция.
- Тело функции: тело функции на выбранном процедурном языке.
- Window: указывает на то, что создаваемая функция будет оконной.
- Optimizer: указывает атрибут, который информирует оптимизатор запросов о поведении функции. Возможные значения:
  - По умолчанию: значение по умолчанию — Volatile.
  - Immutable: характеристика Immutable (постоянная) показывает, что функция не может модифицировать базу данных и всегда возвращает один и тот же результат при определённых значениях аргументов; то есть, она не обращается к базе данных и не использует информацию, не переданную ей явно в списке аргументов. Если функция имеет такую характеристику, любой её вызов с аргументами-константами можно немедленно заменить значением функции.
  - Stable: характеристика Stable (стабильная) показывает, что функция не может модифицировать базу данных и в рамках одного сканирования таблицы она всегда возвращает один и тот же результат для определённых значений аргументов, но этот результат может быть разным в разных операторах SQL. Это подходящий выбор для функций, результаты которых зависят от содержимого базы данных и настраиваемых параметров (например, текущего часового пояса). (Но этот вариант не подходит для триггеров AFTER, желающих прочитать строки, изменённые текущей командой.) Также заметьте, что функции семейства current_timestamp также считаются стабильными, так как их результаты не меняются внутри транзакции.
  - Volatile: характеристика Volatile (изменчивая) показывает, что результат функции может меняться даже в рамках одного сканирования таблицы, так что её вызовы нельзя оптимизировать. Изменчивы в этом смысле относительно немногие функции баз данных, например: random(), currval() и timeofday(). Но заметьте, что любая функция с побочными эффектами должна быть классифицирована как изменчивая, даже если её результат вполне предсказуем, чтобы её вызовы не были соптимизированы; пример такой функции: setval().
- Strict: указывает на то, что функция всегда будет возвращать NULL, если в одном из аргументов был передан NULL.
- Leakproof: указывает на то, что функция не имеет побочных эффектов, поскольку не раскрывает информацию о своих аргументах, а только возвращает результат.
- Security: указывает на то, с какими правами будет вызываться и выполняться функция. Возможные значения:
  - По умолчанию: значение по умолчанию — Invoker.
  - Invoker: указывает на то, что функция будет выполняться с правами пользователя, вызвавшего её.
  - Definer: указывает на то, что функция будет выполняться с правами пользователя, владеющего ей.
- Parallel: указывает параметры вызова функции в параллельном режиме. Возможные значения:
  - По умолчанию: значение по умолчанию — Unsafe.
  - Unsafe: указывает на то, что создаваемую функцию нельзя будет выполнять в параллельном режиме и присутствие такой функции в операторе SQL приводит к выбору последовательного плана выполнения.
  - Restricted: указывает на то, что функцию можно выполнять в параллельном режиме, но только в ведущем процессе группы.
  - Safe: указывает на то, что функция безопасна для выполнения в параллельном режиме без ограничений, в том числе в параллельных рабочих процессах.
- ПОКАЗАТЬ SQL: отображает SQL-запрос создания функции с заданными параметрами.
Нажмите СОЗДАТЬ.

Функция будет создана и появится на вкладке ФУНКЦИИ страницы соответствующей схемы.

Просмотр функций

Чтобы просмотреть функции, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ФУНКЦИИ.

Отобразится таблица со следующими столбцами:

Имя: уникальное имя функции или процедуры. Функции или процедуры можно фильтровать и сортировать, нажимая на соответствующие значки.
Аргументы: передаваемые функции аргументы с типами данных.
Возвращаемые значения: возвращаемые функцией значения с типами данных.
Список контроля доступа: права доступа к функции.
Действия: действия, которые можно выполнить с функцией.

Редактирование функции

Чтобы отредактировать функцию, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ФУНКЦИИ.
Откроется таблица функций.
В столбце Действия нажмите Редактировать рядом с функцией, которую необходимо отредактировать.
Откроется окно редактирования функции.
В окне измените параметры функции.
Нажмите СОХРАНИТЬ.

Функция будет отредактирована, изменения отразятся в таблице.

Удаление функции

Чтобы удалить функцию, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ФУНКЦИИ.
В столбце Действия нажмите Удалить рядом с функцией, которую необходимо удалить.
Откроется окно удаления функции.
Нажмите УДАЛИТЬ.

Функция будет удалена.

Последовательности

Создание последовательности

Чтобы создать последовательность, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ПОСЛЕДОВАТЕЛЬНОСТИ.
В правом верхнем углу страницы нажмите СОЗДАТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ.
Откроется окно создания последовательности.
Укажите подробную информацию о новой последовательности (помеченные звёздочкой параметры являются обязательными):
1. Укажите уникальное Название последовательности.
2. (Необязательно) Активируйте переключатель Расширенные настройки в правом верхнем углу окна, чтобы задать дополнительные параметры:
  - Нежурналируемая: указывает на то, что изменения создаваемой последовательности не будут фиксироваться в WAL.
  - Cycle: указывает на то, что создаваемая последовательность будет зацикленной.
  - Тип данных: тип данных последовательности. Возможные значения:
    - По умолчанию: значение по умолчанию — Bigint.
    - Smallint
    - Integer
    - Bigint
  - Мин. значение: наименьшее число, которое будет генерировать последовательность.
  - Макс. значение: наибольшее число, которое будет генерировать последовательность.
  - Начало: начальное значение последовательности.
  - Шаг: число, которое будет добавляться к текущему значению последовательности для получения нового значения.
  - Кеш: количество чисел последовательности, которое будет выделяться и сохраняться в памяти для ускорения доступа к ним.
Нажмите СОЗДАТЬ.

Просмотр последовательностей

Чтобы просмотреть последовательности, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ПОСЛЕДОВАТЕЛЬНОСТИ.

Отобразится таблица со следующими столбцами:

Имя: уникальное имя последовательности. Последовательности можно фильтровать и сортировать, нажимая на соответствующие значки.
Владелец: владелец последовательности. Владельцев можно фильтровать и сортировать, нажимая на соответствующие значки.
Тип данных: тип данных значений последовательности.
Начало: начальное значение последовательности. Значения можно сортировать.
Мин. значение: минимально возможное значение последовательности. Значения можно сортировать.
Макс. значение: максимально возможное значение последовательности. Значения можно сортировать.
Шаг: шаг изменения значений последовательности. Значения можно сортировать.
Cycle: указывает на то, что последовательность является зацикленной и при достижении предела начинается заново. Значения можно сортировать.
Кеш: количество чисел последовательности, которое будет выделяться и сохраняться в памяти для ускорения доступа к ним.
Last_value: последнее значение последовательности.
Действия: действия, которые можно выполнить с последовательностью:
- Редактировать: редактирование параметров последовательности.
- Удалить: удаление последовательности.

Редактирование последовательности

Чтобы отредактировать последовательность, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ПОСЛЕДОВАТЕЛЬНОСТИ.
Откроется таблица последовательностей.
В столбце Действия нажмите Редактировать рядом с последовательностью, которую необходимо отредактировать.
Откроется окно редактирования последовательности.
В окне измените параметры последовательности.
Нажмите СОХРАНИТЬ.

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

Удаление последовательности

Чтобы удалить последовательность, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
Выберите схему.
Откроется страница выбранной схемы.
Перейдите на вкладку ПОСЛЕДОВАТЕЛЬНОСТИ.
В столбце Действия нажмите Удалить рядом с последовательностью, которую необходимо удалить.
Откроется окно удаления последовательности.
Нажмите УДАЛИТЬ. Чтобы удалить все зависимые от последовательности объекты, активируйте переключатель Каскадное удаление.

Последовательность будет удалена.

Метрики

Ключевые показатели работы системы можно отслеживать с помощью графиков на основе метрик, собираемых pgpro-otel-collector.

Для работы графиков требуется интеграция Postgres Pro Enterprise Manager с хранилищем метрик. По умолчанию Postgres Pro Enterprise Manager использует встроенное хранилище, расположенное в базе данных репозитория.

Кроме того, доступны SQL-метрики на основе статистик планирования и выполнения SQL–операторов, собираемые расширением pgpro_stats.

Основные метрики

Просмотр основных метрик

Чтобы просмотреть основные метрики, выполните следующие действия:

В левом верхнем углу нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Инфраструктура → Экземпляры.
Отобразится таблица Экземпляры.
Нажмите на имя экземпляра.
Отобразится страница Обзор.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Метрики.
Вы будете автоматически перенаправлены на страницу Основные метрики. Отобразятся доступные графики.

Графики по основным метрикам можно фильтровать по времени. Чтобы отобразить метрики за конкретный период времени, выберите один из периодов, доступных по умолчанию, например Последний час. Выпадающий список с периодами доступен в левом верхнем углу страницы. Чтобы указать другой период, выполните следующие действия:

Нажмите на период времени Последние 15 минут, который отображён по умолчанию.
Из выпадающего списка выберите Выбрать период и введите период времени.
Нажмите ПРИМЕНИТЬ.

Доступные графики

Чтобы скрыть или отобразить графики, нажмите ГРАФИКИ и выберите нужные. Доступны следующие графики:

WAL Archiver
Количество заархивированных WAL-сегментов.
Vacuum workers.
Количество операций очистки.
Background Writes: Buffers
Объём фоновой записи из общего кеша на диск.
Background Writes: Maxwritten/Fsync
График отображает динамику двух метрик:
- maxwritten: количество случаев, когда процессу фоновой записи пришлось остановить запись по достижению лимита.
- fsync: количество случаев вынужденного вызова fsync.
Background Writes: Checkpoints
Количество контрольных точек.
Background Writes: Checkpoints Write/Sync
Время, затраченное на запись и синхронизацию блоков во время выполнения контрольных точек.
Instance: Connections
Соединения, установленные к экземпляру СУБД, и их состояние.
Instance: Blocks rate
Утилизация общего кеша экземпляра СУБД: количество попаданий в кеш и количество промахов, приведших к необходимости чтения данных с диска.
Instance: Transactions rate
Транзакционная активность в экземпляре СУБД.
Instance: Events
События в экземпляре СУБД: взаимоблокировки, конфликты репликации, ошибки проверки контрольных сумм.
Instance: Tuples
Рабочая нагрузка, выраженная в обработке строк: количество прочитанных, вставленных, обновлённых и удалённых строк.
Instance: Cache hit ratio
Рабочая нагрузка на общий кеш: выражает долю попаданий в кеш относительно всех обращений к общему кешу.
Instance: Temp bytes written
Объём записи во временные файлы.
Instance: Temp files
Количество временных файлов, записанных экземпляром СУБД.
Instance: Locks
Динамика блокировок.
WAL: Written bytes
Объём записи в WAL-журнал.
System: Load Average
Средняя нагрузка на сервер.
System: Memory Usage
Утилизация памяти сервера.
System: Swap Usage
Утилизация области подкачки в системе.
System: Processes
Состояние процессов в системе.

SQL-метрики

Просмотр SQL-метрик

Чтобы просмотреть SQL-метрики, выполните следующие действия:

В левом верхнем углу нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Инфраструктура → Экземпляры.
Отобразится таблица Экземпляры.
Нажмите на имя экземпляра.
Отобразится страница Обзор.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Метрики → SQL-метрики.
Отобразится таблица с метриками, которая содержит следующие столбцы:
- ID: идентификатор метрики.
- Имя: имя метрики.
- База данных: база данных, в которой выполняется запрос.
- Пользователь: системная роль, от имени которой будет выполняться запрос.
- Интервал: частота сбора данных.
- Последнее значение: результат последнего выполненного запроса в формате JSON.
- Получено: время последнего обновления данных.
- Запрос: SQL-запрос, по которому вычисляется метрика.
- Действия: действия, которые можно выполнить с метрикой. Доступные действия:
  - Редактировать: редактирование параметров метрики.
  - Удалить: удаление метрики.
Чтобы просмотреть историю собранных данных, нажмите на имя метрики.
Отобразится таблица с историей значений, для каждого из которых указано время сбора данных.

Создание SQL-метрики

Чтобы создать SQL-метрику, выполните следующие действия:

В левом верхнем углу нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Инфраструктура → Экземпляры.
Отобразится таблица Экземпляры.
Нажмите на имя экземпляра.
Отобразится страница Обзор.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Метрики → SQL-метрики.
В правом верхнем углу страницы нажмите ДОБАВИТЬ SQL-МЕТРИКИ.
Откроется окно СОЗДАНИЕ SQL-МЕТРИКИ.
Укажите подробную информацию о новой SQL-метрике (помеченные звёздочкой параметры являются обязательными):
- Имя: имя метрики.
- База данных: база данных, в которой будет выполняться запрос.
- Пользователь: системная роль, от имени которой будет выполняться запрос.
- Интервал сбора: частота сбора данных.
- Запрос: SQL-запрос, по которому вычисляется метрика.
- Требуется перезагрузка экземпляра: указывает, следует ли перезагрузить экземпляр. По умолчанию этот переключатель деактивирован.
Нажмите СОХРАНИТЬ.

SQL-метрика будет создана и добавлена в таблицу метрик.

Редактирование SQL-метрики

Чтобы отредактировать SQL-метрику, выполните следующие действия:

В левом верхнем углу нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Инфраструктура → Экземпляры.
Отобразится таблица Экземпляры.
Нажмите на имя экземпляра.
Отобразится страница Обзор.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Метрики → SQL-метрики.
В столбце Действия нажмите Редактировать рядом с SQL-метрикой, которую необходимо отредактировать.
Откроется окно редактирования SQL-метрики.
В окне измените параметры таблицы.
Нажмите СОХРАНИТЬ.

SQL-метрика будет отредактирована.

Удаление SQL-метрики

Чтобы удалить SQL-метрику, выполните следующие действия:

В левом верхнем углу нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Инфраструктура → Экземпляры.
Отобразится таблица Экземпляры.
Нажмите на имя экземпляра.
Отобразится страница Обзор.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу Метрики → SQL-метрики.
В столбце Действия нажмите Удалить рядом с SQL-метрикой, которую необходимо удалить.
Откроется окно удаления SQL-метрики.
Нажмите УДАЛИТЬ.
SQL-метрика будет удалена.

Активность

На странице представлена текущая активность экземпляра СУБД. Для получения данных используются несколько источников и информация разнесена на несколько вкладок:

Сессии - содержит информацию об установленных соединениях (сессиях) и фоновых процессах экземпляра на основе представления pg_stat_activity.
Очистка - содержит информацию о прогрессе выполнения операций очистки и автоочистки (VACUUM и autovacuum) на основе представления pg_stat_progress_vacuum.
Сбор статистики - содержит информацию о прогрессе выполнения операций сбора статистики для планировщика (ANALYZE) на основе представления pg_stat_progress_analyze.
Кластеризация - содержит информацию о прогрессе выполнения пересборки таблиц по индексу (CLUSTER), также включает информацию о прогрессе выполнения полной очистки (VACUUM FULL) на основе представления pg_stat_progress_cluster.
Индексация - содержит информацию о прогрессе выполнения операций создания и перестройки индексов (CREATE INDEX, REINDEX) на основе представления pg_stat_progress_create_index.
Базовое копирование - содержит информацию о прогрессе выполнения операций базового копирования (обычно это резервное копирование) на основе представления pg_stat_progress_basebackup.
Копирование - содержит информацию о прогрессе выполнения операций копирования, выполняющихся с помощью команд COPY, на основе представления pg_stat_progress_copy.
Дерево блокировок - содержит информацию об активностях с акцентом на блокировках - кто является источником блокировок и кто является заблокированным.

Для получения подробной информации следует перейти на целевую вкладку.

Активность сессий

На странице представлена текущая активность экземпляра СУБД - установленные пользовательские сеансы и фоновые процессы экземпляра. Информация об активности основана на данных представления pg_stat_activity.

Основная таблица представлена большим количеством полей. Набор полей можно регулировать, а отдельные колонки можно показать или скрыть с помощью кнопки "Редактировать".

Каждая строка в таблице содержит данные об активности отдельной сессии, которые представлены следующими полями:

query - текст запроса, который выполняется в данный момент или выполнялся последним в этой сессии.
query_start - время начала выполнения запроса.
state - состояние сессии:
- idle - сессия находится в бездействии и ожидает получения запроса от клиента.
- active - сессия находится в активном состоянии и выполняет обработку запроса от клиента.
- idle in transaction - в сессии открыта транзакция, которая находится в бездействии и ожидает получения запроса от клиента.
- idle in transaction (aborted) - в сессии открыта транзакция и в ней произошла ошибка, что привело к откату, но сама транзакция при этом не закрыта.
- fastpath function call - выполнение функции в режиме fastpath (этот режим считается устаревшим и не рекомендуется к использованию).
- disabled - состояние, указывающее на то, что отслеживание состояний сессий выключено в настройках экземпляра.
wait_event_type - тип события ожидания; указывает на то, что выполнение запроса приостановлено и ожидает освобождения ресурса.
wait_event - событие ожиданий; указывает на то, что выполнение запроса приостановлено и ожидает освобождения ресурса.
backend_type - определяет тип процесса: клиентская сессия или фоновый процесс экземпляра.
database - имя базы данных, к которой установлено соединение.
datid - идентификатор базы данных, к которой установлено соединение.
pid - идентификатор процесса операционной системы, который обслуживает сессию.
leader_pid - идентификатор процесса операционной системы для процесса-лидера в группе параллельного выполнения запроса.
usesysid - идентификатор пользователя СУБД, от имени которого установлена сессия.
username - имя пользователя СУБД, от имени которого установлена сессия.
application_name - имя приложения, которое установило соединение.
client_addr - сетевой адрес клиента, откуда установлено соединение.
client_hostname - сетевое имя сервера, откуда установлено соединение.
client_port - номер сетевого порта, с которого установлено соединение.
backend_start - время, когда было установлено соединение.
xact_start - время начала текущей транзакции.
state_change - время последнего изменения состояния сессии.
backend_xid - идентификатор транзакции верхнего уровня сессии.
backend_xmin - текущая граница горизонта видимости этой сессии.
query_id - идентификатор запроса.
query_duration_seconds - продолжительность выполнения запроса.
transaction_duration_seconds - продолжительность выполнения транзакции.

Действия

Для сессии в зависимости от состояния возможны дополнительные действия в поле "Действия":

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

Прогресс выполнения очистки

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

Каждая строка в таблице содержит данные о прогрессе выполнения отдельной операции очистки, которые представлены следующими полями:

PID - идентификатор процесса операционной системы.
State - состояние процесса на основе pg_stat_activity.state.
Wait event - тип и событие ожидания на основе pg_stat_activity.wait_event_type и pg_stat_activity.wait_event.
Phase - стадия выполнения очистки.
Database - база данных, в которой выполняется очистка.
User - имя пользователя, от имени которого выполняется очистка.
Table - имя таблицы, для которой выполняется очистка. Значение может содержать числовой идентификатор в случае, если разыменование невозможно.
Query - текст запроса на основе pg_stat_activity.query.
Query duration - продолжительность выполнения очистки.
Heap size - размер таблицы.
Total size - полный размер таблицы, включая индексы.
Scanned, % - процент отсканированных данных таблицы.
- Size - размер отсканированных данных таблицы.
Vacuumed, % - процент данных таблицы, для которых была выполнена очистка.
- Size - объем таблицы, для которого уже была выполнена очистка.
Index vacuum - количество индексов, для которых была выполнена очистка.
Memory usage, % - объем использования памяти, предназначенной для хранения указателей на устаревшие версии строк (autovacuum_work_mem, maintenance_work_mem).

Действия

Для каждого процесса возможны дополнительные действия в поле "Действия":

Отмена выполнения запроса - позволяет отменить выполнение процесса очистки, при этом сессия продолжит свое существование.
Принудительное завершение сессии - позволяет принудительно завершить процесс очистки и разорвать соединение с клиентом.

Прогресс выполнения сбора статистики планировщика

На странице представлена прогресс выполнения операций по сбору статистики планировщика. Информация основана на данных представления pg_stat_progress_analyze.

Каждая строка в таблице содержит данные о прогрессе выполнения отдельной операции сбора, которые представлены следующими полями:

PID - идентификатор процесса операционной системы.
State - состояние процесса на основе pg_stat_activity.state.
Wait event - тип и событие ожидания на основе pg_stat_activity.wait_event_type и pg_stat_activity.wait_event.
Phase - стадия выполнения сбора статистики.
Database - база данных, в которой выполняется сбор статистики.
User - имя пользователя, от имени которого выполняется сбор статистики.
Table - имя таблицы, для которой выполняется сбор статистики. Значение может содержать числовой идентификатор в случае, если разыменование невозможно.
Query - текст запроса на основе pg_stat_activity.query.
Query duration - продолжительность выполнения сбора статистики.
Current child table - в случае сбора с партиционированных таблиц указывает на текущую таблицу, с которой выполняется сбор.
Child tables done - в случае сбора с партиционированных таблиц указывает количество таблиц, с которых был выполнен сбор.
Child tables total - в случае сбора с партиционированных таблиц указывает общее количество таблиц, с которых необходимо выполнить сбор.
Scanned, % - процент просканированных данных.
Sample size - размер сэмпла, необходимый для сканирования.
Stat total - общее количество расширенной статистики, необходимой для сбора.
Stat computed - количество вычисленной расширенной статистики.

Действия

Для каждого процесса возможны дополнительные действия в поле "Действия":

Отмена выполнения запроса - позволяет отменить выполнение процесса сбора статистики, при этом сессия продолжит свое существование.
Принудительное завершение сессии - позволяет принудительно завершить процесс сбора статистики и разорвать соединение с клиентом.

Прогресс выполнения кластеризации

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

Каждая строка в таблице содержит данные о прогрессе выполнения кластеризации, которые представлены следующими полями:

PID - идентификатор процесса операционной системы.
State - состояние процесса на основе pg_stat_activity.state.
Wait event - тип и событие ожидания на основе pg_stat_activity.wait_event_type и pg_stat_activity.wait_event.
Phase - стадия выполнения кластеризации.
Database - база данных, в которой выполняется кластеризация.
User - имя пользователя, от имени которого выполняется кластеризация.
Table - имя таблицы, для которой выполняется кластеризация. Значение может содержать числовой идентификатор в случае, если разыменование невозможно.
Index - целевой индекс, на основе которого идет кластеризация.
Query - текст запроса на основе pg_stat_activity.query.
Query duration - продолжительность выполнения кластеризации.
Blocked totals - общее количество сессий, заблокированных процессом кластеризации.
Heap scanned, % - процент просканированных данных.
Heap total - общий размер данных.
Scanned - общий размер просканированных данных.
Tuples scanned - общее количество просканированных строк.
Tuples written - общее количество записанных строк.

Действия

Для каждого процесса возможны дополнительные действия в поле "Действия":

Отмена выполнения запроса - позволяет отменить выполнение процесса кластеризации, при этом сессия продолжит свое существование.
Принудительное завершение сессии - позволяет принудительно завершить процесс кластеризации и разорвать соединение с клиентом.

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

На странице представлена прогресс выполнения операций по переиндексации и/или созданию индексов. Информация основана на данных представления pg_stat_progress_create_index.

Каждая строка в таблице содержит данные о прогрессе выполнения переиндексаций и создания индексов, которые представлены следующими полями:

PID - идентификатор процесса операционной системы.
State - состояние процесса на основе pg_stat_activity.state.
Wait event - тип и событие ожидания на основе pg_stat_activity.wait_event_type и pg_stat_activity.wait_event.
Phase - стадия выполнения операции.
Database - база данных, в которой выполняется операции.
User - имя пользователя, от имени которого выполняется операция.
Table - имя таблицы, для которой выполняется операция. Значение может содержать числовой идентификатор в случае, если разыменование невозможно.
Index - целевой индекс, на основе которого идет операция. Значение может содержать числовой идентификатор в случае, если разыменование невозможно.
Query - текст запроса на основе pg_stat_activity.query.
Query duration - продолжительность выполнения операции.
Done, % - процент выполнения операции.
- Total size - общий размер данных, необходимый для обработки в текущей фазе.
- Done size - общий размер обработанных данных в текущей фазе.
Tuples done, % - процент обработанных строк в текущей фазе.
- Total size - общее количество строк, которые требуется обработать в текущей фазе.
- Done size - общее количество строк, обработанных в текущей фазе.
Lockers - данных о заблокированных процессах:
- Done - число процессов, ожидание которых уже завершено.
- Total - общее число процессов, потребовавших ожидания, если таковые имеются.
- PID - идентификатор процесса, удерживающего конфликтующую блокировку в данный момент.
Partitions done, % - процент партиционированных таблиц, в которых также требуется выполнить операцию (если таковые имеются).
- Total - общее количество таблиц
- Done - количество обработанных таблиц.

Действия

Для каждого процесса возможны дополнительные действия в поле "Действия":

Отмена выполнения запроса - позволяет отменить выполнение процесса, выполняющего операцию, при этом сессия продолжит свое существование.
Принудительное завершение сессии - позволяет принудительно завершить процесс, выполняющий операцию и разорвать соединение с клиентом.

Прогресс выполнения базового копирования

На странице представлена прогресс выполнения операций базового копирования. Информация основана на данных представления pg_stat_progress_basebackup.

Каждая строка в таблице содержит данные о прогрессе выполнения базового копирования, которые представлены следующими полями:

PID - идентификатор процесса операционной системы.
State - состояние процесса на основе pg_stat_activity.state.
Wait event - тип и событие ожидания на основе pg_stat_activity.wait_event_type и pg_stat_activity.wait_event.
Phase - стадия выполнения операции.
Client address - адрес клиента, который инициировал базовое копирование.
Backend duration - продолжительность выполнения серверного процесса, который осуществляет базовое копирование.
Started time - время создания серверного процесса и, соответственно, время начала базового копирования.
Sent, % - процент отправленных клиенту данных.
- Total size - общий размер данных к отправке.
- Sent size - общий размер уже отправленных данных.
Tablespaces total - общее количество табличных пространств к обработке.
Tablespaces streamed - общее количество обработанных табличных пространств.

Действия

Для каждого процесса возможны дополнительные действия в поле "Действия":

Отмена выполнения запроса - позволяет отменить выполнение процесса, выполняющего операцию, при этом сессия продолжит свое существование.
Принудительное завершение сессии - позволяет принудительно завершить процесс, выполняющий операцию, и разорвать соединение с клиентом.

Прогресс выполнения операций копирования

На странице представлена прогресс выполнения операций копирования. Информация основана на данных представления pg_stat_progress_copy.

Каждая строка в таблице содержит данные о прогрессе выполнения операции копирования и представлены следующими полями:

PID - идентификатор процесса операционной системы.
State - состояние процесса на основе pg_stat_activity.state.
Wait event - тип и событие ожидание на основе pg_stat_activity.wait_event_type и pg_stat_activity.wait_event.
Database - база данных, в которой выполняется операции.
User - имя пользователя, от имени которого выполняется операция.
Table - имя таблицы, для которой выполняется операция. Значение может содержать числовой идентификатор в случае если разыменование невозможно.
Query - текст запроса на основе pg_stat_activity.query.
Query duration - продолжительность выполнения операции.
Table size - размер таблицы, для которой осуществляется копирование.
Table tuples total - общее количество строк в целевой таблице.
- Tuples processed - количество обработанных строк.
- Tuples excluded - количестве пропущенных строк.
Source file size - размер исходного файла если имеется.
Done, % - процент выполнения операции копирования.
- Processed - объем обработанных данных.
Command - команда копирования.
Command type - тип команды копирования.

Действия

Для каждого процесса возможны дополнительные действия в поле "Действия":

Отмена выполнения запроса - позволяет отменить выполнение процесса, выполняющего операцию, при этом сессия продолжит свое существование.
Принудительное завершение сессии - позволяет принудительно завершить процесс, выполняющий операцию, и разорвать соединение с клиентом.

SQL-статистика

Postgres Pro Enterprise Manager позволяет просматривать статистику выполнения SQL-операторов на основе данных расширений pg_stat_statements и pgpro_stats. Для корректной работы сбора SQL-статистики в экземпляре СУБД должно быть установлено и настроено одно из этих расширений.

Чтобы просмотреть SQL-статистику, выполните следующие действия:

В левом верхнем углу любой страницы нажмите на логотип Postgres Pro Enterprise Manager.
Отобразится страница Главная.
В разделе УПРАВЛЕНИЕ левой панели перейдите на страницу Базы данных.
Отобразится таблица Базы данных.
Выберите базу данных.
Откроется страница выбранной базы данных.
В разделе ДЕТАЛИ ЭКЗЕМПЛЯРА левой панели перейдите на страницу SQL статистика.

Отобразится таблица со следующими столбцами:

ID оператора: неуникальный хеш-код оператора. Может совпадать с другими операторами, выполняющимися в других базах данных или от имени других пользователей. Операторы можно фильтровать, нажимая на соответствующий значок. Столбец содержит дополнительную информацию:
- ID плана: неуникальный хеш-код плана. Может совпадать с хеш-кодами других планов по операторам, которые выполнялись в других базах данных или от имени других пользователей. ID плана доступен только для редакции Postgres Pro Enterprise.
- Оператор верх. уровня: указывает на уровень выполнения оператора. Для отображения этой информации необходимо задать значение top для параметров pg_stat_statements.track или pgpro_stats.track. Значения можно фильтровать, нажимая на соответствующий значок. Возможные значения:
  - true: оператор выполнялся на верхнем уровне.
  - false: оператор был вложен в процедуру или функцию.

ПРИМЕЧАНИЕ
В столбце ID оператора можно просмотреть код запроса и плана оператора. Для этого нажмите Раскрыть . Чтобы скрыть всплывающее окно, нажмите Свернуть . Код плана оператора отображается только для редакции Postgres Pro Enterprise.

База данных: база данных экземпляра, в которой выполнялся оператор. БД можно фильтровать и сортировать, нажимая на соответствующие значки.
Пользователь: имя пользователя, выполнявшего оператор. Пользователей можно фильтровать и сортировать, нажимая на соответствующие значки.
Выполнения, шт.: общее количество выполнений оператора. Столбец содержит дополнительную информацию:
- Строки, шт.: общее количество строк, полученных или затронутых оператором. Можно выполнять сортировку, нажимая на соответствующий значок.
Время выполнения, мс: общее время, затраченное на выполнение оператора (в миллисекундах). Можно выполнять сортировку, нажимая на соответствующий значок. Столбец содержит дополнительную информацию:
- Макс.: максимальное время, затраченное на выполнение оператора.
- Мин.: минимальное время, затраченное на выполнение оператора.
- Среднее: среднее время, затраченное на выполнение оператора.
- Откл.: стандартное отклонение времени, затраченного на выполнение оператора.
Время планирования, мс: общее время, затраченное на планирование оператора (в миллисекундах). Можно выполнять сортировку, нажимая на соответствующий значок. Для отображения этой информации необходимо задать значение on для параметров pg_stat_statements.track_planning или pgpro_stats.track_planning. В противном случае отобразится значение 0. Столбец содержит дополнительную информацию:
- Макс.: максимальное время, затраченное на планирование оператора.
- Мин.: минимальное время, затраченное на планирование оператора.
- Среднее: среднее время, затраченное на планирование оператора.
- Откл.: стандартное отклонение времени, затраченного на планирование оператора.
Запись и чтение блоков, мс: общее время, затраченное оператором на чтение и запись блоков файлов данных (в миллисекундах). Можно выполнять сортировку, нажимая на соответствующий значок. Для отображения этой информации необходимо включить параметр track_io_timing. В противном случае отобразится значение 0. Столбец содержит дополнительную информацию:
- Запись: время, затраченное на запись.
- Чтение: время, затраченное на чтение.
Временные блоки, шт.: общее число блоков, затронутых оператором при работе с временными файлами.
- Записаны: количество записанных блоков. Можно выполнять сортировку, нажимая на соответствующий значок.
- Прочитаны: количество прочитанных блоков. Можно выполнять сортировку, нажимая на соответствующий значок.
Объём WAL, Б: общий объём WAL в байтах, сгенерированный при выполнении оператора. Столбец содержит дополнительную информацию:
- Записи, шт.: общее число записей WAL, сгенерированных при выполнении оператора. Можно выполнять сортировку, нажимая на соответствующий значок.
- Образы, шт.: общее число образов полных страниц в WAL, сгенерированных при выполнении оператора. Можно выполнять сортировку, нажимая на соответствующий значок.
Блоки в общем кеше, шт.: общее число попаданий в кеш разделяемых блоков для оператора.
- Прочитаны: общее число разделяемых блоков, прочитанных оператором.
- Загрязнены: общее число разделяемых блоков, «загрязнённых» оператором.
- Записаны: общее число разделяемых блоков, записанных оператором.
Блоки в локальных кешах, шт.: общее число попаданий в кеш локальных блоков для оператора.
- Прочитаны: общее число локальных блоков, прочитанных оператором.
- Загрязнены: общее число локальных блоков, «загрязнённых» оператором.
- Записаны: общее число локальных блоков, записанных оператором.
Подробнее: нажмите Подробнее , чтобы просмотреть информацию о конкретном операторе.

По умолчанию отображаемая статистика отсортирована по общему времени выполнения оператора. На одной странице отображается 50 строк. Чтобы перейти на следующую страницу, воспользуйтесь кнопками постраничной навигации в правом нижнем углу страницы. Кроме того, можно изменить отображаемые столбцы таблицы. Для этого нажмите РЕДАКТИРОВАТЬ в правом верхнем углу таблицы и активируйте или деактивируйте переключатели.

Отображаемая статистика запрашивается через агента Postgres Pro Enterprise Manager, который работает с экземпляром СУБД. По этой причине скорость получения статистики зависит от двух факторов:

Сетевой связности между менеджером и агентом Postgres Pro Enterprise Manager, который работает с экземпляром.
Объёма передаваемых данных, который может также косвенно влиять на производительность экземпляра СУБД.

Учитывая накопительную природу статистики, полученный снимок статистики может со временем отличаться от фактической статистики экземпляра СУБД. Чтобы обновить снимок статистики, нажмите Сбросить в правом верхнем углу страницы.

Журнал сообщений

Страница предназначена для работы с журналами сообщений текущего экземпляра СУБД.

Примечание: Для нормальной работы с журналами в PPEM должна быть настроена интеграция с pgpro-otel-collector.

Страница полностью повторяет функциональность раздела "Журнал сообщений" основного меню в Панели навигации. Небольшим отличием является то, что при входе на страницу, поиск сообщений выполняется только по сообщениям текущего экземпляра СУБД (фильтр сообщений по экземплярам отсутствует).

Подробная информация доступна на странице "Журнал сообщений".

Резервные копии

Параметры экземпляра СУБД

На странице представлены возможности по просмотру параметров экземпляра СУБД и их настройке.

Просмотр параметров

Обзор настроек доступен через основную таблицу, которая состоит из следующих полей:

Параметр - содержит название параметра и его краткое описание. Если параметр определен в конкретном файле конфигурации, рядом будет указан путь к файлу и номер строки, где размещен параметр, статус применения и наличие ошибок (если есть). Слева от имени параметра может находиться индикатор-подсказка, указывающий на необходимость перезапуска экземпляра в случае изменения параметра.
Значение - содержит значение параметра и доступно для изменения. В случае ввода нового значения справа отобразится кнопка сброса в предыдущее значение.
Дефолтное значение - содержит значение параметра по умолчанию.
Источник - содержит тип источника откуда взят параметр:
- default - значение по умолчанию.
- configuration file - значение задано в конфигурационном файле.
- override - значение переопределено на этапе инициализации экземпляра.

Для удобства поиска и просмотра параметров в верхней части страницы размещены: фильтр по категории (слева) и фильтр-поиск по названию параметров (справа). Фильтр по категории позволяет выбрать отдельную категорию и отобразить только те параметры, которые входят в нее. Фильтр-поиск по названию параметров позволяет искать по имени отдельные параметры.

Сверху справа есть переключатель "Показать все / Показать не дефолтные", которые регулирует отображение параметров в основной таблице. При переходе на страницу отображаются все параметры, при переключении в "Показать не дефолтные" все параметры по умолчанию будут скрыты и останутся только те, у которых источник не является default (то есть заданы явно).

Изменение параметров

Изменение возможно как для одного, так и для нескольких параметров. Для этого нужно в поле "Значение" ввести новое значение параметра. После ввода нового значения справа появится кнопка сброса, а на основных кнопках сброса и применения настроек, расположенных внизу справа страницы, появятся счетчики которые подсчитывают общее количество измененных параметров. После того, как новые значения параметров введены, их можно применить, нажав на кнопку "Сохранить" (в нижней правой части страницы). В случае, если параметры не требуют перезапуска экземпляра СУБД, то применение будет выполнено сразу же. При необходимости перезапуска экземпляра будет открыта форма подтверждения дальнейших действий. В форме будут перечислены параметры, их текущие и новые значения и действие, которое нужно выбрать и затем подтвердить:

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

После выбора действия нужно нажать кнопку "Применить". В случае необходимости перезапуска экземпляра откроется отдельное подтверждение перезапуска. В форме будут доступны кнопки как подтверждения, так и отказа. После подтверждения будет выполнено применение настроек и перезапуск экземпляра.

Внимание: При перезапуске экземпляра выполняется завершение всех сеансов с экземпляром СУБД. Также, в зависимости от некоторых настроек и нагрузки на экземпляр, продолжительность перезапуска может занимать продолжительное время (выполнение контрольной точки). Рекомендуется очень аккуратно подходить к вопросу перезапуска экземпляра, особенно в производственных окружениях с высокими требованиями к времени простоя СУБД.

Детали реализации

Для управления параметрами конфигурации используется интерфейс команды ALTER SYSTEM. Команда подразумевает работу с настройками через изменение файла postgresql.auto.conf. Поэтому может возникнуть ситуация, когда параметр был задан в основном файле конфигурации, например postgresql.conf, но затем средствами PPEM был изменен и появился в postgresql.auto.conf. В интерфейсе PPEM будет отображено, что настройка присутствует в двух файлах конфигурации и это нормальная ситуация - значения параметров из postgresql.auto.conf имеют больший приоритет над параметрами, указанными в других файлах.

Для применения параметров (без перезапуска экземпляра) используется функция pg_reload_conf().

Профайлер

Раздел "Профайлер" предоставляет интерфейс к модулю pgpro_pwr и предназначен для выявления наиболее ресурсоемких операций в базе данных. Подробная информация о модуле pgpro_pwr и особенностях его использования представлена в документации на сайте Postgres Pro.

На обзорной странице раздела "Профайлер" доступен просмотр предустановленных системных графиков, отражающих различные аспекты работы базы данных и помогающие администраторам отслеживать производительность, обнаруживать проблемы и принимать решения по оптимизации работы БД. В верхней части страницы представлен интерфейс выбора базы данных, сервера и указания интересующего временного периода. Кнопка "Выбрать" активируется, когда все элементы интерфейса заполнены. После нажатия на кнопку "Выбрать" на графиках будет отображена доступная информация.

На странице представлены следующие графики:

PostgreSql Instance: tuples

График показывает различные операции с кортежами (tuples) в БД, такие как вставка, обновление, удаление, а также выборка и возврат. График предоставляет важную информацию о динамике работы базы данных, которая позволяет администраторам оценивать нагрузку на систему и выявлять возможные проблемы с производительностью, анализировать эффективность использования индексов и принимать решения по их оптимизации, выявлять потенциальные узкие места в работе системы, связанные с вставкой, обновлением, удалением и выборкой данных, а также планировать ресурса и масштабирование системы на основе данных о количестве операций с кортежами.

tuples_inserted - количество кортежей, которые были вставлены в таблицы базы данных за определенный период времени. Помогает понять объем новых данных, добавляемых в БД. Частые вставки могут указывать на необходимость оптимизации индексов или конфигурации сервера для лучшей производительности.
tuples_updated - количество кортежей, которые были обновлены за определенный период времени. Высокий уровень обновлений может указывать на частые изменения данных, что может потребовать оптимизации запросов или пересмотра логики работы приложения.
tuples_deleted - количество кортежей, которые были удалены за определенный период времени. Помогает отследить частые удаления и необходимость выполнения операций вакуума для поддержания производительности.
tuples_fetched - количество кортежей, которые были выбраны из индексов за определенный период времени. С помощью этого показателя можно оценить эффективность использования индексов. Сравнивая значения tuples_fetched и tuples_returned можно оценить эффективность использования индексов.
tuples_returned - общее количество кортежей, которые были возвращены запросами за определенный период времени.

PostgreSql bgwriter buffers

Этот график показывает количество блоков данных, которые были записаны фоновым процессом записи bgwriter. Он также отображает различные категории блоков данных, которые были записаны в разные моменты времени, а также количество выделенных блоков данных. График предоставляет важную информацию о работе фонового процесса записи и позволяет администраторам оценивать нагрузку на дисковую подсистему, анализировать эффективность фонового процесса записи, отслеживать использование памяти и выявлть потенциальные проблемы.

checkpoints buffers written - количество блоков данных, записанных во время выполнения контрольных точек. Этот показатель позволяет понять, как много данных было записано на диск во время контрольной точки.
background buffers written - количество блоков данных, записанных фоновым процессом bgwriter. Этот показатель помогает оценить эффективность работы bgwriter и его влияние на общую производительность системы.
backend buffers written - количество блоков данных, записанных самим обслуживающим процессом. Высокие значения могут указывать на проблемы с производительностью, такие как недостаточное использование оперативной памяти или неоптимальные параметры конфигурации.
numbers of buffers allocated - количество новых блоков данных, выделенных для хранения. Показатель отражает динамику использования памяти в системе и помогает принимать решения о необходимости пересмотра параметров конфигурации.

PostgreSql bgwriter write/sync

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

bgwriter interrupts - количество раз, когда фоновый процесс записи останавливал сброс грязных страниц на диск из-за того, что записал слишком много блоков данных.
backend fsync count - количество раз, когда обслуживающему процессу пришлось выполнить fsync самостоятельно (обычно фоновый процесс записи сам обрабатывает эти вызовы, даже когда обслуживающий процесс выполняет запись самостоятельно). Высокие значения этого показателя могут указывать на необходимость оптимизации работы фонового процесса записи или увеличения ресурсов сервера для снижения нагрузки на основные процессы.

PostgreSql checkpoints count

График показывает количество контрольных точек, которые были выполнены за определенный период времени в БД. Он также отображает различные категории контрольных точек: запланированные и выполненные по запросу.

scheduled checkpoints - количество контрольных точек, выполненных по запланированному расписанию. Запланированные контрольные точки выполняются через фиксированные интервалы времени, определяемые параметрами конфигурации. Этот показатель позволяет понять, насколько часто система выполняет регулярные контрольные точки для обеспечения целостности данных.
requested checkpoints - количество контрольных точек, выполненных по запросу. Выполнение контрольных точек по запросу происходит не по расписанию, а, например, в ответ на определенные события или команды. Этот показатель помогает выявить ситуации, когда система сталкивается с необходимостью выполнить внеплановую запись на диск. Частое выполнение внеплановых контрольных точек может указывать на проблемы с производительностью.

PostgreSql checkpoints write/sync

График показывает время выполнения операций записи и синхронизации данных во время выполнения контрольных точек в БД. Он отображает два основных компонента: время записи (checkpoint write time) и время синхронизации (checkpoint sync time), позволяющие оценить эффективность и влияние контрольных точек на общую производительность системы. График предоставляет важную информацию о времени выполнения контрольных точек и позволяет администраторам оценивать влияние контрольных точек на производительность, анализировать эффективность работы фонового процесса записи, отслеживать время синхронизации данных, а также выявлять потенциальные проблемы.

checkpoint write time - общее время, затраченное на запись данных во время выполнения контрольной точки. Высокие значения могут указывать на значительную нагрузку на дисковую подсистему или неэффективное использование памяти.
checkpoint sync time - общее время, затраченное на синхронизацию данных с диском во время выполнения контрольной точки. Синхронизация данных с диском гарантирует, что данные действительно сохранены на физическом носителе и не потеряются при сбое. Анализ этого показателя помогает выявить потенциальные узкие места в работе дисковой подсистемы и принять меры для их устранения.

PostgreSql Instance: events

График показывает количество различных событий в БД. Он отображает четыре основные категории событий: конфликты (conflicts), взаимоблокировки (deadlocks), число отмененных транзакций (rollbacks), и число завершенных транзакций (commits). Эти метрики позволяют оценить стабильность работы системы и выявить потенциальные проблемы с производительностью. График предоставляет важную информацию о различных событиях, происходящих в БД и позволяет администраторам оценивать стабильность работы системы, анализировать причины конфликтов, отслеживать успешные завершения транзакций и выявлять потенциальные проблемы.

conflicts - количество конфликтов, возникших в ходе выполнения операций. Конфликты могут происходить по различным причинам, например, при попытке удаления или обновления данных, которые используются другими транзакциями. Высокие значения этого показателя могут указывать на неоптимальное использование ресурсов или необходимость перемесотра логики работы приложения.
deadlocks - количество выявленных взаимоблокировок. Взаимоблокировка возникает, когда две или более транзакции ожидают освобождения ресурсов, заблокированных друг другом. Этот показатель позволяет отслеживать частоту возникновения взаимоблокировок и принимать меры для их предотвращения.
rollbacks - количество отмененных транзакций. Откат транзакции может происходить по различным причинам, например, из-за ошибок выполнения запросов или превышения времени ожидания. Высокие значения этого показателя могут указывать на нестабильность системы или наличие проблем с производительностью.
commits - количество зафиксированных транзакций. Успешное завершение транзкции является нормальным и желаемым состоянием системы. Этот показатель позволяет оценить объем выполненных операций и общую производительность системы. Значение этого показателя в совокупности с другими метриками можно использовать для оценки стабильности и производительности системы.

PostgreSql: cache hit ratio

График показывает процент попадания в кеш и позволяет администраторам оценивать эффективность использования памяти, анализировать производительность системы, отслеживать изменения в работе системы и выявлять потенциальные проблемы.

cache hit ratio - процент запросов, которые были выполнены за счет чтения данных из оперативной памяти (кеша), а не с диска. Высокий процент попадания в кеш указывает на то, что большинство данных, необходимых для выполнения запросов, находятся в оперативной памяти, что значительно ускоряет работы системы. Конкретные требования к значению cache hit ratio зависят от природы нагрузки и конфигурации системы.

PostgreSql temp: bytes written

График показывает объем данных (в байтах), записанных во временные таблици или файлы. Этот показатель является важным индикатором нагрузки на временные ресурсы и помогает выявить потенциальные проблемы с производительностью.

bytes written - количество байтов, записанных во временные таблицы или файлы. Временные таблицы и файлы используются для хранения промежуточных результатов запросов, которые требуют больших объемов данных. Анализ этого показателя помогает выявить ситуации, где необходимо оптимизировать запросы и увеличить ресурсы сервера для уменьшения нагрузки на временные ресурсы.

PostgreSql temp: files created

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

number of files - количество временных файлов, созданных запросами за определенный период времени. Создание временных файлов может указывать на то, что система не может обрабатывать все данные в оперативной памяти и использует диск для хранения промежуточных результатов. Анализ этого показателя помогает выявить ситуации, где необходимо оптимизировать запросы или увеличить ресурсы сервера для уменьшения нагрузки на временные ресурсы.

PostgreSql archive command

График показывает результаты выполнения команды архивации журнала транзакций (Write-Ahead Logging, WAL) в БД. Он отображает два компонента: количество успешно архивированных сегментов WAL (WAL segments archived) и количество неудачных попыток архивации (WAL segments archive failed). Эти метрики позволяют оценить эффективность процесса архивации и выявить потенциальные проблемы с надежностью системы.

WAL segments archive failed - количество сегментов WAL, успешно архивированных за определенный период времени. Успешная архивация критически важны для восстановления БД после сбоев и обеспечения целостности данных.
WAL segments archive failed - количество сегментов WAL, для которых архивация завершилась неудачно за определенный период времени. Этот показатель отражает количество сегментов WAL, которые не удалось архивировать по какой-либо причине. Анализ этого показателя помогает определить неполадки в системе и предпринять необходимые действия, чтобы минимизировать риск потери данных.

PostgreSql WAL write speed

График показывает скорость генерации журнала транзакций (Write-Ahead Logging, WAL) в БД. Он отображает объем данных (в мегабайтах), который был сгенерирован и записан в журнал транзакций за определенный период времени.

WAL generated - количество мегабайт, сгенерированных и записанных в журнал транзакций за определенный период времени.

Отчёты

Страница "Отчёты" содержит таблицу, в которой представлен список всех сформированных и не удалённых отчётов профайлера.

Страница "Отчёты" будет пустой, если отчёты не формировались или все отчёты были удалены. В таком случае на странице отображается сообщение "Похоже здесь пусто".

Каждый отчёт, представленный в таблице, сопровождается служебной информацией (столбцы таблицы):

Экземпляр - экземпляр, в рамках которого формировался отчёт.
Сервер - сервер, в рамках которого формировался отчёт.
БД - база данных, для которой формировался отчёт.
Статус - статус формирования отчёта .
Период - выбранный временной интервал, для которого формировался отчёт.
Начало выполнения - момент времени, когда отчёт был сформирован.
Пользователь - пользователь, от имени которого был сформирован отчёт.

Таблицу можно отсортировать по любому из параметров, представленных в столбцах таблицы.

Крайний справа столбец ("Действия") таблицы содержит интерактивные элементы - кнопки "Просмотреть" и "Удалить".

Просмотр отчёта

По нажатию на кнопку "Просмотреть" будет открыт соответствующий отчёт профайлера. В верхней части страницы просмотра отчёта содержится служебная информация для конкретного отчёта, дублирующая информацию об этом отчёте в таблице на странице "Отчёты". Отчёт логически разбит на вкладки, навигация по которым осуществляется по клику на название вкладки. Подробно с содержанием отчёта можно ознакомиться в документации по модулю pgpro_pwr на сайте компании Postgres Pro.

Выгрузка отчёта

На странице просмотра отчёта в верхнем правом углу находится интерактивный элемент - кнопка "Скачать отчёт". По нажатию на кнопку вам будет предложено выбрать директорию на локальной машине, в которую вы хотите сохранить отчёт. Отчёт сохранится в формате HTML для удобства чтения и передачи.

Построение отчётов

Страница "Построение отчётов" предоставляет интерфейс для выбора базы данных и сервера, выбора интересующего временного периода, а также указания опций, определяющих формат отчёта. В поле "База данных" выберите базу данных, по которой необходимо сформировать отчёт. В поле "Сервер" укажите необходимый сервер. Используя опции "По снимкам" или "По времени" укажите, в каком формате будет задаваться интересующий временной период - интервал между снимками, задаваемый номерами снимков, или временной интервал, задаваемый в формате дд.мм.гггг, чч:мм. Используйте опции "Стандартный" или "Дифференциальный" для выбора типа отчёта. В зависимости от того, какую опцию вы выбрали для указания временного периода, в поле "Интервал" укажите номера снимков или временной интервал в формате дд.мм.гггг, чч:мм. Вне зависимости от того, какую опцию вы выбрали для указания формата задания временного периода, стартовая дата (или снимок) должны быть раньше, чем конечная дата (или снимок), иначе в интерфейсе платформы отобразится соответствующая ошибка. Кнопка "Сформировать отчёт" активируется, когда все элементы интерфейса заполнены. После нажатия на кнопку "Сформировать отчёт" в интерфейсе отобразится всплывающее уведомление с сообщением о том, что отчёт успешно сформирован, и ссылкой на отчёт. Все сформированные и не удалённые отчёты можно также найти на странице "Отчёты" раздела "Профайлер".

Снимки статистики

Страница "Снимки статистики" содержит таблицу, в которой представлен список всех выполненных снимков статистики.

В верхней части страницы представлен интерфейс выбора базы данных и сервера. Кнопка "Выбрать" активируется, когда все элементы интерфейса заполнены. После нажатия на кнопку "Выбрать" в таблице отобразятся соответствующие выбранной БД и серверу снимки статистики.

Каждый снимок, представленный в таблице, сопровождается служебной информацией (столбцы таблицы):

ID - идентификатор (порядковый номер) снимка.
Time - время, когда был выполнен снимок.
Sizes was collected - информация о том, собирались ли данные о размере.
Database stat reset - информация о том, сбрасывалась ли статистика в БД.
Bgwriter stat reset - информация о том, сбрасывалась ли статистика bgwriter.
Archiver stat reset - информация о том, сбрасывалась ли статистика архиватора.

Таблицу можно отсортировать по любому из параметров, представленных в столбцах таблицы. Также таблицу можно редактировать, скрывая или показывая необходимые столбцы, а также изменяя порядок следования столбцов. Меню редактирования таблицы доступно по нажатию на кнопку "Редактировать" в правой верхней части таблицы.

Для обновления данных в таблице также предусмотрена кнопка "Обновить" в правом верхнем углу страницы.

Таблица будет пустой, если снимки не создавались. В таком случае в теле таблицы будет сообщение "Похоже, здесь пусто".

Создание снимка

В верхнем правом углу страницы "Снимки статистики" доступен интерактивный элемент - кнопка "Сделать снимок".

По нажатию на кнопку "Сделать снимок" в интерфейсе платформы откроется боковая панель, в которой представлены поля и опции, необходимые для выполнения снимка. Выберите базу данных и сервер в соответствующих полях. Также для выбора доступен параметр skip_sizes, который можно установить либо в значение "true", либо "false".

После заполнения всех полей, нажмите кнопку "Сохранить". Будет запущено выполнение задачи. Запуск выполнения сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Выполнение запущено" и ссылкой на консоль заданий.

Управление задачами по снимкам статистики

Страница "Расписание" содержит таблицу, в которой представлен список всех запланированных задач по снимкам статистики.

Каждая задача в таблице сопровождается служебной информацией (столбцы таблицы):

Задача - название задачи.
Экземпляр - экземпляр, для которого запланирована задача.
БД - база данных, для которой запланирована задача.
Расписание - расписание выполнения задачи.
Пользователь - пользователь, от имени которого создана задача.

Крайний справа столбец ("Действия") таблицы содержит интерактивные элементы - меню действий над задачей. По нажатию на него откроется меню со списком доступных действий:

Редактировать
Выполнить
Деактивировать
Удалить

Для обновления данных в таблице также предусмотрена кнопка "Обновить" в правом верхнем углу страницы.

Таблица будет пустой, если задачи не создавались или все были удалены. В таком случае в теле таблицы будет сообщение "Похоже, здесь пусто".

Создание задачи

В верхнем правом углу страницы "Расписание" доступен интерактивный элемент - кнопка "Создать задачу".

По нажатию на кнопку "Создать задачу" в интерфейсе платформы откроется боковая панель, в которой представлены поля и опции, необходимые для создания задачи. В поле "Название" введите название задачи (обязательное поле). Если задача должна выполниться единожды, то для параметра "Планирование задачи" выберите опцию "Отложенное по времени". Если задача должна выполняться несколько раз по расписанию, выберите опцию "По расписанию". Для обоих режимов выполнения задач доступен интерфейс задания времени. При этом, в случае, когда выбрана опция "Отложенное по времени", время выполнения задачи можно задать cron-строкой, переключив в активное состояние соответствующий свитчер под полем "Название". Выберите базу данных и сервер в соответствующих полях. Также для выбора доступен параметр skip_sizes, который можно установить либо в значение "true", либо "false". Параметр skip_sizes отвечает за анализ размеров.

После заполнения всех полей, нажмите кнопку "Сохранить". Задача будет создана и помещена в расписание. Успешное создание задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Задача создана".

Редактирование задачи

В меню действий над задачей выберите действие "Редкатировать". В результате в интерфейсе платформы откроется боковая панель, в которой представлены поля и опции для редактирования. Отредактируйте поля в соответствии с необходимыми значениями и нажмите кнопку "Сохранить". Успешное редактирование задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Изменения сохранены".

Выполнение задачи

Для внепланового выполнения задачи в меню действий над задачей выберите действие "Выполнить". Действие выполнится сразу же. Успешный запуск задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Задача успешно запущена".

Деактивация задачи

Для деактивации задачи в меню действий над задачей выберите действие "Деактивировать". Действие выполнится сразу же. Успешная деактивация задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом. Задачу можно вновь активировать, выбрав действие "Активировать" в меню действий над задачей.

Удаление задачи

В меню действий над задачей выберите действие "Удалить". В результате в интерфейсе платформы откроется диалоговое окно с запросом подтверждения действия. Нажмите кнопку "Удалить", чтобы подтвердить удаление задачи, либо кнопку "Отмена" для отмены действия. Успешное удаление задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Задача успешно удалена".

Управление серверами для задач профайлера

Страница "Серверы" содержит таблицу, в которой представлен список всех созданных серверов для задач профайлера.

В верхней части страницы представлен интерфейс выбора базы данных. Кнопка "Выбрать" активируется, когда все элементы интерфейса заполнены. После нажатия на кнопку "Выбрать" в таблице отобразятся соответствующие выбранной БД серверы.

Для каждого сервера, представленного в таблице, есть соответствующая ему служебная информация (столбцы таблицы):

Название - наименование сервера.
Описание - пользовательское описание сервера.
Строка подключения - информация, необходимая для подключения к серверу.
Включен - статус сервера.
Срок хранения - срок хранения выборки в днях.

Для обновления данных в таблице также предусмотрена кнопка "Обновить" в правом верхнем углу страницы.

Крайний справа столбец ("Действия") таблицы содержит интерактивные элементы действий над сервером - "Редактировать" и "Удалить".

Таблица будет пустой, если серверы отсутствуют. В таком случае в теле таблицы будет сообщение "Похоже, здесь пусто".

Создание сервера

В верхнем правом углу страницы "Серверы" доступен интерактивный элемент - кнопка "Создать сервер".

По нажатию на кнопку "Создать сервер" в интерфейсе платформы откроется боковая панель, в которой представлены поля и опции, необходимые для создания задачи. Выберите необходимую базу данных из выпадающего списка. В поле "Имя сервера" введите имя. В поле "Описание" можно добавить текстовое описание создаваемого сервера. Введите данные для подключения в поле "Строка подключения". Установите параметр "Включен" в необходимое значение - "Да" или "Нет". В поле "Срок хранения" установите срок хранения выборки в днях.

После заполнения всех полей, нажмите кнопку "Сохранить". Сервер будет создан и отобразится в таблице. Успешное создание сервера сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Сервер успешно создан".

Редактирование сервера

В столбце "Действия" напротив необходимого сервера выберите действие "Редкатировать". В результате в интерфейсе платформы откроется боковая панель, в которой представлены поля и опции для редактирования. Отредактируйте поля в соответствии с необходимыми значениями и нажмите кнопку "Сохранить". Успешное редактирование задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Изменения сохранены".

Удаление сервера

В столбце "Действия" напротив необходимого сервера выберите действие "Удалить". В результате в интерфейсе платформы откроется диалоговое окно с запросом подтверждения действия. Нажмите кнопку "Удалить", чтобы подтвердить удаление задачи, либо кнопку "Отмена" для отмены действия. Успешное удаление задачи сопровождается всплывающим сообщением в интерфейсе платформы с текстом "Сервер успешно удален".

Аутентификация

Страница позволяет просматривать и управлять правилами HBA (host-based authentication) экземпляра СУБД.

Правила HBA определяют правила доступа к экземпляру СУБД.

Просмотр правил

Правила HBA представлены в виде таблицы со следующим набором полей (которые аналогичны структуре файла pg_hba.conf):

Тип - тип (или формат) правила. Возможные значения: local, host, hostssl, hostnossl, hostgssenc, hostnogssenc.
База данных - определяет, каким именам баз данных соответствует эта запись. Значение all определяет, что подходят все базы данных.
Пользователь - определяет, какому имени (или именам) пользователя базы данных соответствует эта запись. Значение all указывает, что запись соответствует всем пользователям.
Адрес - определяет адрес (или адреса) клиентской машины, которым соответствует данная запись. Это поле может содержать имя компьютера, диапазон IP-адресов или одно из ключевых слов. Значение all указывает что запись соответствует любым IP-адресам.
IP-маска - может отдельно содержать маску для случая, когда в поле "Адрес" указан только IP-адрес. Способ указания маски в отдельном поле является альтернативой записи IP-адрес/длина-маски. Эти поля не применимы к записям с типом local.
Метод - определяет метод аутентификации, когда подключение соответствует этой записи. Возможные значения: trust, reject, scram-sha-256, md5, password. Полный список возможных значений можно найти в документации PostgreSQL.
Опции - параметры специфичные для конкретного метода аутентификации в формате имя=значение. Подробное описание параметров, доступных для различных методов аутентификации можно найти в документации PostgreSQL.

Правила в таблице сформированы в том порядке, в котором они следуют в основном файле конфигурации pg_hba.conf. Если в файле используются директивы include, include_if_exists, include_dir, правила в этих файлах не выводятся.

Для просмотра всего файла доступна кнопка "Смотреть весь файл", которая выводит содержимое файла (включая комментарии) в отдельном окне.

Редактирование правил

Редактирование правил доступно двумя способами.

Первый способ упрощенный, он позволяет добавить новое правило в конец файла. Для этого нужно нажать кнопку "Добавить строку" в верхнем правом углу страницы. В открывшемся окне нужно заполнить форму, после чего нажать кнопку "Добавить строку". Новое правило будет добавлено в конец, для применения изменений следует нажать кнопку "Сохранить" в нижнем правом углу страницы.

Второй способ называется "Режим редактирования" и предназначен для внесения большего количества изменений. Режим редактирования включается переключателем в правом верхнем углу страницы. При его включении становится возможным редактировать не только правила, но и комментарии и также изменять их порядок следования в файле. Все изменения можно сбросить или применить через соответствующие кнопки "Сбросить" и "Сохранить" в нижнем правом углу страницы.

Замечание: при сохранении правил экземпляру СУБД отправляется сигнал о перезагрузке (reload) конфигурации - в этом случае происходит перечитывание всех файлов конфигурации экземпляра СУБД.

Полезные ссылки

Прочитать подробную информацию о файле pg_hba.conf можно по адресу https://postgrespro.ru/docs/postgrespro/current/auth-pg-hba-conf.

Роли

На странице "Роли" представлен список ролей экземпляра СУБД. Роли представлены таблицей со следующим списком полей:

Роль - имя роли.
Superuser - флаг, указывающий на то, что роль имеет привилегию SUPERUSER.
Create role - флаг, указывающий на то, что роль имеет привилегию CREATEROLE.
Create DB - флаг, указывающий на то, что роль имеет привилегию CREATEDB.
Login - флаг, указывающий на то, что роль имеет привилегию LOGIN.

Журнал сообщений

Страница предназначена для работы с журналами сообщений экземпляров СУБД.

Примечание: Для работы с журналами в PPEM должна быть настроена интеграция с pgpro-otel-collector.

Журнал сообщений представлен в виде набора управляющих сообщений и основной таблицы-журнала, в которой отображаются сообщения.

Управляющие элементы

Начало диапазона - позволяет указать дату и время, начиная с которого нужно выполнить поиск сообщений. По умолчанию начало диапазона установлено в 00:00 текущего дня.
Конец диапазона - позволяет указать дату и время, заканчивая которым нужно завершить поиск сообщений. По умолчанию конец диапазона установлен в 23:59 текущего дня.
Применить - после указания начала и конца диапазона позволяет запустить поиск сообщений по указанному диапазону.
Показать ошибки - задает фильтр поиска по сообщениям с типами: ERROR, FATAL и PANIC.
Сброс фильтров - кнопка предназначена для сброса всех фильтров в значения по умолчанию.
Скрыть/Отобразить колонки - позволяет управлять составом колонок основной таблицы и порядком их расположения.

Сообщения

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

Дата, время - время регистрации сообщения.
Экземпляр - экземпляр СУБД, к которому относится сообщение. Для поля доступен фильтр.
Сеанс - идентификатор сеанса, в рамках которого было зарегистрировано сообщение.
Приложение - название приложения, которое послужило источником сообщения.
Пользователь - пользователь, от имени которого был запущен сеанс.
База данных - база данных, с которой был установлен сеанс. Для поля доступен фильтр.
Тип - тип сообщения, возможные варианты: DEBUG1, DEBUG2, DEBUG3, DEBUG4, DEBUG5, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC. Для поля доступен фильтр.
Код SQLSTATE - код SQLSTATE сообщения.
Сообщение - текст сообщения.
Детали - детали сообщения.
Подсказка - дополнительная подсказка.
Идентификатор запроса - уникальный идентификатор запроса, по которому можно найти статистку в представлениях pg_stat_activity, pg_stat_statements, pgpro_stat_statements
Запрос - текст запроса. Отображение текста запроса ограничено по длине, отображение полного текста запроса доступно по кнопке "Раскрыть" в самом начале сообщения, перед первой колонкой. При нажатии на кнопку открывается дополнительная область с полным текстом запроса. Также в заголовке таблицы слева от колонок расположена кнопка для скрытия и раскрытия текстов запросов всех сообщений.

В зависимости от Типа сообщения ряд полей может быть либо заполненным, либо пустым.

Отображение и порядок колонок регулируется элементом "Скрыть/Отобразить колонки", расположенным в верхнем правом углу таблицы.

Поиск по ключевым словам

Поиск по ключевым словам работает на основе регулярных выражений. На данный момент поиск ограничен одним полем "Сообщение".

Пагинация

Вывод сообщений организован постранично - по 50 сообщений на одну страницу. Кнопки для постраничного перехода находятся внизу справа от основной таблицы.

Консоль заданий

Задания

В процессе эксплуатации пользователь или менеджер PPEM могут инициировать выполнение заданий на стороне агентов и экземпляров. Страница "Задания" предназначена для отслеживания заданий и просмотра их состояния. История команд представлена в виде таблицы со следующим набором полей:

Название - заголовок задания с коротким описанием задания.
Агент - имя агента, который назначен для выполнения задания.
Экземпляр - имя экземпляра СУБД, в котором было выполнено задание.
Статус - статус выполнения задания.
Начало выполнения - время запуска задания.
Окончание выполнения - время окончания задания.
Действия
- Показать журнал - позволяет просмотреть детали выполнения задания.

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

Расписание

Страница "Расписание" позволяет просмотреть список всех доступных заданий, созданных в PPEM. Расписание заданий представлено в виде таблицы со следующим списком полей:

Задача - заголовок с кратким описанием задания.
Пользователь - пользователь, от имени которого создано задание.
Расписание - строка в cron-формате, которая описывает расписание.
Параметры - параметры выполнения задания (если таковые есть).
Действия - действия, доступные для управления заданием:
- Деактивировать - выключить задание из расписания.
- Активировать - включить в расписание ранее выключенное задание.
- Удалить - удалить задание из расписания.

Страница "Расписание" предназначена только для просмотра заданий. Создание и редактирование доступно на соответствующих страницах управления отдельными заданиями.

Резервное копирование

Страница "Резервные копии" предназначена для работы с резервными копиями. На странице доступен просмотр списка резервных копий и возможность создания резервных копий экземпляров СУБД.

PPEM для работы с резервными копиями использует pg_probackup.

Управление хранилищами резервных копий

Страница предназначена для просмотра и управления хранилищами резервных копий.

PPEM поддерживает работу с локальными хранилищами и хранилищами S3. Локальные хранилища представляют собой каталог на файловой системе, который размещен на том же сервере, где запущен и экземпляр СУБД. Восстановление из резервных копий из таких хранилищ ограничено только локальными экземплярами - сделав резервную копию экземпляра на одном сервере, нельзя восстановить экземпляр из этой копии на другом сервере. Хранилища S3 являются более удобными и позволяют обойти это ограничение.

Отображение хранилище разделено на две вкладки - локальные хранилища и S3-хранилища.

Список хранилищ представлен в виде таблицы со следующими полями:

Название - имя хранилища.
Экземпляр - имя экземпляра. В случае локальных хранилищ это экземпляр, на котором размещен каталог хранилища. В случае S3-хранилища это экземпляр, через который менеджер PPEM взаимодействует с хранилищем.
Каталог - путь в файловой системе, где размещен каталог.
Параметры - параметры взаимодействия с S3-хранилищем.
Retention redundancy, шт. - количество резервных копий, которое будет удерживаться в хранилище (для каждого отдельного экземпляра).
Retention window, дни - количество дней, в течение которых резервные копии будут удерживаться в хранилище (для каждого отдельного экземпляра).
WAL depth, шт. - глубина хранения WAL журнала, определяет количество копий, которые могут быть использованы для PITR.
Просроченные копии - политика управления резервными копиями при истечении срока хранения, возможные варианты:
- Объединять - при возможности объединять с более свежими резервными копиями.
- Удалять - удалять резервные копии с истёкшим сроком хранения.
- Удалить просроченные WAL - удалить WAL-журналы копий с истёкшим сроком хранения.

Создание локальных хранилищ

Для создания хранилища нужно нажать кнопку "Создать хранилище РК" в верхнем правом углу экрана. В открывшейся форме нужно выбрать "Локальное хранилище" и нажать кнопку "Далее". На следующем шаге нужно заполнить:

Название - произвольное имя хранилища.
Каталог - путь в файловой системе, где будет создан каталог.
Экземпляр - экземпляр, который будет связан с каталогом.
Системный пользователь - пользователь операционной системы, которому будет принадлежать каталог. Обычно это должен быть пользователь, от имени которого выполняется экземпляр СУБД, т.к. этот пользователь должен иметь доступ для чтения и записи в этот каталог.
Параметры хранения:
- Retention redundancy, шт. - количество резервных копий, которое будет удерживаться в хранилище (для каждого отдельного экземпляра).
- Retention window, дни - количество дней, в течение которых резервные копии будут удерживаться в хранилище (для каждого отдельного экземпляра).
- WAL depth, шт. - глубина хранения WAL журнала, определяет количество копий, которые могут быть использованы для PITR.
- Просроченные копии - политика управления резервными копиями при истечении срока хранения, возможные варианты:
  - Объединять - при возможности объединять с более свежими резервными копиями.
  - Удалять - удалять резервные копии с истёкшим сроком хранения.
  - Удалить просроченные WAL - удалить WAL-журналы копий с истёкшим сроком хранения.

После заполнения всех параметров нужно нажать кнопку "Сохранить", хранилище будет создано и появится в списке хранилищ.

Создание S3-хранилищ

Для создания хранилища нужно нажать кнопку "Создать хранилище РК" в верхнем правом углу экрана. В открывшейся форме нужно выбрать "S3 хранилище" и нажать кнопку "Далее". На следующем шаге нужно заполнить:

Название хранилища - произвольное имя хранилища.
Тип - вендор хранилища, доступные варианты: minio, aws, vk (vkontakte).
Хост - сервер, с которого будут выполняться команды по взаимодействию с хранилищем.
Имя сервера - адрес S3-хранилища (см. PG_PROBACKUP_S3_HOST).
Протокол https - указывает на использование HTTPS-протокола при взаимодействии с S3-хранилищем (см. PG_PROBACKUP_S3_HTTPS).
Порт - порт для подключения к S3-хранилищу (см. PG_PROBACKUP_S3_PORT).
Access Key ID - ключ доступа для подключения (см. PG_PROBACKUP_S3_ACCESS_KEY).
Secret access key - секретный ключ для подключения (см. PG_PROBACKUP_S3_SECRET_ACCESS_KEY).
Bucket - имя корзины в хранилище (см. PG_PROBACKUP_S3_BUCKET_NAME).
Region - регион для выбора сервера (см. PG_PROBACKUP_S3_REGION).
Каталог копий - путь к каталогу внутри корзины, используется для разделения данных внутри корзины.
Параметры хранения - позволяет указать политику хранения уровня хранилища.

После заполнения всех параметров нужно нажать кнопку "Сохранить", будет создано хранилище и оно появится в списке хранилищ (во вкладке S3-хранилища).

Редактирование хранилищ

Для редактирования хранилища следует у целевого хранилища нажать кнопку "Редактировать" в поле "Действия". В открывшемся окне следует изменить необходимые параметры и нажать кнопку сохранить. Список изменяемых параметров зависит от типа хранилища. Также есть параметры, которые задаются при инициализации и позже уже не могут быть изменены, например путь размещения каталогов внутри хранилища. После того, как требуемые параметры заполнены, следует нажать кнопку "Сохранить".

Удаление хранилища

Для удаления хранилища следует у целевого хранилища нажать кнопку "Удалить" в поле "Действия". В открывшемся окне следует подтвердить выполнение операции и нажать кнопку "Удалить".

Создать резервную копию

Для создания резервной копии следует нажать кнопку "Создать резервную копию" в верхнем правом углу страницы. В открывшемся диалоговом окне следует указать параметры резервной копии:

Экземпляр - целевой экземпляр СУБД, для которого следует выполнить резервное копирование.
Хранилище копий - целевое хранилище, где следует сохранить резервное копирование. Для выбора доступны только локальные хранилища, которые расположены на том же сервере, где и экземпляр СУБД и хранилища S3.
Пользователь - пользователь экземпляра СУБД, от имени которого будет выполнено резервное копирование.
Пароль - пароль пользователя, от имени которого будет выполнено резервное копирование.
База данных - база данных для подключения к экземпляру СУБД.
Режим копирования - режим резервного копирования, возможные значения:
- FULL - полное резервное копирование.
- PAGE - инкрементальное постраничное копирование.
- PTRACK - инкрементальное копирование изменений.
- DELTA - инкрементальное разностное копирование.
Количество потоков - количество параллельных потоков, с которым будет выполняться резервное копирование.
Время ожидания - таймаут для архивирования сегментов WAL и потоковой передачи (в секундах).
Создать автономную резервную копию - создание резервной копии вместе с набором WAL журналов, необходимым для последующего восстановления.
Слот репликации - указывает использовать существующий слот репликации.
Создать временный слот репликации - позволяет создать временный слот репликации только на время выполнения резервного копирования.

После заполнения параметров следует нажать кнопку "Далее" и перейти к следующему шагу настроек. На втором шаге находятся дополнительные параметры настроек:

Внешние каталоги - можно указать список каталогов для включения в резервную копию, например каталоги с файлами конфигурации.
Включить каталог log - включить в резервную копию каталог с журналами активности СУБД.
Не проверять резервную копию - позволяет пропустить шаг валидации резервной копии, например для сокращения времени выполнения резервного копирования.
Растягивать выполнение контрольной точки - позволяет дождаться планового выполнения контрольной точки и только после этого запустить резервное копирование.
Отключить проверку на уровне блоков - позволяет выключить блочную валидацию.
Уровень сжатия - позволяет задать уровень сжатия от 0 до 9, где 0 - это отсутствие сжатия, а 9 - это наилучшее сжатие.
Алгоритм сжатия - позволяет выбрать целевой алгоритм, возможные значения: zlib, lz4, zstd, pglz.
Закрепление - параметры закрепления резервной копии после ее создания, возможные варианты:
- Не закреплять - копия не закрепляется и для нее действуют политики хранения, определенные настройками экземпляра и/или хранилища.
- TTL - позволяет указать продолжительность закрепления в днях, в течение которых копия не может быть удалена.
- Expire Time - позволяет указать срок закрепления, в течение которого копия не может быть удалена.
Параметры хранения:
- Retention redundancy - количество полных резервных копий, которое должно сохраняться в каталоге.
- Retention window - количество дней, в течение которых должны храниться резервные копию.
- WAL depth - количество резервных копий, для которых должны сохраняться WAL-журналы для возможности PITR-восстановления.
- Просроченные копии - правила для резервных копий с истекшим сроком хранения.
  - Объединять - при возможности объединять с более свежими резервными копиями.
  - Удалять - удалять резервные копии с вышедшими за срок хранения.
  - Удалить просроченные WAL - удалить WAL журналы копий вышедших за срок хранения.

После того, как заполнены необходимые поля, следует нажать кнопку "Выполнить РК", запрос на создание резервной копии будет поставлен в очередь, сама копия появится в списке резервных копий.

Посмотреть резервные копии

Просмотр списка резервных копий доступен через таблицу со следующим списком полей:

Размер - размер резервной копии в байтах.
ID - уникальный идентификатор резервной копии в системе идентификации инструмента резервного копирования, в данном случае pg_probackup.
Режим - тип резервной копии, возможные значения: FULL, PAGE, PTRACK, DELTA.
Хранилище - каталог, в котором размещена резервная копия.
Экземпляр - экземпляр СУБД, который был зарезервирован.
Статус - состояние резервной копии.
Начало выполнения - время начала резервного копирования.
Окончание выполнения - время завершения резервного копирования.
Пользователь - пользователь PPEM, от имени которого было создано задание резервного копирования.
Статус валидации - состояние проверки резервной копии на консистентность.
Начало валидации - время начала валидации резервной копии.
Окончание валидации - время завершения валидации резервной копии.
Действия:
- Валидировать резервную копию - запустить процедуру валидации резервной копии.
- Журнал резервной копии - просмотреть журнал выполнения резервной копии.
- Редактировать закрепление - управление параметрами закрепления в рамках политики хранения.
- Восстановить - восстановить экземпляр из резервной копии.
- Удалить - удалить резервную копию.

Создать задание резервного копирования

Для создания задания необходимо в верхнем правом углу нажать кнопку "Создать задачу". В открывшемся окне следует заполнить параметры расписания и параметры задания резервного копирования.

Параметры расписания:

Название - произвольное название для задания.
Задать выполнение cron-строкой - позволяет указать задание в формате cron-строки.
Способ планирования задания:
- Отложенное по времени - позволяет настроить единственный запуск в указанную дату и время. В этом случае следует указать дату и время запуска.
- По расписанию - позволяет настроить регулярное выполнение по расписанию. В этом случае следует заполнить параметры регулярного выполнения.
Интервал - позволяет настроить интервал выполнения задания в минутах, часах или днях. В зависимости от выбранного способа будет предложено выбрать нужный интервал повторения.
Начать - позволяет указать дату и время, начиная с которого задание вступит в силу и будет выполняться согласно расписанию. До этого времени задание не будет выполняться.
Повторять до - позволяет указать дату и время, до которого задание будет действительно и будет выполняться согласно расписанию. После этого времени задание не будет выполняться.
Итоговая cron-строка - информационное поле, в котором в cron-формате отображается итоговое расписание.

Параметры задания резервного копирования содержат те же параметры, что и форма создания резервных копий. Следует заполнить необходимые параметры и нажать кнопку "Сохранить".

Посмотреть расписание резервного копирования

Страница "Расписание" позволяет просматривать и управлять заданиями резервного копирования, запускаемых по расписанию.

Расписание заданий представлено в виде таблицы со следующим списком полей:

Задача - название задания.
Агент - имя агента, который будет выполнять задание.
Экземпляр - экземпляр, для которого будет выполняться резервное копирование.
Хранилище - каталог, куда будет сохраняться резервная копия.
Сжатие - уровень сжатия, используемый при резервном копировании.
Последнее выполнение - время последнего выполнения задания.
Расписание - строка в cron-формате, описывающая расписание задания.
Пользователь - имя пользователя PPEM, от имени которого выполняется задание.
Действия - действия, доступные для управления заданием:
- Выполнить - запустить выполнение задания немедленно.
- Деактивировать - выключить задание из расписания.
- Активировать - включить в расписание ранее выключенное задание.
- Удалить - удалить задание из расписания.

Визуализация плана запроса

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

Визуализация предоставляет навигацию по узлам запроса и позволяет наглядно изучать план и детали выполнения запроса.

Для получения плана запроса используйте команду EXPLAIN (ANALYZE, COSTS, VERBOSE, BUFFERS, FORMAT JSON). Полученный план запроса следует скопировать в окно "План запроса", дополнительно можно скопировать текст запроса в окно "Запрос" и нажать кнопку "Визуализировать".

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

Вход в личный кабинет

Восстановление пароля

Подтверждение аккаунта

Изменение пароля

Использование PPEM

Вход в веб-приложение

Дашборд

Панель навигации

Дашборд

Панель инструментов

Настройка системы

Управление агентами

Просмотр списка агентов

Добавление агента

Редактирование информации об агенте

Удаление агента

Управление тегами

Просмотр тегов

Создание тегов

Редактирование тегов

Удаление тегов

Пользователи PPEM

Управление пользователями

Просмотр пользователей

Фильтрация и сортировка пользователей

Создание пользователя

Редактирование пользователя

Удаление пользователя

Управление группами пользователей

Просмотр групп пользователей

Фильтрация и сортировка групп пользователей

Создание группы пользователей

Просмотр информации о группе пользователей

Редактирование группы пользователей

Удаление группы пользователей

Роли и привилегии

Описание ролей

Описание привилегий

Просмотр ролей и привилегий

Кластеры репликации

Термины

Просмотр кластеров

Экземпляры

Управление экземплярами

Добавление экземпляра с помощью агента

Создание нового экземпляра

Добавление существующего экземпляра

Создание экземпляра из резервной копии

Редактирование экземпляра

Остановка экземпляра

Запуск экземпляра

Перезапуск экземпляра

Выполнить резервное копирование

Пресеты конфигурации

Удаление экземпляра

Экземпляр репозитория PPEM

Табличные пространства

Просмотр табличных пространств

Создание табличных пространств

Редактирование табличных пространств

Удаление табличных пространств

Базы данных

Управление базами данных

Создание базы данных

Просмотр баз данных

Запуск терминала PSQL

Сбор статистики планировщика

Переиндексация

Запуск очистки

Переименование базы данных

Удаление базы данных

Схемы

Создание схемы

Просмотр схем

Редактирование схемы

Удаление схемы

Таблицы

Создание таблицы

Просмотр таблиц

Информация о конкретной таблице