6. Графический web-интерфейс

6.1 Цветовое кодирование статусов объектов управления

Для удобства отображения данных статусы объектов управления (статус кластера, узла, сервиса, экземпляра сервиса) группируются в схожие по смыслу группы (cостояния объектов), для которых определены цветовые решения:

Категория статусов Цветовое решение Примеры статусов Описание

ОК

Зелёный

Доступен
Выполнена
Запущен
Включено
Завершена
ОК

Статусы объекта, который настроен и работает без ошибок. Статус также используется для операций / задач, которые завершились успешно, и для включённых расписаний резервного копирования

Warning

Желтый

Резерв
Деградирован
Ошибка
Неизвестен
Завершена

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

Critical

Красный

Остановлен
Недоступен
Ошибка
Повреждена
Нет родителя

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

Down

Темно-серый

Недоступен
Остановлен
Отключён

Объект остановлен / отключён.

InProcess

Синий

Выполняется
Взята в обработку
Удаляется

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

New

Мятный

Новая

Недавно добавленный объект. Статус используется для операций / задач, которые были добавлены, но еще не начали выполняться

N/A

Белый

Нет данных
Обслуживание

Статус управляемого объекта, от которого не удалось получить данные (агент на всех узлах отсутствует или остановлен, узел выведен в режим обслуживания (maintenance))

Статусы объектов могут отображаться в виде текстового поля с наименованием статуса:

image$statuses

Также возможно отображение статусов в виде набора текстовых полей с числами, когда отображаются статусы связанных объектов (например, для кластера отображаются статусы сервисов кластера и статусы узлов, входящих в состав кластера):

image$statuses in numbers

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

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

Объект Состояние Статус Комментарий

Экземпляр сервиса

Warning

Unknown

Статус экземпляра сервиса получить не удалось

InProcess

Starting

Экземпляр сервиса запускается

Stopping

Экземпляр сервиса останавливается

Initialization

Экземпляр сервиса инициализируется (для экземпляра сервиса кластера Patroni)

OK

Started

Экземпляр сервиса запущен и доступен

Сервис

Warning

Unknown

Статус экземпляров сервиса получить не удалось

OK

Available

Сервис доступен

Down

Stopped

Сервис остановлен

Unavailable

Сервис недоступен (для сервисов кластера Pacemaker/Corosync)

Unavailable_error

Сервис недоступен - ошибка (для сервисов кластера Patroni)

Warning

Degraded

Сервис частично недоступен

N/A

No_data

Сервис, информацию о котором не удалось получить/обновить

Узел кластера

Warning

Standby

Узел временно недоступен для размещения кластерных ресурсов (выведен администратором в режим обслуживания)

N/A

Maintenance

Активность ресурса не меняется, ресурс выведен из-под управления кластера

No_data

Узел, информацию о котором не удалось получить/обновить

OK

Online

Узел доступен

Critical

Offline

Узел остановлен

Not ready

Узел не готов (для узла кластера Patroni)

Down

Unknown

Узел недоступен

Кластер

Warning

Degraded

Часть узлов кластера неисправна или находится на обслуживании

Down

Offline

Кластер недоступен

OK

Online

Кластер исправен и доступен

N/A

No_data

Кластер, информацию о котором не удалось получить/обновить

Maintenance

Нет данных (для кластера Patroni)

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

ОК

OK

Резервная копия сделана и пригодна к использованию

ОК

Done

Резервная копия сделана, но не проверена

ОК

Merged

Файлы резервной копии были успешно обработаны в процессе объединения копий, но её метаданные ещё изменяются. Это состояние могут иметь только полные резервные копии

InProcess

Running

Резервное копирование выполняется

Merging

Резервная копия объединяется

Deleting

Файлы резервной копии удаляются

Critical

Error

Резервное копирование было прервано из-за неожиданной ошибки

Corrupt

Некоторые файлы резервной копии повреждены

Orphan

Резервная копия непригодна к использованию, так как её родительская копия испорчена или отсутствует

N/A

Hidden_for_test

Скрипт теста пометил копию как несуществующую

Расписание резервного копирования

ОК

ОК

Расписание активно

Down

Down

Расписание не активно

6.2 Общее описание интерфейса

Интерфейс "Спектра" содержит три области:

image$interface areas

(1) – область главного меню;

(2) – панель дублирующей навигации (навигационная цепочка);

(3) – область представления данных.

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

image$collapse

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

Если в области представления данных навести курсор на строку таблицы объектов (кластеров, узлов, сервисов), происходит затенение строки, в границах которой находится курсор. Нажатие правой кнопки мыши в пределах затенённой строки вызывает меню со списком возможных для данного объекта операций (пример для страницы кластеров):

image$context menu

Меню операций для объекта также вызывается нажатием соответствующей кнопки ⋮ в правой части затенённой строки.

6.3 Раздел "Кластеры"

При первом запуске "Спектра" на странице "Кластеры" выводится сообщение об отсутствии зарегистрированных кластеров ("Нет данных").

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

Если при установке "Спектра" не был указан корректный IP-адрес, по которому доступно ПО "Скала^р Геном.Управление", блок "Добавить найденные", содержащий список кластеров, доступных для импорта, не отображается.

При наличии зарегистрированных в "Спектре" кластеров при выборе раздела ОБЪЕКТЫ УПРАВЛЕНИЯ  Кластеры отображается их список.

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

При наведении курсора на значок image$icon info справа от имени кластера появляется всплывающая подсказка с описанием кластера. Данное описание может быть задано / изменено при редактировании дополнительных параметров кластера, а также в процессе импорта кластера в "Спектр".

Для геокластеров и их компонентов справа от имени отображается значок image$icon geocluster. При наведении курсора на значок появляется соответствующая всплывающая подсказка.

Справа от имени кластеров также отображается тип кластерного ПО: Pacemaker или Patroni.

