Cluster config

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

Страница Cluster config

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

  • Зайдите во вкладку «clusters» рабочего пространства и нажмите на меню кластера («три точки»). Выберите пункт «Configuration».

  • Зайдите во вкладку «Configuration» инстанса кластера из бокового меню. Вверху открывшейся страницы перейдите по ссылке «cluster config.page».

Памятка с информацией о настройках

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

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

  2. Конфигурация PostgreSQL в кластере Patroni хранится:

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

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

  • иконка слоника - этот параметр задан на уровне настроек СУБД;

  • иконка квадратик и три точки - этот параметр хранится в DCS Patroni.

  1. Если параметр СУБД задан только в одном инстансе, то этот параметр не будет отображен на данной странице. Для просмотра значения параметра в каждом инстансе используйте страницу Instance Configuration.

  2. Интерфейс корректно работает с Patroni не менее версии 3.0.4.

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

Параметры настроек

После закрытия модального окна будет видна сама страница Cluster Config:

  1. На экране будут две вкладки:

  • PATRONI PARAMS - страница с параметрами Patroni

  • POSTGRESQL PARAMS - страница с параметрами PostgreSQL

  1. Параметры вкладок можно искать по названиям с помощью поисковой строки и сортировать по определённым критериям с помощью фильтров.

    Фильтры, которые есть на обеих вкладках:

  • Value status («Статус значения»). Имеет следующие значения:

    • «DEFAULT» («По умолчанию»)

    • «RECOMMENDED» («Рекомендуемые»)

    • «CHANGED APPLIED» («Изменено, применено»)

    • «CHANGED PENDING RELOAD» («Изменено, требуется перечитывание конфигурации»)

    • «CHANGED PENDING RESTART» («Изменено, требуется перезагрузка экземпляра»)

    Фильтры, которые есть только на вкладке POSTGRESQL PARAMS:

  • Type of parametrs («Тип параметра»). Имеет следующие значения:

    • «Patroni only» («только Patroni параметры»)

    • «PostgreSQL only» («только PostgreSQL параметры»

  • Category («Категория»). Имеет следующие значения:

    • «Autovacuum» («Автовакуум»)

    • «Connection Defaults / Locale and Formatting» («Параметры подключения по умолчанию/Язык и форматирование»)

    • «Client Connection Defaults / Other Defaults» («Настройки клиентского подключения по умолчанию/Другие настройки по умолчанию»)

    • «Client Connection Defaults / Shared Library Preloading» («Настройки клиентского подключения по умолчанию/Предварительная загрузка общей библиотеки»)

    • «Client Connection Defaults / Statement Behavior» («Настройки клиентского соединения по умолчанию/поведение операторов»)

    • «Connections and Authentication / Authentication» («Подключения и аутентификация/Аутентификация»)

    • «Connections and Authentication / Connection Settings» («Подключения и аутентификация/Настройки подключения»)

    • «Connections and Authentication / SSL» («Подключения и аутентификация/SSL»)

    • «Customized Options» («Индивидуальные параметры»)

    • «Developer Options» («Опции разработчика»)

    • «Error Handling» («Обработка ошибок»)

    • «File Locations» («Местоположение файлов»)

    • «Lock Management» («Управление блокировками»)

    • «Preset Options» («Предустановленные параметры»)

    • «Query Tuning / Genetic Query Optimizer» («Настройка запросов/генетический оптимизатор запросов»)

    • «Replication / Sending Servers» («Серверы репликации/отправки»)

    • «Replication / Standby Servers» («Репликация/Резервные серверы»)

    • «Replication / Subscribers» («Репликация/Абоненты»)

    • «Reporting and Logging / What to Log» («Отчетность и логирование / Что логировать»)

    • «Reporting and Logging / When to Log» («Отчетность и логирование / Когда логировать»)

    • «Reporting and Logging / Where to Log» («Отчетность и логирование / Куда логировать»)

    • «Resource Usage / Disk» («Использование ресурсов/Диск»)

    • « Resource Usage / Background Writer» («Использование ресурсов / Фоновый писатель»)

    • «Resource Usage / Cost-Based Vacuum Delay» («Использование ресурсов / Задержка вакуумирования на основе стоимости»)

    • «Resource Usage / Kernel Resources» («Использование ресурсов/Ресурсы ядра»)

    • «Resource Usage / Memory» («Использование ресурсов/Памяти»)

    • «Statistics / Cumulative Query and Index Statistics» («Статистика/Совокупная статистика запросов и индексов»)

    • «Statistics / Monitoring» («Статистика/Мониторинг»)

    • «Version and Platform Compatibility / Other Platforms and Clients» («Совместимость версий и платформ / Другие платформы и клиенты»)

    • «Version and Platform Compatibility / Previous PostgreSQL Versions» («Совместимость версий и платформ / Предыдущие версии PostgreSQL»)

    • «Write-Ahead Log / Archive Recovery» («Восстановление журнала/архива с упреждающей записью»)

    • «Write-Ahead Log / Recovery» («Журнал упреждающей записи/Восстановление»)

    • «Write-Ahead Log / Recovery Target» («Журнал упреждающей записи/Цель восстановления»)

    • «Write-Ahead Log / Settings» («Журнал упреждающей записи/Настройки»)

  1. Рядом с кнопкой «Filter» во вкладке POSTGRESQL PARAMS есть настройка «Tune», включающая два параметра:

  • Disk type:

    • SSD («Твердотельный накопитель»)

    • HDD («Жёсткий диск»)

    • Network storage («Сетевое хранилище»)

  • Load profile («Профиль нагрузки»). В данном релизе нельзя менять этот параметр.

Каждый параметр имеет собственное описание. Во вкладке POSTGRESQL PARAMS (во вкладке PATRONI PARAMS такой опции пока нет) его можно посмотреть при помощи щелчка мыши по восклицательному знаку рядом с параметром. Ниже представлен пример:

В столбце «Current value» («Текущее значение») представлены значения параметров на данный момент.

В столбце «Change current value to recommended» («Смените значение на рекомендуемое») представлены рекомендуемые значения параметров для конфигурации (пока только во вкладке POSTGRESQL PARAMS). Слева стоят значки:

  • Зелёный, с галочкой - показывает, что текущее значение параметра соответствует рекомендуемому.

  • Значок с красной стрелочкой влево - позволяет одним кликом изменить текущее значение на рекомендуемое.

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

Есть четыре типа окна для изменения параметра:

  • Для параметра типа перечисления будет выбор с возможными опциями.

  • Для числовых параметров идёт проверка диапазона чисел:

  • Параметр строкового типа может быть представлен любым текстовым значением:

  • Параметр булевого типа имеет выбор из двух значений:

После изменения каждого параметра можно нажать кнопку «Cancel» - отменить изменение или кнопку «Save» - сохранить изменение.

Внимание

В целях избежания невалидных значений параметров и, как следствие, нерабочего экрана Cluster Config и невозможности подключения новых инстансов Patroni в рамках одного кластера в Платформе запрещено изменение параметров, значения которых представляют собой сложные структурой данных (массив, вложенный JSON/словарь). Ниже представлены эти параметры:

  • pg_ident

  • pg_nba

  • ignore_slots

  • slots

  • pause