Конфигурационные параметры
В этом разделе описаны параметры, которые могут быть настроены для сервисов ADPG через ADCM. Получить дополнительную информацию по процессу настройки конфигурационных параметров можно в статье Настройка сервисов.
ПРИМЕЧАНИЕ
Некоторые из перечисленных параметров становятся доступны в UI ADCM после установки флага Show advanced.
|
ADPG
Параметр | Описание | Значение по умолчанию |
---|---|---|
Data directory |
Директории, используемые для хранения данных на хостах кластера ADPG |
/pg_data1 |
Sysctl parameters
В этом разделе описываются параметры ядра Linux. Для добавления нового параметра кликните дочернюю ноду Add property у опции Sysctl parameters [key:value].

В появившемся окне укажите название и значение параметра и нажмите Apply.

Вы можете добавить несколько параметров.
External Etcd cluster
ADPG использует etcd в качестве распределенного хранилища конфигурации Patroni (Distributed Configuration Store, DCS). Если вы используете внешний кластер etcd, переведите соответствующий переключатель в положение активен, раскройте ноду External Etcd [ip_address:port] и нажмите Add property.

В появившемся окне укажите IP-адрес etcd-сервера в первой строке и порт во второй.

Вы можете добавить несколько серверов etcd.
Enable PgBouncer
Чтобы использовать PgBouncer, активируйте переключатель Enable PgBouncer. Когда этот переключатель включен, вы можете развернуть соответствующую ноду и указать настройки, перечисленные в таблице ниже.

Параметр | Описание | Значение по умолчанию |
---|---|---|
listen_port |
Порт, который прослушивает PgBouncer. Этот порт нельзя поменять у работающего кластера. Необходимо выполнить Reconfigure & Restart для того, чтобы применить изменения |
15432 |
pool_mode |
Указывает, когда соединение с сервером может быть повторно использовано другими клиентами. Может содержать следующие значения:
|
session |
max_client_conn |
Максимально разрешенное количество клиентских подключений |
100 |
default_pool_size |
Количество подключений к серверу, разрешенное для каждой пары пользователь/база данных |
20 |
min_pool_size |
Минимальное количество подключений к серверу, которое должно находиться в пуле |
0 |
reserve_pool_size |
Количество дополнительных подключений, разрешенных для пула, если клиентское соединение превышает время, указанное в опции |
0 |
reserve_pool_timeout |
Если клиенту необходимо ждать дольше указанного времени в секундах, используются дополнительные соединения из |
5 |
max_db_connections |
Максимальное количество подключений к серверу для базы данных |
0 |
max_user_connections |
Максимальное количество подключений к серверу для пользователя |
0 |
Enable all users |
Если эта опция включена, разрешается доступ всем пользователям с аутентификацией по паролю. Если опция отключена, необходимо указать имена пользователей в параметре |
Enabled |
Users list |
Список пользователей, которым разрешен доступ к ADPG с помощью PgBouncer, когда опция |
Empty |
Enable all databases |
Если эта опция включена, разрешается доступ ко всем существующим базам данных через PgBouncer. Если опция отключена, необходимо указать имена баз данных в параметре |
Enabled |
Databases list |
Список баз данных, к которым разрешен доступ с помощью PgBouncer, когда опция |
Empty |
Use custom pg_hba.conf |
Если эта опция отключена, для PgBouncer используется основная секция PG_HBA сервиса ADPG. Если опция включена, необходимо указать настройки для PgBouncer в параметре Custom pg_hba.conf. В этом случае PgBouncer будет использовать настройки из Custom pg_hba.conf |
Disabled |
Custom pg_hba.conf |
Пользовательская секция pg_hba.conf для PgBouncer |
Empty |
После того как вы укажете необходимые настройки, кликните Save и выполните действие Reconfigure & Restart, чтобы применить изменения.
Enable backups
Чтобы включить создание бэкапов с помощью утилиты pgBackRest
, активируйте переключатель Enable backups. После этого вы сможете развернуть ноду Enable backups и указать настройки, перечисленные в таблице ниже. Обратите внимание, что параметры S3 имеют эффект, только если для параметра Repo type
установлено значение s3
.