Для кластеров предусмотрены: сортировка, группировка и быстрый поиск.

6.3.1 Изменение порядка сортировки кластеров

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

image$sort

Повторные нажатия на выделенный заголовок столбца изменяют порядок сортировки. Направление сортировки указывается стрелкой.

6.3.2 Изменение группировки кластеров

По умолчанию кластеры не сгруппированы.

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

  • При выборе варианта группировки "По статусу" кластеры будут сгруппированы в соответствии с их статусами. Для каждого статуса отображается количество кластеров с данным статусом:

    image$number in status

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

  • При выборе варианта группировки "По площадкам" кластеры будут сгруппированы в соответствии с их размещением. Геокластеры будут отображены отдельной группой.

  • Для отмены группировки в выпадающем списке выберите вариант "Без группировки" или нажмите кнопку ✕:

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

6.3.3 Быстрый поиск кластеров

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

6.3.4 Дополнительная информация о кластерах

При нажатии на имя кластера открывается страница, содержащая вкладки (подразделы) с информацией о выбранном кластере.

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

  • тип кластерного ПО;

  • значок типа кластера: локальный - image$icon local cluster или геораспределённый - image$icon geocluster active. Цвет значка соответствует статусу кластера;

  • имя кластера.

При раскрытии списка в нём отображаются все зарегистрированные в "Спектре" кластеры.

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

image$tabs on cluster page

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

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

В правом верхнем углу области представления данных отображается кнопка ⋮ вызова меню действий с кластером. Меню аналогично таковому на главной странице кластеров.

Для локальных кластеров и кластеров-компонентов геокластеров Pacemaker/Corosynс отображаются вкладки "Обзор", "Сервисы", "Диагностика" и "События".

На вкладке "Обзор" представлены 3 блока:

image$overview tab

  • "Информация" содержит сведения о количестве и статусе узлов и сервисов выбранного кластера;

  • "Кворум" отображает информацию о наличии кворума и состоит из полей: "Наличие кворума", "Получено голосов", "Ожидается голосов", "Требуется голосов";

  • "Фенсы" имеет вид таблицы со столбцами: "Имя", "Агент", "Статус", "Обслуживает узел", "Запущен на узле". Если кластер остановлен – у всех фенсов также будет статус "ОСТАНОВЛЕН". При нажатии на имя узла в столбце "Запущен на узле" происходит переход на страницу "Мониторинг" выбранного узла.

На вкладке "Сервисы" отображается таблица-схема сервисов кластера с указанием ролей экземпляров сервиса на узлах и статусами сервисов и узлов (цветовые индикаторы слева от имен узлов и сервисов):

image$service tab

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

image$service tab geocluster

При нажатии на имя сервиса будет осуществлен переход на вкладку "Обзор" выбранного сервиса. При нажатии на имя узла будет осуществлен переход на вкладку "Мониторинг" выбранного узла.

Перемещение ролей сервисов между узлами описано в п. 8.7 настоящего Руководства.

Заголовок вкладки "Диагностика" имеет вид выпадающего списка, который содержит пункт перехода на страницу "Отчеты Cluster Report". При выборе пункта "Отчеты Cluster Report" отображается таблица с ранее созданными отчётами:

image$cluster report page

Над таблицей расположена кнопка Создать — создать новый отчёт. Описание операций создания отчётов Cluster Report представлено в п. 8.4.

При нажатии на имя отчёта будет вызван стандартный интерфейс браузера для сохранения файлов. Файл отчёта имеет формат tar.bz2.

В нижней части страницы расположена панель пагинации.

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

Для кластеров Patroni отображаются вкладки "Обзор" и "Сервисы". Информация, представленная на вкладках, аналогична информации на соответствующих вкладках кластеров Pacemaker/Corosynс.

Для связанного геокластера отображаются вкладки "Обзор", "Топология", "Сервисы" и "События".

На вкладке "Обзор" геокластеров Pacemaker/Corosynс представлен блок "Информация", который содержит сведения о количестве и статусе узлов и сервисов выбранного кластера, а также о наличии кворума для кластеров-компонентов геокластера.

На вкладке "Обзор" геокластеров Patroni отображаются 2 блока с информацией о кластерах-компонентах и входящих в их состав узлах. Верхняя таблица относится к активному компоненту, нижняя — к резервному:

image$overview tab patroni

Блоки можно скрывать / отображать нажатием соответствующих элементов управления.

В заголовке каждого блока указаны: имя кластера-компонента, его статус, площадка размещения, статус ETCD, версия Patroni и Uptime <роль> (время непрерывной работы в данной роли). При нажатии на имя кластера будет осуществлен переход на вкладку "Обзор" выбранного кластера.

В блоке расположена таблица узлов, содержащая следующие столбцы: имя узла, IP-адрес, статус, установленная на узле ОС и её версия. Возможна сортировка узлов по каждому из параметров.

Для каждого узла доступна кнопка ⋮ вызова меню действий. В меню доступна операция остановки запущенных узлов или запуска остановленных узлов.

На вкладке "Топология" представлена таблица-схема статусов геосервисов на локальных кластерах-компонентах. Цветовые индикаторы слева от имен кластеров и сервисов обозначают их статус. В ячейках таблицы отображаются статусы - активный (ACTIVE) или резервный (STANDBY).

Для геокластеров Pacemaker/Corosynс доступна операция перемещения ролей геосервисов между локальными кластерами-компонентами (подробнее операция описана в п. 9.3 настоящего Руководства.):

image$change roles

Для геокластеров Patroni указывается площадка размещения геосервиса.

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

Цветовые индикаторы слева от имен кластеров, сервисов и узлов обозначают их статус.

При нажатии на имя кластера будет осуществлен переход на вкладку "Обзор" выбранного кластера, при нажатии на имя сервиса — на вкладку "Обзор" выбранного сервиса, а при нажатии на имя узла — на страницу "Мониторинг" выбранного узла.

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

