Конфигурационные параметры
В этой статье описаны параметры, которые могут быть настроены для сервисов ADQM Control через ADCM. Процесс настройки сервисов приведен в статье Настройка сервисов раздела Online-установка ADQM Control.
|
ПРИМЕЧАНИЕ
Некоторые из перечисленных параметров становятся доступны в UI ADCM после установки флага Show advanced.
|
ADQM Control
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
ADQM username |
Имя пользователя для подключения к ADQM |
adqmc |
ADQM user password |
Пароль пользователя |
— |
ADQM default port |
Порт по умолчанию, если он не экспортируется из кластера ADQM |
9000 |
ADQM secure port |
Порт по умолчанию для SSL-защищенных соединений с ADQM, если он не экспортируется из кластера ADQM |
9440 |
Connection type |
Тип соединения (незащищенное или безопасное) между ADQM Control и ADQM. Возможные значения: |
Insecure (TCP) |
|
ПРИМЕЧАНИЕ
Аккаунт пользователя, имя и пароль которого указываются в параметрах
|
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Session timeout |
Тайм-аут сессии web-интерфейса ADQM Control (в секундах) |
1800 |
Enable CSRF validation |
Включает CSRF-проверку |
Активен |
|
ПРИМЕЧАНИЕ
В статье Шифрование SSL приведен пример, как настроить и включить SSL для сервисных компонентов ADQM Control. |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
[ADQM Control’s Backend] → Enable SSL |
Включает SSL для компонента Backend |
Неактивен |
[ADQM Control’s ADQM Agent] → Enable SSL |
Включает SSL для компонента Agents |
Неактивен |
[ADQM Control’s Alert Generator] → Enable SSL |
Включает SSL для компонента Alert Generator |
Неактивен |
[ADQM Control’s Alert Receiver] → Enable SSL |
Включает SSL для компонента Alert Receiver |
Неактивен |
[Alertmanager] → Enable SSL |
Включает SSL для компонента Alertmanager |
Неактивен |
[ADQM Control Services] → Certificate file |
Путь к файлу серверного SSL-сертификата для компонентов Backend, Agents, Alert Generator, Alert Receiver |
/etc/adqmc/server.crt |
[ADQM Control Services] → Private key file |
Путь к файлу закрытого ключа серверного SSL-сертификата для компонентов Backend, Agents, Alert Generator, Alert Receiver |
/etc/adqmc/server.key |
[ADQM Control Services] → Certificate authority file |
Путь к файлу корневого сертификата центра сертификации для компонентов Backend, Agents, Alert Generator, Alert Receiver |
/etc/adqmc/ca.crt |
[Alertmanager] → Certificate file |
Путь к файлу серверного SSL-сертификата для компонента Alertmanager |
/etc/admprom/alert-manager/server.crt |
[Alertmanager] → Private key file |
Путь к файлу закрытого ключа серверного SSL-сертификата для компонента Alertmanager |
/etc/admprom/alert-manager/server.key |
[Alertmanager] → Certificate authority file |
Путь к файлу корневого сертификата центра сертификации для компонента Alertmanager |
/etc/admprom/alert-manager/ca.crt |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Backend port |
Порт доступа к web-интерфейсу ADQM Control |
5555 |
Alert Generator port |
Порт доступа к сервису Alert generator |
5001 |
ADQM agent port |
Порт доступа к сервису Agents |
5002 |
Alertmanager port |
Порт доступа к сервису Alert manager |
9093 |
Alert Receiver port |
Порт доступа к сервису Alert receiver |
12322 |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Backend connection pool size |
Максимальное количество подключений к базе данных PostgreSQL сервиса Backend |
8 |
ADQM agent connection pool size |
Максимальное количество подключений к базе данных PostgreSQL сервиса Agents |
8 |
Statement timeout |
Тайм-аут для запросов и транзакций (в секундах) |
120 |
Cleanup timeout |
Тайм-аут сервера (в секундах): прерывать любой запрос в базу данных, выполняющийся дольше указанного времени |
86400 |
Migration timeout |
Тайм-аут миграции базы данных (в секундах) |
3600 |
Prometheus timeout |
Тайм-аут подключения к Prometheus (в секундах) |
60 |
Alertmanager timeout |
Тайм-аут подключения к Alertmanager (в секундах) |
60 |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Hosts scrape interval |
Частота обновления информации о топологии кластера ADQM (в секундах) |
80 |
ADQMDB scrape interval |
Частота обновления информации о таблицах в кластере ADQM (в секундах) |
80 |
Query update interval |
Частота сбора запросов (в секундах) |
105 |
Query normalize interval |
Частота обновления запросов (в секундах) |
120 |
Check query_log interval |
Частота проверки query_log (в секундах) |
60 |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Normalize query raw max queries per iteration |
Максимальное количество запросов, нормализуемых за итерацию |
50000 |
Collect queries limit |
Количество запросов, полученных из query_log за итерацию |
10000 |
Query normalize threshold |
Количество попыток нормализации запроса |
10 |
Existing tables tries |
Количество попыток получить метрики таблицы ADQM. Если по истечении времени |
3 |
Tables cache size |
Размер кеша таблиц |
32768 |
Table cache invalidate interval |
Интервал инвалидации кеша таблиц (в секундах) |
28800 |
Maximum revision per table in cache |
Максимальное количество ревизий одной таблицы в кеше |
100 |
Queries cache size |
Размер кеша запросов |
8192 |
Batch size of queries normalization |
Размер пакета запросов для нормализации |
1024 |
Capacity of existing tables cache |
Объем кеша существующих таблиц |
500000000 |
Existing tables cache invalidate period |
Период инвалидации кеша существующих таблиц (в секундах) |
604800 |
Table’s existing period for existing tables cache calculation |
Время существования таблицы (в секундах) для внесения данных в кеш существующих таблиц |
7776000 |
Maximum of parallel workers |
Максимальное количество параллельных процессов-обработчиков |
0 |
|
ПРИМЕЧАНИЕ
Чтобы получить доступ к параметрам конфигурации, необходимо активировать опцию Use internal PostgreSQL server. |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Alerts dbname |
Имя базы данных, которая будет создана для использования сервисами ADQM Control |
adqmc |
Alertsdb username |
Имя пользователя, который имеет доступ к базе данных, указанной через параметр |
adqmc |
Alertsdb password |
Пароль пользователя |
— |
|
ПРИМЕЧАНИЕ
Чтобы получить доступ к параметрам конфигурации, необходимо активировать опцию Use external PostgreSQL server. |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
server_ip_port |
Используйте Add property, чтобы указать IP-адрес (как название свойства) и порт (как значение свойства) для доступа к внешнему серверу PostgreSQL |
— |
Alerts dbname |
Имя базы данных для использования сервисами ADQM Control |
adqmc |
Alertsdb username |
Имя пользователя с доступом к базе данных, указанной через параметр |
adqmc |
Alertsdb password |
Пароль пользователя |
— |
SSL is used by an external server |
Указывает, используется ли SSL внешним сервером |
Неактивен |
ADPG
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Data directory |
Директории, используемые для хранения данных на хостах кластера ADPG |
/pg_data1 |
|
РЕКОМЕНДАЦИЯ
Оптимальные значения параметров для лучшей производительности ADPG можно получить с помощью действия сервиса ADPG Collect recommendations.
|
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
listen_addresses |
Адреса TCP/IP, по которым сервер прослушивает подключения клиентских приложений |
* |
port |
TCP-порт, который прослушивается сервером |
5432 |
max_connections |
Максимальное количество одновременных соединений с сервером базы данных |
100 |
shared_buffers |
Объем памяти, используемой сервером базы данных для буфера общей памяти. Целесообразное начальное значение данного параметра — 25% памяти системы |
2048 MB |
max_worker_processes |
Максимальное количество фоновых процессов, которые может поддерживать система |
23 |
max_parallel_workers |
Максимальное количество операций, которые система может поддерживать параллельно |
4 |
max_parallel_workers_per_gather |
Максимальное количество операций, которые могут быть запущены одним узлом Gather или Gather Merge |
2 |
max_parallel_maintenance_workers |
Максимальное количество параллельных операций, которые могут быть запущены одной командой утилиты |
2 |
effective_cache_size |
Помогает планировщику запросов ADPG определить эффективный размер дискового кеша для одного запроса. Это учитывается при оценке стоимости использования индекса. Чем выше это значение, тем больше вероятность применения сканирования по индексу. Соответственно, чем ниже значение, тем более вероятно, что будет выбрано последовательное сканирование |
6144 MB |
maintenance_work_mem |
Лимит памяти для операций обслуживания. Увеличение значения данного параметра может ускорить операции по очистке и восстановлению БД из копии |
1024 MB |
work_mem |
Лимит памяти non-shared, который будет использоваться для внутренних операций при выполнении запросов (например, к временным таблицам) прежде, чем будут задействованы временные файлы на диске. Этот лимит действует как простой элемент управления ресурсами, предотвращая переход хоста в активную подкачку (swapping) из-за переполнения. Так как выделяемая память является памятью non-shared, то большие и сложные запросы могут превышать указанный лимит |
5242 kB |
min_wal_size |
Пока WAL занимает на диске меньше объема, определенного в |
1024 MB |
max_wal_size |
Лимит памяти, до которого может вырастать размер журнала между автоматическими контрольными точками |
4096 MB |
wal_keep_size |
Минимальный размер прошлых сегментов журнала, которые будут сохраняться в каталоге pg_wal, чтобы резервный сервер мог выбрать их при потоковой репликации. Если резервный сервер, подключенный к передающему, отстает больше чем на |
0 MB |
huge_pages |
Включает использование больших страниц памяти. Возможные значения:
|
try |
superuser_reserved_connections |
Количество "слотов" подключений, которые сервер будет резервировать для суперпользователей |
3 |
timescaledb.max_background_workers |
Максимальное количество фоновых процессов, выделенных для TimescaleDB |
16 |
wal_buffers |
Объем разделяемой памяти, который будет использоваться для данных WAL, еще не записанных на диск |
16 MB |
default_statistics_target |
Объем статистики по умолчанию для столбцов таблицы, для которых не указаны отдельные целевые значения статистики командой |
100 |
random_page_cost |
Параметр, использующийся планировщиком для оценки приблизительной стоимости чтения одной произвольной страницы с диска, извлекаемой непоследовательно |
1.1 |
checkpoint_completion_target |
Целевое время завершения контрольной точки как доля общего времени между контрольными точками |
0.9 |
max_locks_per_transaction |
Общая таблица блокировок отслеживает блокировки для |
128 |
autovacuum_max_workers |
Максимальное число процессов автовакуума (не считая процесс, запускающий автовакуум), которые могут выполняться одновременно |
10 |
autovacuum_naptime(seconds) |
Минимальная задержка между двумя запусками автовакуума для отдельной базы данных. Демон автовакуума проверяет базу данных через указанный интервал времени и выполняет команды |
10 |
default_toast_compression |
Метод сжатия TOAST по умолчанию для значений сжимаемых столбцов. Возможные значения: |
lz4 |
effective_io_concurrency |
Количество дисковых операций ввода-вывода, которые могут выполняться одновременно. Увеличение этого значения увеличит количество операций ввода-вывода, которые сессия PostgreSQL пытается инициировать параллельно |
256 |
jit |
Определяет, может ли PostgreSQL использовать JIT-компиляцию, если она поддерживается |
off |
logging_collector |
Включает сборщик сообщений логирования (logging collector) — фоновый процесс, который перехватывает сообщения логирования, отправленные в stderr, и перенаправляет их в файлы логов |
Активен |
log_directory |
Каталог, в который записываются лог-файлы. Может содержать абсолютный путь или путь относительно каталога с данными кластера ADPG |
log (абсолютный путь — /pg_data1/adpg14/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 можно установить дополнительные параметры, которые будут записаны в файл postgresql.conf. Для добавления параметра нажмите Add property.
В появившемся окне укажите название и значение параметра и нажмите Apply.
Вы можете добавить несколько параметров.
Секция для установки параметра shared_preload_libraries конфигурации postgresql.conf. Для работы ADQM Control требуются расширения timescaledb и timescaledb_toolkit. Если необходимо добавить другие расширения (например, pg_stat_statements), используйте иконку
.
Поле для добавления записей в файл pg_hba.conf, в котором настраивается аутентификация пользователей.
|
ПРИМЕЧАНИЕ
Подробная информация о поддержке шифрования SSL в ADQM Control приведена в статье Шифрование SSL. |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Enable SSL |
Включает SSL-шифрование входящего трафика для сервиса ADPG |
Неактивен |
Certificate file |
Путь к файлу серверного SSL-сертификата |
/etc/adpg16/server.crt |
Private key file |
Путь к файлу закрытого ключа серверного SSL-сертификата |
/etc/adpg16/server.key |
Certificate authority file |
Путь к файлу корневого сертификата центра сертификации (Certification Authority, CA) |
/etc/adpg16/ca.crt |
Monitoring
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
scrape_interval |
Интервал сбора метрик |
1m |
scrape_timeout |
Время ожидания данных |
10s |
Password for grafana connection |
Пароль пользователя Grafana для подключения к Prometheus |
— |
Prometheus users to login/logout to Prometheus |
Учетные данные пользователей для входа в веб-интерфейс Prometheus |
— |
Service parameters |
Параметры Prometheus |
— |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Grafana administrator’s password |
Пароль администратора Grafana |
— |
Grafana listen port |
Порт доступа к web-интерфейсу Grafana |
11210 |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
Listen port |
Порт доступа к системным метрикам хоста в формате Prometheus |
11203 |
Metrics endpoint |
Конечная точка (endpoint), в которую node exporter экспортирует системные метрики в формате Prometheus |
/metrics |
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
[Prometheus] → Enable SSL |
Включает SSL-шифрование входящего трафика для компонента Prometheus Server |
Неактивен |
[Prometheus] → Certificate file |
Путь к файлу серверного SSL-сертификата для компонента Prometheus Server |
/etc/admprom/prometheus/server.crt |
[Prometheus] → Private key file |
Путь к файлу закрытого ключа серверного SSL-сертификата для компонента Prometheus Server |
/etc/admprom/prometheus/server.key |
[Prometheus] → Certificate authority file |
Путь к файлу корневого сертификата центра сертификации для проверки ресурсов (targets), с которых поступают метрики для мониторинга в Prometheus |
/etc/admprom/prometheus/ca.crt |
[Grafana] → Enable SSL |
Включает SSL-шифрование входящего трафика для компонента Grafana |
Неактивен |
[Grafana] → Certificate file |
Путь к файлу серверного SSL-сертификата для компонента Grafana |
/etc/admprom/grafana/server.crt |
[Grafana] → Private key file |
Путь к файлу закрытого ключа серверного SSL-сертификата для компонента Grafana |
/etc/admprom/grafana/server.key |
[Grafana] → Certificate authority file |
Путь к файлу корневого сертификата центра сертификации для проверки сертификата Prometheus |
/etc/admprom/grafana/ca.crt |
[Node-exporter] → Enable SSL |
Включает SSL-шифрование входящего трафика для компонента Node Exporter |
Неактивен |
[Node-exporter] → Certificate file |
Путь к файлу серверного SSL-сертификата для компонента Node Exporter |
/etc/ssl/server.crt |
[Node-exporter] → Private key file |
Путь к файлу закрытого ключа серверного SSL-сертификата для компонента Node Exporter |
/etc/ssl/server.key |