Параметр | Описание | Значение по умолчанию |
---|---|---|
Archive timeout(s) |
Время ожидания (в секундах) перед принудительным переключением на следующий файл WAL |
1800 |
Backup stanza |
Название текущей станзы. Станза создается с указанным именем и добавленным префиксом: |
— |
Backup repo |
Путь к репозиторию, в котором |
— |
Repo type |
Тип хранилища. Можно использовать следующие значения:
|
posix |
S3 URI style |
Стиль написания S3 URI. Поддерживаются следующие стили:
|
path |
S3 Region |
Регион репозитория S3, в котором был создан бакет |
— |
S3 Bucket |
S3-бакет, используемый для хранения репозитория с резервными копиями |
— |
S3 Endpoint |
Конечная точка репозитория S3. Конечная точка должна быть валидна для указанного региона |
— |
S3 Key |
Ключ доступа к репозиторию S3, используемый для доступа к бакету |
— |
S3 Key Secret |
Секретный ключ доступа к репозиторию S3, используемый для доступа к бакету |
— |
Retention full type |
Можно выбрать, будет ли использоваться время (дни) или число для определения срока хранения бэкапов.
|
count |
Retention full |
Количество полных бэкапов, которые необходимо сохранить, или количество дней, в течение которых будет храниться каждый полный бэкап, в зависимости от параметра |
7 |
Retention diff |
Количество сохраняемых дифференциальных бэкапов |
— |
Enable compression |
Включает сжатие бэкапов |
false |
Compress type |
Тип сжатия бэкапов. Можно использовать одно из следующих значений: |
gz |
Compress level |
Уровень сжатия файла (от |
Следующие уровни сжатия используются по умолчанию в зависимости от значения параметра
|
Log path |
Путь к каталогу c log-файлами |
/var/log/adpg16-pgbackrest |
Log level |
Уровень логирования сообщений, записываемых в log-файлы. Возможные значения: |
info |
Use custom config |
Если этот флажок установлен, все конфигурационные параметры |
false |
Global options |
Настройки для добавления в раздел |
— |
Custom options |
Настройки для добавления в конфигурационный файл pgBackRest |
— |
ПРИМЕЧАНИЕ
Если вы устанавливаете флаг Use custom config и задаете кастомные настройки pgBackRest , ADPG записывает эти настройки в конфигурационный файл pgBackRest без проверки. В случае некорректных настроек сообщение об ошибке не будет выведено в интерфейсе ADCM. Вам необходимо самостоятельно убедиться, что настройки верные, а папка для хранения бэкапов существует и доступна.
|
За дополнительной информацией обратитесь к статье Резервное копирование и восстановление с использованием pgBackRest.
Enable Patroni basic auth
Чтобы включить базовую аутентификацию Patroni для Patroni REST API, активируйте переключатель Enable Patroni basic auth. После этого вы сможете развернуть ноду Enable Patroni basic auth и указать настройки, перечисленные в таблице ниже.
Параметр | Описание | Значение по умолчанию |
---|---|---|
username |
Имя пользователя для базовой аутентификации Patroni ( |
— |
password |
Пароль пользователя для базовой аутентификации Patroni ( |
— |
Если вы включили Enable Patroni basic auth для существующего кластера, выполните действие Reconfigure & Restart сервиса ADPG.
После включения Patroni Basic auth для небезопасных (POST) вызовов Patroni необходима аутентификация, но безопасные (GET) вызовы будут обрабатываться без нее.
Patroni ADPG configurations
В этом разделе описываются параметры конфигурации Patroni, которые можно изменить в пользовательском интерфейсе ADCM. Для получения дополнительной информации об этих настройках обратитесь к статье ADPG High Availability overview. После того как вы изменили значения параметров, необходимо выполнить действие сервиса ADPG Reconfigure & Restart, чтобы применить изменения.
Параметр | Описание | Значение по умолчанию |
---|---|---|
synchronous_mode |
Активирует режим синхронной репликации Patroni |
false |
synchronous_node_count |
Указывает количество синхронных резервных нод. Значение параметра не должно превышать количество хостов с установленным компонентом ADPG сервиса ADPG. Этот параметр игнорируется, если |
1 |
synchronous_mode_strict |
Не позволяет Patroni отключать синхронную репликацию на первичном сервере, когда нет доступных синхронных резервных кандидатов. Включите |
false |
maximum_lag_on_failover |
Указывает количество транзакций в байтах, которые могут быть потеряны |
1048576 |
ttl |
TTL для получения блокировки лидера (в секундах). Определяет продолжительность времени перед автоматическим запуском failover-процесса |
30 |
loop_wait |
Количество времени, в течение которого Patroni находится в спящем режиме, прежде чем начать новую итерацию цикла обработки событий (в секундах) |
10 |
retry_timeout |
Время ожидания для повторных попыток операций DCS и PostgreSQL (в секундах). Задержки с продолжительностью меньше указанного значения не приводят к переизбранию лидера со стороны Patroni |
10 |
patroni_listen_port |
Порт, который прослушивается Patroni для выполнения REST API. Можно изменить только до установки сервиса ADPG |
8008 |
use_custom_patroni_log_dir |
Если этот параметр включен, вы можете указать собственные настройки Patroni |
false |
patroni_log_dir |
Существующая папка для хранения логов Patroni. Параметр имеет эффект только в том случае, если для параметра |
/var/log/adpg16-patroni |
patroni_log_file_size |
Максимальный размер одного файла лога Patroni в байтах. Параметр имеет эффект только в том случае, если для параметра |
25000000 |
patroni_log_file_num |
Количество файлов журнала, которые необходимо хранить. Параметр имеет эффект только в том случае, если для параметра |
4 |
patroni_log_level |
Уровень логирования. Может принимать следующие значения: |
info |
Patroni ADPG tags
Раздел Patroni ADPG tags позволяет использовать теги Patroni. Он становится видимым в пользовательском интерфейсе ADCM после активации переключателя Show advanced. Используйте конфиг-группы ADCM, чтобы назначать теги Patroni отдельным хостам.
Имя тега | Описание | Значение по умолчанию |
---|---|---|
clonefrom |
Если установлено значение |
false |
noloadbalance |
Если установлено значение |
false |
replicatefrom |
Имя другой реплики, с которой выполняется репликация. Используется для поддержки каскадной репликации |
Значение не установлено (тип string) |
nosync |
Если установлено значение |
false |
nofailover |
Контролирует, разрешено ли этой ноде участвовать в выборах лидера и стать лидером. Значение |
false |
failover_priority |
Управляет приоритетом ноды во время аварийного переключения (failover). Ноды с более высоким приоритетом будут иметь преимущество перед нодами с более низким приоритетом, если они получили/воспроизвели одинаковое количество WAL. Однако ноды с более высокими значениями приема/воспроизведения LSN являются предпочтительными независимо от их приоритета. Если |
Значение не установлено (тип integer) |
nostream |
Если установлено значение |
false |
ADPG configurations
Раздел ADPG Configurations содержит ноды postgresql.conf и Custom postgresql.conf. Настройки из поля Custom postgresql.conf имеют более высокий приоритет, чем параметры, указанные в postgresql.conf, и могут быть применены к определенным хостам с сервисом ADPG на основании конфиг-групп ADCM.

postgresql.conf
Текстовое поле postgresql.conf позволяет определить содержимое файла postgresql.conf (путь по умолчанию /pg_data1/adpg16/postgresql.conf). Параметры конфигурации, установленные в этом поле, будут применяться ко всем нодам ADPG. Чтобы перейти в режим редактирования, кликните postgresql.conf в дереве Configuration.

В появившемся окне укажите требуемые параметры и нажмите Apply.
Для редактирования файла postgresql.conf необходимо использовать ADCM. Это связано с тем, что когда сервис ADPG выполняет действие Reconfigure & Restart, файл postgresql.conf перезаписывается с настройками, указанными в поле postgresql.conf. Если вы изменили файл postgresql.conf напрямую, эти изменения будут потеряны.
После изменения postgresql.conf выполните действие Reconfigure & Restart, чтобы применить изменения.
В таблице ниже содержится описание некоторых параметров, которые можно указать в postgresql.conf.
Наименование параметра | Описание | Значение по умолчанию |
---|---|---|
port |
TCP-порт, который прослушивается сервером |
5432 |
max_connections |
Определяет максимальное количество одновременных соединений с сервером базы данных. Для replica-хоста значение этого параметра должно быть больше или равно значению на leader-хосте. Если данное требование не будет выполнено, replica-хост отклонит все запросы |
100 |
shared_buffers |
Устанавливает объем памяти, используемой сервером баз данных для буферов общей памяти. Чем выше значение данного параметра, тем меньше будет нагрузка на жесткие диски хоста |
128 МБ |
max_worker_processes |
Устанавливает максимальное количество фоновых процессов, которые может поддерживать система |
8 |
max_parallel_workers |
Устанавливает максимальное количество операций, которые система может поддерживать параллельно |
8 |
max_parallel_workers_per_gather |
Устанавливает максимальное количество операций, которые могут быть запущены одним узлом Gather или Gather Merge |
2 |
max_parallel_maintenance_workers |
Устанавливает максимальное количество параллельных операций, которые могут быть запущены одной командой утилиты |
2 |
effective_cache_size |
Определяет представление планировщика об эффективном размере дискового кeша, доступном для одного запроса. Это значение учитывается при оценке стоимости использования индекса. Более высокое значение увеличивает вероятность использования сканирования индекса, более низкое значение повышает вероятность применения последовательного сканирования. При настройке этого параметра следует учитывать как разделяемые буферы PostgreSQL (shared buffers), так и часть дискового кеша ядра, которая будет использоваться для файлов данных PostgreSQL, хотя некоторые данные могут существовать и там, и там. Также необходимо учитывать ожидаемое количество одновременных запросов к разным таблицам, поскольку им придется делить доступное пространство. Этот параметр не влияет на размер общей памяти, выделяемой PostgreSQL, и не резервирует дисковый кеш ядра. Он используется только в целях оценки. Система также не предполагает, что данные остаются в дисковом кеше между запросами. Если значение |
4096 МБ |
maintenance_work_mem |
Указывает максимальный объем памяти, который будет использоваться операциями обслуживания базы данных, такими как |
64 МБ |
work_mem |
Устанавливает базовый максимальный объем памяти, который будет использоваться операцией запроса (например, сортировкой или хеш-таблицей) перед записью во временные файлы на диске. Обратите внимание, что для сложного запроса несколько операций сортировки или хеширования могут выполняться параллельно. Каждой операции будет разрешено использовать столько памяти, сколько указано в этом значении, прежде чем начнется запись во временные файлы. Несколько запущенных сессий также могут выполнять такие операции одновременно. Следовательно, общий объем используемой памяти может во много раз превышать значение |
4 МБ |
min_wal_size |
Пока WAL занимает на диске меньше объема, заданного в |
80 МБ |
max_wal_size |
Параметр |
1024 МБ |
wal_keep_size |
Задает минимальный объем прошлых сегментов журнала, который будет сохраняться в каталоге pg_wal, чтобы резервный сервер мог выбрать их при потоковой репликации. Если резервный сервер, подключенный к передающему, отстает больше чем на |
128 МБ |
huge_pages |
Включает использование больших страниц памяти. Допустимы следующие значения:
|
try |
superuser_reserved_connections |
Определяет количество "слотов" подключений, которые сервер будет резервировать для суперпользователей |
3 |
logging_collector |
Включает сборщик сообщений логирования (logging collector). Сборщик сообщений логирования — это фоновый процесс, который перехватывает сообщения логирования, отправленные в stderr, и перенаправляет их в файлы логов |
Сборщик сообщений логирования включен ( |
log_directory |
Определяет каталог, в который записываются лог-файлы. Может содержать абсолютный путь или путь относительно каталога с данными кластера ADPG |
log |
log_filename |
Задает шаблон имени лог-файла, может содержать спецификаторы % strftime для включения времени и даты создания в имя файла. Если спецификаторы % не заданы, используйте утилиты ротации лог-файлов, чтобы избежать переполнения диска |
postgresql-%a.log |
log_rotation_age |
Определяет максимальный период использования лог-файла, после которого создается новый лог-файл. Если значение задано без единиц измерения, оно берется в минутах. Чтобы отключить создание лог-файлов по времени, установите значение |
1d |
log_rotation_size |
Определяет максимальный размер лог-файла. После того как лог-файл достигает указанного размера, создается новый лог-файл. Если значение задано без единиц измерения, оно берется в килобайтах. Чтобы отключить создание лог-файлов при превышении определенного размера, установите значение |
0 |
log_min_messages |
Определяет минимальный уровень важности сообщений, которые записываются в лог-файл. Допустимые значения: |
warning |
log_min_error_statement: |
Определяет какие SQL-операторы, завершившиеся ошибкой, записываются в лог-файл. Допустимые значения: |
error |
Custom postgresql.conf
Вы можете использовать Custom postgresql.conf, чтобы установить параметры конфигурации для определенных ADPG-нод на основании конфиг-групп ADCM. Настройки, указанные в этом поле, имеют более высокий приоритет, чем параметры, установленные в postgresql.conf. Чтобы перейти в режим редактирования, кликните Custom postgresql.conf в дереве Configuration.

В появившемся окне укажите требуемые параметры и нажмите Apply.
Обратите внимание, что некоторые параметры должны иметь одинаковые значения на ноде-лидере и нодах-репликах в соответствии с требованиями Patroni. Изменение значений этих параметров в поле Custom postgresql.conf будет проигнорировано. Их значения можно установить только в поле postgresql.conf для всех ADPG-нод одновременно. Эти параметры и их значения по умолчание перечислены в таблице ниже.
Наименование параметра | Значение по умолчанию |
---|---|
max_connections |
100 |
max_locks_per_transaction |
64 |
max_worker_processes |
8 |
max_prepared_transactions |
0 |
wal_level |
hot_standby |
track_commit_timestamp |
off |
max_wal_senders |
10 |
max_replication_slots |
10 |
wal_keep_segments |
8 |
wal_keep_size |
128 MB |
PG_HBA
Поле для добавления записей в файл pg_hba.conf, в котором настраивается аутентификация пользователей.
Balancer
Параметр | Описание | Значение по умолчанию |
---|---|---|
leader as replica |
Определяет, будет ли нода-лидер обрабатывать транзакции на чтение |
False |
leader_port |
Назначает порт на хосте с компонентом HAProxy, на который должны приходить транзакции на запись |
6432 |
replica_port |
Определяет порт на хосте с компонентом HAProxy, на который должны приходить транзакции на чтение |
6433 |
balancer_stats_port |
Определяет порт, на котором доступна веб-страница с отчетом статистики HAProxy |
7000 |
pgbouncer_leader_port |
Все подключения к этому порту передаются экземпляру PgBouncer ноды-лидера ADPG |
16432 |
pgbouncer_replica_port |
Все подключения к этому порту передаются экземплярам PgBouncer нод-реплик ADPG |
16433 |
Chrony
Параметр | Описание | Значение по умолчанию |
---|---|---|
NTP servers |
Адреса действующих NTP-серверов. Например, |
— |
Etcd
ВАЖНО
Параметры конфигурации Etcd listen_peer_urls_port и listen_client_urls_port нельзя изменить после установки.
|
Параметр | Описание | Значение по умолчанию |
---|---|---|
listen_peer_urls_port |
Указывает порт для связи между серверами Etcd |
2380 |
listen_client_urls_port |
Указывает порт для клиентских запросов |
2379 |
Space quota(bytes) |
Максимальное количество байт, которое может использовать файл базы данных etcd |
2147483648 |
Enable log compaction |
Включает автоматическое сжатие etcd-логов |
true |
Autocompaction mode |
Режим автосжатия etcd |
periodic |
Autocompaction retention |
Период запуска автосжатия для хранилища ключ/значение mvcc в часах или номер ревизии |
10h |
Monitoring
Параметр | Описание | Значение по умолчанию |
---|---|---|
Listen port |
Порт на хосте с сервисом Balancer для получения метрик HAProxy в формате Prometheus |
8405 |
Metrics endpoint |
Конечная точка на хосте с сервисом Balancer для получения метрик HAProxy в формате Prometheus |
/metrics |
Параметр | Описание | Значение по умолчанию |
---|---|---|
Listen port |
Порт на хосте с сервисом ADPG для получения метрик пула соединений в формате Prometheus |
9188 |
Параметр | Описание | Значение по умолчанию |
---|---|---|
Listen port |
Порт на хосте с сервисом ADPG для получения метрик PgBackRest в формате Prometheus |
9854 |
Metrics endpoint |
Конечная точка на хосте с сервисом ADPG для получения метрик PgBackRest в формате Prometheus |
/metrics |
Параметр | Описание | Значение по умолчанию |
---|---|---|
Listen port |
Порт на хосте с сервисом ADPG для получения метрик PostgreSQL в формате Prometheus |
9187 |
Группа | Параметр | Описание | Значение по умолчанию |
---|---|---|---|
— |
scrape_interval |
Интервал сбора метрик |
1m |
— |
scrape_timeout |
Время ожидания данных при сборе метрик |
10s |
— |
Password for Grafana connection |
Пароль пользователя Grafana ( |
— |
— |
Prometheus users to login/logout to Prometheus |
Учетные данные пользователей для входа в веб-интерфейс Prometheus |
— |
Service parameters |
config.file |
Путь к конфигурационному файлу сервера Prometheus |
/etc/admprom/prometheus/prometheus.yml |
storage.tsdb.path |
Путь к базе данных сервера Prometheus |
/var/lib/admprom/prometheus |
|
web.console.libraries |
Путь к библиотекам управления консолями |
/usr/share/admprom/prometheus/console_libraries |
|
web.console.templates |
Путь к шаблонам консолей сервера Prometheus |
/usr/share/admprom/prometheus/consoles |
|
web.config.file |
Указывает, какой файл веб-конфигурации следует загрузить. Файл должен иметь YAML-формат |
/etc/admprom/prometheus/prometheus-auth.yml |
|
storage.tsdb.retention.time |
Время хранения данных. Поддерживаемые единицы: |
15d |
|
web.listen-address |
Адрес для доступа к веб-интерфейсу Prometheus |
0.0.0.0:11200 |
Параметр | Описание | Значение по умолчанию |
---|---|---|
Grafana administrator’s password |
Пароль пользователя Grafana |
— |
Grafana listen port |
Порт для доступа к web-интерфейсу Grafana |
11210 |
Параметр | Описание | Значение по умолчанию |
---|---|---|
Listen port |
Порт на хосте кластера для получения системных метрик в формате Prometheus |
11203 |
Metrics endpoint |
Конечная точка на хосте кластера для получения системных метрик в формате Prometheus |
/metrics |