6.3.5 Операции с кластерами

Меню операций с кластером вызывается либо нажатием правой кнопки мыши в границах соответствующей кластеру строки таблицы, либо нажатием соответствующей кнопки ⋮.

6.3.5.1 Операции для кластеров Pacemaker/Corosync

Для кластера со статусом "ДОСТУПЕН" возможны операции: остановка, изменение дополнительных параметров кластера, создание отчета Cluster Report, добавление сервиса и удаление из "Спектра".

Для остановленного (отключённого) кластера доступны операции: запуск, изменение дополнительных параметров кластера и удаление из "Спектра".

Для кластера со статусом "ДЕГРАДИРОВАН" — остановка, изменение дополнительных параметров кластера, создание отчета Cluster Report и удаление из "Спектра".

Для кластера со статусом "НЕТ ДАННЫХ" — удаление из "Спектра".

Для кластеров-компонентов геокластера также становится доступна операция создания геокластера, а для сформированного геокластера — операция расформирования.

  1. Конфигурирование собственно геокластера "Спектром" не осуществляется. Действия в "Спектре" изменяют только конфигурацию самого "Спектра" и соответствующее отображение объектов в его интерфейсе.

  2. В процессе выполнения операций с кластером для кластера и входящих в него объектов контекстное меню действий по нажатию правой кнопки мыши не вызывается, вместо кнопки ⋮ вызова меню действий отображается вращающийся спиннер.

6.3.5.2 Операции для кластеров Patroni

Для кластеров со статусом "ДОСТУПЕН" или "ДЕГРАДИРОВАН" возможны операции ввода в режим обслуживания (maintenance), остановки, изменения дополнительных параметров и удаления из Спектра.

Для кластера со статусом "ОСТАНОВЛЕН" доступны операции запуска, изменения дополнительных параметров кластера и удаления из Спектра.

Для кластера со статусом "ОБСЛУЖИВАНИЕ" доступны операции ввода в работу (unmaintenance), остановки, изменения дополнительных параметров кластера и удаления из Спектра.

6.4 Раздел "Узлы"

При выборе раздела ОБЪЕКТЫ УПРАВЛЕНИЯ  Узлы открывается страница, на которой отображается список доступных узлов, их IP-адреса, имена кластеров, в который входят узлы, статусы, а также информация о площадке расположения. Справа от имени узлов отображается тип кластера, к которому они принадлежат: Pacemaker или Patroni.

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

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

image$diagrams of node parameters

Если при установке "Спектра" не был введен корректный IP-адрес, по которому доступно ПО "Скала^р Визион", отображение данных мониторинга узлов будет недоступно. В полях для графиков будет отображаться "Нет данных".

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

6.4.1 Изменение порядка сортировки и быстрый поиск узлов

Алгоритмы изменения порядка сортировки и быстрого поиска узлов аналогичны соответствующим алгоритмам для кластеров, представленным в п. 6.3.1 и п. 6.3.3 соответственно.

6.4.2 Изменение группировки узлов

По умолчанию узлы не сгруппированы.

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

  • При выборе варианта группировки "По кластеру" узлы будут отображены согласно принадлежности к кластеру. Для кластеров также отображаются их статусы и количество входящих в их состав узлов. Для связанных геокластеров отображается двухуровневая группировка узлов. 1-й уровень группировки –- геокластер, 2-й уровень группировки –- кластер-компонент:

    image$grouping nodes

    Для свёртывания / развёртывания списка узлов какого-либо кластера используйте соответствующие элементы управления.

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

  • Для отмены группировки нужно выбрать вариант "Без группировки" или нажать кнопку ✕.

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

6.4.3 Операции с узлами

Меню операций с узлом вызывается либо нажатием правой кнопки мыши в границах соответствующей узлу строки таблицы, либо нажатием соответствующей кнопки ⋮.

6.4.3.1 Операции для узлов в составе кластеров Pacemaker/Corosync

Для узла со статусом "ДОСТУПЕН" возможны операции:

  • вывод в режим обслуживания (standby) — активные ресурсы могут перемещаться между узлами;

  • вывод в режим обслуживания (maintenance) — активность ресурса не меняется, ресурс выводится из-под управления кластера;

  • остановка.

Если соответствующий кластер находится в статусе "ДЕГРАДИРОВАН", все пункты меню для узла со статусом "ДОСТУПЕН" будут недоступны.

Для остановленного узла возможна операция запуска.

Для узлов в статусе "ОСТАНОВЛЕН", которые имеют указанный статус по причине остановки кластера, все пункты меню недоступны.

Для выведенного в режим обслуживания узла (standby) возможны операции ввода в работу (unstandby) и остановки.

Для выведенного в режим обслуживания (maintenance) узла возможна операция ввода в работу (unmaintenance).

Для узла со статусом "НЕТ ДАННЫХ" все пункты меню недоступны.

6.4.3.2 Операции для узлов в составе кластеров Patroni

Для узлов со статусом "ДОСТУПЕН" и "ОБСЛУЖИВАНИЕ" возможна операция остановки.

Для узлов со статусом "ОСТАНОВЛЕН" возможна операция запуска, в том числе в случае, когда узлы имеют данный статус по причине остановки кластера.

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

image$operation info

6.5 Раздел "Сервисы СУБД"

При выборе раздела ОБЪЕКТЫ УПРАВЛЕНИЯ  Сервисы СУБД открывается страница, на которой представлен список всех сервисов, зарегистрированных в "Спектре".

Список содержит имя сервиса, имя кластера, к которому принадлежит сервис, текущий статус и информацию о площадке размещения.

Справа от имени сервисов отображается тип кластера, к которому они принадлежат: Pacemaker или Patroni.

Для standalone-сервисов имена кластеров не отображаются. Справа от имени standalone-сервисов в скобках указаны соответствующие им узлы. Справа от имени сервисов геокластеров отображается значок image$icon geocluster.

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

