Cluster config

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

Страница Cluster config

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

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

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

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

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

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

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

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

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

  • Параметры Patroni - страница с параметрами Patroni;

  • Параметры PostgreSQL - страница с параметрами PostgreSQL.

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

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

  • Статус значения. Имеет следующие значения:

    • Имеет рекомендуемое значение

    • Не по умолчанию

    • Изменённые значения

    • Изменения ожидают перезагрузки

    • Изменения ожидают перезапуска

Фильтры, которые есть только на вкладке «Параметры PostgreSQL»:

  • Тип параметра. Имеет следующие значения:

    • Только Patroni

    • Только PostgreSQL

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

    • «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» («Настройка запросов / Генетический оптимизатор запросов»)

    • «Query Tuning / Other Query options» («Настройка запросов / Другие варианты запроса»)

    • «Query Tuning / Planner Cost Constants» («Настройка запросов / Константы затрат планировщика»)

    • «Query Tuning / Planner Method Configuration» («Настройка запросов / Конфигурация метода Lanner»)

    • «Replication / Primary Server» («Серверы репликации / Основной сервер»)

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

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

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

    • «Reporting and Logging / Process Title» («Отчетность и логирование / Название процесса»)

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

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

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

    • «Resource Usage / Asynchronous Behavior» («Использование ресурсов / Асинхронное поведение»)

    • «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 / Archiving» («Журнал упреждающей записи / архивирование»)

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

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

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

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

Рядом с иконкой фильтра во вкладке «Параметры PostgreSQL» есть настройки (иконка обведена на рисунке ниже), включающие следующие параметры:

  1. Тип управления нагрузкой:

  • Ручная настройка

  • Автоматическая настройка

  1. Тип нагрузки:

  • OLAP

  • OLTP

  • Mixed

  • ERP1C

  1. Тип диска:

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

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

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

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

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

В столбце «Рекомендуемые значения» представлены рекомендуемые значения параметров для конфигурации (пока только во вкладке «Параметры PostgreSQL»). Слева могут стоять значки двух типов:

  • «=» - показывает, что текущее значение параметра соответствует рекомендуемому, при нажатии на него значение данного параметра можно поменять на последнее самостоятельно устанавливаемое значение, не равное рекомендуемому.

  • «!=» - показывает, что текущее значение параметра не соответствует рекомендуемому, при нажатии на него значение данного параметра можно поменять на равное рекомендуемому.

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

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

  • У параметров булевого типа есть всего два варианта значения: on и off.

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

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

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

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

Для применения изменённых настроек нажмите на кнопку «Применить новые настройки» (цифра 1 на рисунке ниже).

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

Если же значение ожидает перезапуска кластера (цифра 3 на рисунке выше) - нажмите кнопку «Применить и перезагрузить базу данных» (цифра 4 на рисунке выше), а затем перезапустите кластер Postgres с помощью окна командной строки.

Внимание

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

  • pg_ident

  • pg_nba

  • ignore_slots

  • slots

  • pause