Для сервисов со статусами "ДОСТУПЕН" или "ДЕГРАДИРОВАН" справа от статуса могут отображаться индикаторы ожидания (возможно отображение обоих индикаторов):

  • операции перезапуска (restart) image$icon restart;

  • операции перезагрузки (reload) image$icon reload.

При наведении курсора на индикатор появляется всплывающая подсказка с его описанием.

Порядок сортировки и способ группировки сервисов можно изменить. Также доступно поле быстрого поиска сервисов.

6.5.1 Изменение порядка сортировки, группировки и быстрый поиск сервисов

Алгоритмы изменения порядка сортировки, группировки и быстрого поиска сервисов аналогичны соответствующим алгоритмам для кластеров, представленным в пп. 6.3.1–6.3.3 соответственно.

6.5.2 Дополнительная информация о сервисах

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

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

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

6.5.2.1 Вкладки для сервисов геокластеров

Для сервисов геокластеров Pacemaker/Corosync представлены 3 вкладки: "Обзор", "Топология" и "Конфигурации", а для сервисов геокластеров Patroni представлены 4 вкладки: "Обзор", "Топология", "Базы данных" и "Конфигурации". Вкладки "Обзор" и "Топология" аналогичны соответствующим вкладкам геосервисов Pacemaker/Corosync.

На вкладке "Обзор" отображаются блоки с информацией о сервисах кластеров – компонентов геокластера. В каждом блоке представлены 2 таблицы: с параметрами кластера-компонента и с параметрами экземпляров сервиса на этом кластере-компоненте. Каждый блок содержит данные о площадке, имени кластера, версии PostgreSQL, порте подключения, количестве и статусе узлов и статусе сервиса.

Ниже следует блок со списком экземпляров сервиса с указанием:

  • роли;

  • узла, на котором расположен экземпляр сервиса;

  • IP-адреса;

  • текущего статуса;

  • Checkpoint (дата последней контрольной точки);

  • Write lag, s (время в секундах, прошедшее с момента сброса данных WAL на Primary-экземпляре (мастере) до записи на реплике);

  • Flush lag, s (время в секундах, прошедшее с момента сброса данных WAL на Primary-экземпляре (мастере) до сброса на диск реплики);

  • Replay lag, s (время в секундах, прошедшее с момента сброса данных WAL на Primary-экземпляре (мастере) до применения данных на реплике).

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

Блоки можно скрывать / отображать нажатием соответствующих элементов управления.

На вкладке "Топология" представлена топология экземпляров сервиса. По умолчанию экземпляры отображаются в свёрнутом виде.

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

При наведении курсора на значок image$icon info справа от наименования параметра появляется всплывающее сообщение с описанием выбранного параметра:

Заголовок вкладки "Конфигурации" имеет вид выпадающего списка, который содержит пункт перехода на страницу "Конфигурация PostgreSQL". На странице представлены параметры конфигурации PostgreSQL.

При наведении курсора на значок image$icon info справа от наименования параметра появляется всплывающая подсказка с описанием выбранного параметра.

Доступно поле быстрого поиска групп и параметров. Алгоритм быстрого поиска аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

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

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

Значения параметров на данной странице нередактируемы.

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

Заголовок вкладки "Конфигурации" для сервисов геокластеров Patroni имеет вид выпадающего списка, который содержит пункты перехода на соответствующие страницы данных:

  • Конфигурация PostgreSQL;

  • Аутентификация PostgreSQL;

  • Конфигурация pg_probackup;

  • Настройки Patroni;

  • Конфигурация аудита.

Параметры на всех страницах недоступны для редактирования.

Страница "Конфигурация PostgreSQL" содержит параметры конфигурации PostgreSQL для активной и резервной части. В остальном представление данных на страниице соответствует описанию аналогичной страницы для сервисов геокластеров Pacemaker/Corosync.

Страница "Аутентификация PostgreSQL" содержит параметры аутентификации PostgreSQL для активной и резервной части. В остальном представление данных на страниице соответствует описанию аналогичной страницы для сервисов в составе кластера (п. 6.5.2.3 настоящего Руководства).

Страница "Конфигурация pg_probackup" идентична одноимённой странице конфигурации сервисов в составе кластера, описанной в п. 6.5.2.3 настоящего Руководства.

На странице "Настройки Patroni" представлена таблица параметров настроек геосервиса и их значений. Порядок сортировки параметров и их значений можно изменить. Также доступен быстрый поиск параметров. Алгоритмы изменения порядка сортировки и быстрого поиска параметров аналогичны соответствующим алгоритмам для кластеров, представленным в п. 6.3.1 и п. 6.3.3 соответственно.

Все параметры сгруппированы в следующие группы:

  • Global;

  • Log;

  • Etcd или Etcdv3 (в зависимости от настроек кластера Patroni);

  • REST API;

  • CTL;

  • Watchdog;

  • Tags.

По умолчанию группы параметров свёрнуты. Чтобы свернуть / развернуть группу, используйте соответствующие элементы управления.

В столбце "Параметр" отображаются имя параметра и бейдж с источником значения параметра. Источники значений параметров определяются в следующем порядке: сначала проверяются переменные окружения (ENV), затем файл patroni.yml. Если значение не найдено ни в одном из этих источников, используется значение по умолчанию, определённое в Patroni.

Если параметры геосервиса активного кластера-компонента имеют на узлах разное значение, справа от имени соответствующих групп и параметров отображаются значки image$icon warning. При наведении курсора на значок появляется всплывающая подсказка.

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

  • Global → name;

  • REST API → listen;

  • REST API → connect_address.

На странице "Конфигурация аудита" представлены параметры конфигурации аудита активной части геосервиса. В остальном представление данных на страниице соответствует описанию аналогичной страницы для сервисов в составе кластера (п. 6.5.2.3 настоящего Руководства).

6.5.2.2 Вкладки для standalone-сервисов

Для standalone-сервисов вкладка "Обзор" является единственной. На вкладке представлены два блока:

  • Блок с общей информацией о сервисе: имя, каталог данных, каталог WAL, данные о площадке размещения и версии PostgreSQL.

  • Блок со списком экземпляров сервиса с указанием:

    • имени;

    • IP-адреса;

    • узла, на котором расположен экземпляр сервиса;

    • текущего статуса;

    • Checkpoint (дата последней контрольной точки в журнале предзаписи).

При наведении курсора на значок image$icon info появляется всплывающая подсказка с подробными данными о версии PostgreSQL.

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

Для запущенного standalone-сервиса доступны операции:

  • остановки;

  • удаления из "Спектра".

Для остановленного standalone-сервиса доступны операции:

  • запуска;

  • удаления;

  • удаления из "Спектра".

Описание операций остановки standalone-сервиса представлено в п. 11.12.2, запуска – в п. 11.12.3, удаления из "Спектра" – в п. 11.12.4, удаления – в п. 11.12.5.

6.5.2.3 Вкладки для сервисов в составе кластеров

Для сервисов в составе кластеров предусмотрены вкладки: "Обзор", "Топология", "Базы данных", "Резервные копии", "Мониторинг", "Диагностика" и "Конфигурации".

На вкладке "Обзор" представлены 3 блока:

  • Блок "История изменений":

    image$overview tab services

    • (1) поле выбора отображаемого периода, включающего поле вывода выбранного варианта и кнопку вызова диалога для задания периода (по умолчанию выбран вариант "Последние сутки"). Задать можно как произвольный период, указав дату начала и окончания, так и фиксированный, выбрав его из предложенных вариантов (например, Последние 5 мин);

    • (2) выпадающий список выбора периода обновления данных. Выбор возможен из следующего ряда: Выкл, 15с, 30с, 1м, 5м, 15м, 30м;

    • (3) линейные индикаторы ролей для каждого узла, с подписью имени узла (слева) и времени начальной и конечной точек (снизу). При наведении курсора на любой диапазон значения роли появляется всплывающая подсказка с текстом "В роли < роль > с <время начала DD.MM hh.mm> по < время завершения DD.MM hh.mm >";

    • (4) легенда.

  • Блок с общей информацией:

    • площадка и има кластера, на котором работает данный сервис;

    • порте подключения, порт PgBouncer (отображается при условии, что PgBouncer на выбранном сервисе установлен; значение порта PgBouncer на 1000 больше значения в поле "Порт". Информация о PgBouncer доступна только для сервисов кластеров Pacemaker/Corosync);

    • версия PostgreSQL (при наведении курсора на значок image$icon info появляется всплывающая подсказка с подробными данными о версии PostgreSQL).

  • Блок со списком экземпляров сервиса с указанием:

    • роли;

    • IP-адреса;

    • узла, на котором расположен экземпляр сервиса;

    • текущего статуса;

    • Checkpoint (дата последней контрольной точки в журнале предзаписи);

    • Write lag, s (время в секундах, прошедшее с момента сброса данных WAL на Primary-экземпляре (мастере) до записи на реплике);

    • Flush lag, s (время в секундах, прошедшее с момента сброса данных WAL на Primary-экземпляре (мастере) до сброса на диск реплики);

    • Replay lag, s (время в секундах, прошедшее с момента сброса данных WAL на Primary-экземпляре (мастере) до применения данных на реплике).

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

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

  • Операции для экземпляров сервисов кластеров Pacemaker/Corosync

    • Для Primary-экземпляра сервиса доступна операция остановки.

    • Для экземпляра синхронной реплики (Standby: SYNC) доступны операции:

      • остановки;

      • восстановления реплики с помощью pg_basebackup;

      • перемещения экземпляра сервиса с ролью "мастер" (Primary) на узел синхронной реплики (Standby: SYNC);

      • применения WAL.

        При остановке асинхронной реплики пункт меню "Переместить мастер на синхронную реплику" становится недоступен.

    • Для экземпляра асинхронной реплики (Standby: ASYNC) доступны операции:

      • остановки;

      • восстановления реплики с помощью pg_basebackup;

      • перемещения экземпляра сервиса с ролью "мастер" (Primary) на узел асинхронной реплики (Standby: ASYNC);

      • перемещения синхронной реплики (Standby: SYNC) на узел асинхронной реплики (Standby: ASYNC);

      • применения WAL.

    • Для остановленного экземпляра сервиса доступны операции:

      • запуска;

      • восстановления реплики с помощью pg_basebackup;

      • применения WAL.

  • Операции для экземпляров сервисов кластеров Patroni

    • Для экземпляра синхронной реплики (Standby: SYNC) доступны операции:

      • восстановления реплики;

      • перемещения экземпляра сервиса с ролью "мастер" (Primary) на узел синхронной реплики (Standby: SYNC).

    • Для экземпляра асинхронной реплики (Standby: ASYNC) доступны операции:

      • восстановления реплики;

      • перемещения экземпляра сервиса с ролью "мастер" (Primary) на узел асинхронной реплики (Standby: ASYNC);

      • перемещения синхронной реплики (Standby: SYNC) на узел асинхронной реплики (Standby: ASYNC).

        Выполнение операций остановки экземпляров сервиса представлено в п.11.12.1, запуска экземпляров сервиса – в п. 11.12.2, перемещения экземпляров сервисов между узлами – в п. 11.12.3, применения WAL - в п. 11.13, восстановления реплики с помощью pg_basebackup – в п. 11.14.1, восстановления реплики (для экземпляров сервисов кластеров Patroni) - в п. 11.14.2.

На вкладке "Топология" представлена топология экземпляров сервиса. По умолчанию окна с параметрами экземпляров отображаются в развёрнутом виде.

Используйте скрыть и подробнее, чтобы свернуть / развернуть окно основных параметров для экземпляров сервиса. При наведении курсора на значок image$icon info справа от наименования параметра появляется всплывающее сообщение с описанием выбранного параметра.

На вкладке "Базы данных" отображается таблица с подробной информацией о базах данных. В таблице представлены: имя и владелец БД, кодировка, размер БД, параметры локализации и табличное пространство.

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

Для баз данных в составе сервисов кластеров Pacemaker/Corosync возможны операции переименования и смены владельца. Описание операций представлено в пп. 12.1–12.2 соответственно.

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

Статус "НЕТ РОДИТЕЛЯ" означает, что резервная копия непригодна к использованию, так как её родительская копия повреждена или отсутствует.

Статус "ПОВРЕЖДЕНА" означает, что резервная копия повреждена и непригодна к использованию.

Справа в строке заголовков находится кнопка image$icon settings, при нажатии на которую открывается окно выбора отображаемых на вкладке столбцов:

  • Все (включает все столбцы);

  • Режим WAL;

  • Дата создания;

  • Recovery Time;

  • Длительность;

  • Дата завершения;

  • Площадка;

  • WAL;

  • Роль;

  • Timeline;

  • Zratio;

  • Размер;

  • Алгоритм сжатия;

  • Степень сжатия;

  • Исходный размер.

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

По умолчанию отображаются следующие столбцы: "ID", "Режим", "Режим WAL", "Роль", "Дата создания", "Recovery Time", "Длительность", "WAL", "Размер" и "Статус".

Столбцы "ID", "Режим" и "Статус" будут отображены всегда, в том числе в случае снятия в окне выбора всех флагов.

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

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

В правой верхней части вкладки "Резервные копии" находятся кнопки Создать и Создать standalone-сервис из РК (PITR). Описание операции создания резервной копии представлено в п.11.6.1, операции создания standalone-сервиса из РК (PITR) - в п. 11.7.

Для резервных копий доступны кнопки ⋮ для вызова меню со списком возможных операций. Меню операций также вызывается нажатием правой кнопки мыши в пределах соответствующей строки таблицы. Доступны операции восстановления, проверки целостности и удаления резервных копий. Описание операций представлено в п. 11.6.3-11.6.5.

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

Для расписаний отображаются: имя, роль экземпляра сервиса, на котором будут создаваться резервные копии, метод и метод WAL резервных копий, тип, график и статус. Справа от статуса расписаний находится кнопка управления просмотром логов image$icon view logs. При нажатии на данную кнопку вызывается всплывающее окно "Логи расписания":

image$schedule logs

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

Для расписаний доступны кнопки ⋮ для вызова меню со списком возможных операций. Меню операций также вызывается нажатием правой кнопки мыши в пределах соответствующей строки таблицы. Возможны операции выключения / включения, изменения и удаления. Данные операции описаны в п. 11.6.6.

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

image$monitoring tab

Если при установке "Спектра" не был введен корректный IP-адрес, по которому доступно ПО "Скала^р Визион", отображение данных мониторинга узлов будет недоступно. В полях для графиков будет отображаться "Нет данных".

Заголовок вкладки "Диагностика" имеет вид выпадающего списка, который содержит следующие пункты перехода на соответствующие страницы данных: "Отчеты PgBadger" и "Отчеты collect.sh"

Страница "Отчеты PgBadger" содержит таблицу со списком имеющихся отчётов, сформированных модулем PgBadger. Таблица состоит из столбцов "Отчет", "Дата", "Узел". Отчёты отсортированы по времени создания в обратном порядке - последние сверху.

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

image$overwiew report

Страницы отчетов видны только в том случае, если открыта какая-либо страница "Спектра" и выполнена авторизация пользователя.

На странице доступен быстрый поиск отчётов. Алгоритм быстрого поиска отчётов аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

В нижней части страницы расположена панель пагинации. Справа вверху страницы находится кнопка Создать. Создание отчётов PgBadger представлено в п.11.8.

На странице "Отчеты collect.sh" представлена таблица со списком имеющихся отчётов collect.sh. Таблица состоит из столбцов "Отчет" и "Дата". Отчёты отсортированы по времени создания в обратном порядке - последние сверху. При нажатии на имя отчёта будет вызван стандартный интерфейс браузера для сохранения файлов. Файл отчёта имеет формат zip.

Доступен быстрый поиск отчётов. Алгоритм быстрого поиска отчётов аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

В нижней части страницы расположена панель пагинации. Справа вверху страницы находится кнопка Создать. Создание отчётов collect.sh представлено в п. 11.9.

Заголовок вкладки "Конфигурации" имеет вид выпадающего списка, который содержит пункты перехода на соответствующие страницы данных.

Для сервисов кластеров Pacemaker/Corosync:

  • Конфигурация PostgreSQL;

  • Аутентификация PostgreSQL;

  • Конфигурация pg_probackup;

  • Конфигурация сервиса;

  • Конфигурация аудита;

  • PgBouncer.

Для сервисов кластеров Patroni:

  • Конфигурация PostgreSQL;

  • Аутентификация PostgreSQL;

  • Конфигурация сервиса;

  • Конфигурация аудита.

На странице "Конфигурация PostgreSQL" представлены параметры конфигурации PostgreSQL и доступно поле быстрого поиска групп и параметров. Алгоритм быстрого поиска конфигураций аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

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

Все параметры заполнены значениями, полученными из конфигурационного файла.

При наведении курсора на значок image$icon info справа от наименования параметра появляется всплывающая подсказка с описанием выбранного параметра.

Для параметров конфигурации PostgreSQL кластеров Patroni отображаются бейджи с указанием источника получения данных:

image$badge

Источники получения данных могут быть следующие:

Бейдж Источник

Local

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

Patroni

Единый источник конфигурации для кластера DCS (Distributed Configuration Store, распределённое хранилище ключ-значение)

default

Параметры PostgreSQL по умолчанию

session

Значение установлено в текущей сессии при помощи команды SET

override

Значение принудительно установлено сервером PostgreSQL и не может быть изменено пользователем

database

Значение задано для конкретной базы данных при помощи команды ALTER DATABASE …​ SET …​

client

Значение передано клиентом при установке соединения

user

Значение задано для конкретного пользователя при помощи команды ALTER ROLE …​ SET …​

database user

Значение задано для конкретного пользователя и базы данных при помощи команды ALTER ROLE …​ IN DATABASE …​ SET …​

environment variable

Значение параметра задано в переменной окружения

Patroni YAML

Конфигурационный файл patroni.jaml

Patroni system

Параметры, устанавливаемые Patroni, необходимые для его корректной работы

На панели управления конфигурациями расположены кнопки управления изменениями параметров конфигураций: image$icon reset — сброс к значениям до редактирования, и Применить. По умолчанию кнопки неактивны.

Изменение параметров конфигурации PostgreSQL описано в п. 11.15.

На странице "Аутентификация PostgreSQL" представлены параметры конфигураций аутентификации PostgreSQL. Все параметры заполнены значениями, полученными из конфигурационного файла:

  • Type;

  • Database;

  • User;

  • Address;

  • Method.

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

Кнопка + Добавить предназначена для добавления нового параметра аутентификации.

Кнопки image$icon delete служат для удаления неиспользуемых параметров.

В правом верхнем углу страницы расположены кнопки управления изменениями параметров аутентификации image$icon reset (сброс к значениям до редактирования) и Применить. По умолчанию кнопки неактивны.

Изменение параметров аутентификации PostgreSQL описано в п. 11.16.

На странице "Конфигурация pg_probackup" отображаются параметры pg_probackup и их значения.

Для сервисов кластеров Patroni страница pg_probackup недоступна.

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

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

В правом верхнем углу страницы расположены кнопки управления изменениями параметров конфигурации image$icon reset (сброс к значениям до редактирования) и Применить. По умолчанию кнопки неактивны.

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

На странице "Конфигурация сервиса" содержатся параметры сервиса, полученные из системы управления кластерным ПО (пример для сервиса кластера Pacemaker/Corosync).

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

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

На странице доступен быстрый поиск параметров аудита. Алгоритм быстрого поиска аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

Кнопка Изменить предназначена для создания / изменения правил аудита. Порядок создания / изменения правил аудита представлен в п. 11.18.

В нижней части страницы расположена панель пагинации.

На странице "PgBouncer" отображаются параметры PgBouncer.

Для сервисов кластеров Patroni страница PgBouncer недоступна.

По умолчанию у сервисов PgBouncer отсутствует. Страница "PgBouncer" отображается пустой. Если для выбранного сервиса PgBouncer был добавлен, на странице отображается список параметров PgBouncer:

image$pgbouncer settings

При наведении курсора на значок image$icon info справа от наименования параметра появляется всплывающая подсказка с описанием выбранного параметра.

На странице доступен быстрый поиск параметров PgBouncer. Алгоритм быстрого поиска аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

Добавление PgBouncer представлено в п. 11.19.1, изменение параметров – в п. 11.19.2, удаление PgBouncer – в п. 11.19.3.

6.5.3 Операции с сервисами

Меню операций с сервисом вызывается либо нажатием правой кнопки мыши в границах соответствующей сервису строки таблицы, либо нажатием соответствующей кнопки ⋮.

6.5.3.1 Операции для сервисов Pacemaker/Corosync

  • Для сервиса со статусом "ДОСТУПЕН" допустимы операции остановки, перезапуска, создания резервной копии, создания standalone-сервиса, создания standalone-сервиса из РК (PITR), создания отчета PgBadger и добавления PgBouncer. Для сервисов со статусом "ДОСТУПЕН" с установленным PgBouncer, вместо операции добавления, доступны операции редактирования и удаления PgBouncer. Для сервиса со статусом "ДОСТУПЕН", для которого изменены параметры конфигурации и/или аутентификации PostgreSQL, требующие для применения перезагрузки конфигурации (отображается индикатор image$icon reload), дополнительно доступна операция перезагрузки конфигурации.

  • Для сервиса со статусом "НЕДОСТУПЕН" возможны операции создания отчета PgBadger и удаления. Для сервисов в статусе "НЕДОСТУПЕН", которые имеют указанный статус по причине остановки кластера, все пункты меню недоступны.

  • Для сервиса со статусом "ОСТАНОВЛЕН" доступны операции запуска, создания отчета PgBadger и удаления.

  • Для сервиса в статусе "ДЕГРАДИРОВАН", имеющего данный статус вследствие остановки или вывода одного из узлов кластера в режим standby, доступны операции остановки, перезапуска, выполнения pg_repack, создания резервной копии, создания отчета PgBadger, создания отчета collect.sh, создания standalone-сервиса и создания standalone-сервиса из РК (PITR).

  • Для сервиса в статусе "ДЕГРАДИРОВАН", имеющего данный статус вследствие вывода одного из узлов кластера в режим maintenance, доступны операции создания резервной копии, выполнения pg_repack, создания отчета PgBadger, создания отчета collect.sh, создания standalone-сервиса и создания standalone-сервиса из РК (PITR).

  • Для сервиса со статусом "ОШИБКА" доступна операция создания резервной копии (только в том случае, когда сервис имеет хотя бы один рабочий экземпляр с ролью Primary, SYNC или ASYNC).

  • Для сервиса со статусом "НЕТ ДАННЫХ" все пункты меню недоступны.

  • Для standalone-сервиса со статусом "ЗАПУЩЕН" доступны операции остановки и удаления из "Спектра".

  • Для standalone-сервиса со статусом "ОСТАНОВЛЕН" доступны операции запуска, удаления и удаления из "Спектра".

  • Для сервисов геокластеров операции недоступны.

6.5.3.2 Операции для сервисов Patroni

  • Для сервисов со статусами "ДОСТУПЕН" и "ДЕГРАДИРОВАН" возможны операции перезапуска, создания резервной копии и создания резервной копии из РК (PITR).

  • Для сервисов со статусами "НЕДОСТУПЕН", "ОБСЛУЖИВАНИЕ" и "ОШИБКА" доступных операций нет, кнопка ⋮ вызова меню действий отсутствует.

6.6 Раздел "Операции"

При выборе раздела ИСТОРИЯ  Операции открывается страница, на которой отображается список выполняемых и ранее выполненных операций. Для операций указаны их наименование, статус, имя объекта, дата запуска и дата завершения.

Для разных кластеров возможен параллельный запуск операций.

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

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

При некритических ошибках в задачах операция будет иметь жёлтый статус "ЗАВЕРШЕНА".

При нажатии кнопки image$icon view logs справа от статуса задачи открывается окно просмотра логов выбранной задачи.

Если задача завершена с ошибкой, то в окне просмотра появляется вкладка "Ошибки" с информацией об ошибке:

image$error example

Для сохранения логов или описания ошибки в файл нужно нажать кнопку Скачать.

Для операций перемещения ролей экземпляров сервисов между узлами возможен перезапуск:

image$restarting operation

Процедура перезапуска данного типа операций описана в п. 8.7.

В нижней части страницы "Операции" расположена панель пагинации.

6.7 Раздел "События"

При выборе раздела ИСТОРИЯ  События происходит переход на соответствующую страницу, на которой отображаются события, их важность, источник, объект и дата.

При нажатии на имя объекта, в зависимости от объекта события, происходит переход:

  • на страницу "Мониторинг" соответствующего узла, если событие относится к узлу;

  • на страницу "Обзор" соответствующего сервиса, если событие относится к сервису.

В нижней части страницы "События" расположена панель пагинации.

6.8 Раздел "pgAdmin"

При выборе раздела ПРОЧИЕ РЕСУРСЫ  PgAdmin происходит переход к странице авторизации в ПО pgAdmin.

6.9 Статус "Спектра"

В левой панели, под навигационным блоком левого меню и над кнопкой Настройки, расположен значок “Статус Спектра”.

Нормальное состояние системы – все компоненты включены, ему соответствует статус в виде значка image$icon green check mark. При наведении курсора на значок отображается всплывающее сообщение, поясняющее статус. При нажатии на значок появляется окно детализации статуса "Состояние компонентов" с набором основных компонентов "Спектра" с отображением их статуса:

  • API Спектра;

  • БД Спектра;

  • Сервис выполнения задач;

  • Планировщик.

Если компонент включён, ему соответствует статус в виде значка image$icon green check mark.

Если какой-либо компонент выключен, ему соответствует статус в виде значка image$icon red cross. Статус "Спектра" при этом отображается в виде значка image$icon reload.

При наведении курсора на значок image$icon reload отображается всплывающее сообщение, поясняющее статус.

Если нет доступа к API "Спектра", то статус "Спектра" отображается в виде значка image$icon red cross.

6.10 Раздел "Настройки"

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

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

Для изменения отображения даты (часового пояса) нужно нажать ссоответствующую кнопку Сервера или Клиента.

В блоке "О программе" отображается номер версии "Спектра".

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

6.10.1 Управление площадками

В блоке "Площадки" возможны поиск, создание, переименование и удаление площадок.

В левой части блока расположено поле поиска. Алгоритм быстрого поиска площадок аналогичен соответствующему алгоритму для кластеров, представленному в п. 6.3.3.

Меню операций с площадкой вызывается либо нажатием правой кнопки мыши в границах соответствующей площадке строки таблицы, либо нажатием соответствующей кнопки ⋮.

6.10.1.1 Добавление площадок

  1. Нажать кнопку Добавить площадку в правой верхней части блока "Площадки".

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

В верхней строке таблицы операций отображается операция формирования отчёта и статус её выполнения.

Если выполнение операции прошло успешно:

  • статусы всех задач операции – "ВЫПОЛНЕНА";

  • созданная площадка отображается в списке в блоке "Площадки".

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

6.10.1.2 Переименование площадок

  1. Нажать соответствующую переименовываемой площадке кнопку ⋮ и выбрать пункт "Переименовать площадку".

  2. В окне "Переименование площадки" ввести новое имя площадки и нажать кнопку Переименовать.

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

Если выполнение операции прошло успешно:

  • статусы всех задач операции – "ВЫПОЛНЕНА";

  • имя площадки соответствует введённому на шаге 2.

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

6.10.1.3 Удаление площадок

  1. Нажать соответствующую удаляемой площадке кнопку ⋮ и выбрать пункт "Удалить площадку".

  2. В окне подтверждения нажать кнопку Удалить.

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

    Если выполнение операции прошло успешно, статусы всех задач операции – "ВЫПОЛНЕНА":

  3. Убедиться, что в списке площадок удалённая площадка не отображается.

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

  1. Площадка является в системе единственной;

  2. На площадке находятся импортированные в "Спектр" кластеры.

В этих случаях пункт меню "Удалить площадку" будет недоступен.

6.10.2 Создание и просмотр диагностических отчетов

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

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

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

Пример содержимого файла отчёта:

image$sample report

Для создания нового отчета нужно нажать кнопку Создать. Откроется окно, где необходимо подтвердить операцию.

В отличие от прочих операций, создание отчета доступно и для пользователей с ролью "только чтение" (spectrum-ro).

Нажать кнопку Создать.

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

Если выполнение операции создания диагностического отчета прошло успешно:

  • статусы всех задач операции – "ВЫПОЛНЕНА":

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