ppem-manager.yml
ppem-manager.yml — Файл конфигурации YAML для менеджера
Обзор #
Файл конфигурации расположен в /etc/ppem-manager.yml.
Вы можете указать способ обработки параметров с помощью специального параметра use_storage_config.
После внесения любых изменений в файл конфигурации необходимо перезапустить службу менеджера:
systemctl restart ppem
Файл конфигурации состоит из следующих разделов:
log: параметры журналирования.integrations: параметры интеграций.http: HTTP-параметры.jwt: параметры JWT-сеансов.crypto: параметры шифрования.oidc: параметры интеграции OIDC.ldap: параметры интеграции с LDAP.package_managers: параметры менеджера пакетов.alerts: параметры оповещений и уведомлений.executor: параметры исполнителя.metrics: параметры сборщика метрик.audit: параметры журнала событий аудита.agents_connection: параметры подключения агентов.autodiscovery: параметры автоматического обнаружения.
Настройка обработки параметров #
Файл конфигурации содержит специальный параметр use_storage_config.
Если для этого параметра указано значение true, значения из хранилища конфигурации переопределяют значения из файла конфигурации.
Значение по умолчанию: false — менеджер использует параметры из файла конфигурации.
Параметры журналирования #
Раздел log позволяет настроить параметры журналирования для менеджера.
За подробной информацией о настройке журнала событий аудита и уведомлений об оповещениях обратитесь к Разделу «Параметры журнала событий аудита» и Разделу «Параметры оповещений и уведомлений».
log: level:уровень_журналированияformat:формат_журналовoptions: csv_field_delimiter:символ_разделителяfile: path:абсолютный_путь_к_файлу_журналаmode:режим_доступа_к_файлу_журналаrotation_age:интервал_ротации_файла_журналаrotation_size:размер_файла_журнала_для_ротации
-
level(enum)# Уровень журналирования.
Возможные значения:
debuginfowarnerror
Каждый уровень журналирования включает в себя предыдущие, например
warnсодержит сообщения журнала уровнейinfoиdebug.-
format(enum, необязательный)# Формат журналирования.
Возможные значения:
json: формат JSON.pretty: отформатированный формат JSON, например создаваемый утилитой jq.csv: текстовый формат CSV.Символ разделителя CSV можно указать с помощью параметра
options.csv_field_delimiter.
Значение по умолчанию:
json.-
options.csv_field_delimiter(string, необязательный)# Строка из одного символа, которая используется в качестве разделителя CSV.
Этот параметр применим, только если для параметра
formatуказано значениеcsv.Значение по умолчанию:
,(символ запятой).-
file(object, необязательный)# Файл для записи журналов. У менеджера должны быть права на запись в этот файл. Если файл не существует, менеджер создаёт его автоматически.
Если этот параметр не указан, PPEM записывает журналы в
stdout.PPEM выполняет ротацию файла журнала, если выполняется любое из следующих условий:
Служба ppem получает сигнал
SIGHUP.Время жизни или размер файла журнала равен значению параметра
rotation_ageилиrotation_sizeсоответственно.
При ротации файла журнала PPEM сохраняет его и добавляет метку времени к его имени. Затем файл журнала, указанный в параметре
path, очищается.-
path(string, непустое значение)# Абсолютный путь к файлу журнала, например
/var/log/ppem.log.-
mode(string, непустое значение)# Числовая строка, которая определяет режим доступа к файлу в формате, аналогичном формату, используемому chmod, например
0644.-
rotation_age(time string, необязательный)# Максимальное время жизни отдельного файла журнала. По истечении этого времени создаётся новый файл.
Значение по умолчанию:
""(пустая строка) — смена файлов по времени жизни не производится.-
rotation_size(string, необязательный)# Максимальный размер отдельного файла журнала. При достижении этого размера создаётся новый файл.
Значение по умолчанию:
""(пустая строка) — смена файлов по размеру не производится.
Параметры базы данных репозитория #
Раздел repo позволяет настроить параметры базы данных репозитория.
Большинство параметров определяют способ подключения к базе данных репозитория, а параметр schema указывает имя схемы, в которой требуется хранить объекты базы данных.
repo: schema:схема_для_объектов_репозиторияurl:URL_подключения# Строка подключения в формате «ключ/значение» (альтернативный вариант) host:имя_хостаport:портname:имя_базы_данныхuser:имя_пользователяpassword:пароль_пользователяfallback_addresses: [список_резервных_адресов_хостов] target_session_attrs:атрибуты_целевого_сеансаsslmode:режим_безопасного_подключенияsslrootcert:файл_корневого_сертификата_CAsslcert:файл_публичного_сертификатаsslkey:файл_закрытого_ключаmax_conns:максимальное_количество_подключенийmax_conn_lifetime:тай-маут_активного_подключенияmax_conn_idle_time:тай-маут_неактивного_подключения# Параметры подключений, связанных с объектами экземпляров instance_objects_repo_pool: max_conns:максимальное_количество_подключенийmax_conn_lifetime:тай-маут_активного_подключенияmax_conn_idle_time:тай-маут_неактивного_подключения
-
schema(string)# Имя схемы, в которой требуется хранить объекты базы данных репозитория.
Для новой установки PPEM достаточно указать имя схемы. Изменение имени схемы для уже работающего PPEM с большим количеством созданных объектов требует выполнения более сложной процедуры.
Значение по умолчанию:
public.-
url(string, необязательный)# URL-адрес подключения к базе данных репозитория.
Пример:
postgres://ppem@dbms.example.org/ppem.Значение по умолчанию:
""(пустая строка).-
host(string, необязательный)
port(номер порта, необязательный)
name(string, необязательный)
user(string, необязательный)
password(string, необязательный)# Параметры строки подключения вида «ключ/значение» для базы данных репозитория.
Если URI подключения указан с помощью параметра url, он имеет приоритет над строкой подключения вида «ключ/значение».
Значение по умолчанию для
port:5432.Значение по умолчанию для других параметров:
""(пустая строка).-
fallback_addresses(список строк, необязательный)# Список резервных адресов в формате
хост:порт.Если попытка подключения с использованием указанных выше строк подключения завершается ошибкой, выполняются другие попытки подключения с использованием резервных адресов.
Пример:
fallback_addresses: - prod.example.org:5432 - dev.example.com:55432
Значение по умолчанию:
[](пустой список).-
target_session_attrs(string, необязательный)# Значение по умолчанию:
any.-
sslmode(string, необязательный)
sslrootcert(string, необязательный)
sslcert(string, необязательный)
sslkey(string, необязательный)# Параметры SSL для подключения к базе данных.
Значение по умолчанию
sslmode:prefer.Значение по умолчанию для других параметров:
""(пустая строка).-
max_conns(integer, необязательный)
max_conn_lifetime(time string, необязательный)
max_conn_idle_time(time string, необязательный)# Параметры пула соединений, используемого при подключении к базе данных репозитория:
max_conns: максимальное количество разрешённых подключений.Значение по умолчанию:
4.max_conn_lifetime: тайм-аут активного подключения.Активные подключения, превысившие тайм-аут, закрываются.
Значение по умолчанию:
1h.max_conn_idle_time: тайм-аут неактивного подключения.Неактивные подключения, превысившие тайм-аут, закрываются.
Значение по умолчанию:
10m.
-
instance_objects_repo_pool(object, необязательный)# Параметры пула соединений, используемого при работе с объектами экземпляров:
-
max_conns(integer, необязательный)
max_conn_lifetime(time string, необязательный)
max_conn_idle_time(time string, необязательный) max_conns: максимальное количество разрешённых подключений.Значение по умолчанию:
4.max_conn_lifetime: тайм-аут активного подключения.Активные подключения, превысившие тайм-аут, закрываются.
Значение по умолчанию:
1h.max_conn_idle_time: тайм-аут неактивного подключения.Неактивные подключения, превысившие тайм-аут, закрываются.
Значение по умолчанию:
10m.
-
Параметры интеграций #
Раздел integrations позволяет настроить интеграцию PPEM с другими продуктами и решениями Postgres Pro.
integrations:
askpostgres:
enabled: true_или_false
base_url: "https://ask.postgrespro.ru"
source: "ppem"
timeouts:
base: тайм_аут_непотоковых_HTTP_запросов
time_to_first_token: тайм_аут_первого_токена
idle: тайм_аут_неактивных_потоковых_HTTP_запросов-
askpostgres(object)# Параметры интеграции с Ask Postgres. За подробной информацией обратитесь к Главе 75.
-
enabled(boolean)# Указывает, включена ли интеграция с чатом AskPostgres.
Если указано значение
false, значок чата не отображается в веб-приложении, а оставшиеся параметры становятся необязательными.Значение по умолчанию:
false— интеграция отключена.-
base_url(string)# Базовый URL-адрес службы Ask Postgres.
Не изменяйте этот параметр, если вы не используете локально развёрнутый экземпляр Ask Postgres.
Значение по умолчанию:
https://ask.postgrespro.ru/api/v1.-
source(string)# Важно
Это служебный параметр, не изменяйте его.
Идентификатор источника запроса, отправляемый в HTTP-заголовке
X-Sourceслужбе Ask Postgres.Постоянное значение:
ppem.-
timeouts(object)# Параметры тайм-аутов для запросов к Ask Postgres:
-
base(time string)# Тайм-аут для непотоковых HTTP-запросов, таких как создание чата, получение сообщений или отмена генерации ответа.
Значение по умолчанию:
20s.-
time_to_first_token(time string)# Тайм-аут получения первого токена в потоке ответов. Если поток запускается, но в течение этого времени токен не получен, запрос завершается с ошибкой тайм-аута.
Значение по умолчанию:
120s.-
idle(time string)# Тайм-аут неактивности для потока ответов, который сбрасывается при получении каждого нового токена. Если в течение этого времени токен не получен, поток завершается с ошибкой тайм-аута.
Значение по умолчанию:
60s.
-
-
Параметры HTTP #
Раздел http позволяет настроить параметры HTTP-сервера и клиента, а также несколько параметров, связанных с API.
http:
server:
address: сетевой_адрес_прослушивания
port: сетевой_порт_прослушивания
mtls_port: сетевой_порт_прослушивания_для_mtls
tls:
cert_file: файл_публичного_сертификата
key_file: файл_закрытого_ключа
client_ca_file: файл_корневого_сертификата_ca
static_files_path: путь_к_статическим_файлам_веб-приложения
timeout: тайм_аут_обработки_HTTP_запросов
security:
enabled: true_или_false
csp_policy: заголовок_content_security_policy
cache_control: заголовок_cache_control
pragma: заголовок_Pragma
expires: заголовок_expires
frame_options: заголовок_x_content_type
content_type_options: заголовок_x_content_type_options
permissions_policy: заголовок_permissions_policy
referrer_policy: заголовок_referrer_policy
strict_transport_security: заголовок_strict_transport_security
cross_origin_embedder_policy: заголовок_cross_origin_embedder_policy
cross_origin_opener_policy: заголовок_cross_origin_opener_policy
cross_origin_resource_policy: заголовок_cross_origin_resource_policy
cors:
allowed_origins: [список_разрешённых_источников]
allowed_methods: [список_разрешённых_HTTP_методов]
allowed_headers: [список_разрешённых_HTTP_заголовков]
exposed_headers: [список_раскрытых_HTTP_заголовков]
allow_credentials: заголовок_access_control_allow_credentials
max_age: заголовок_access_control_max_age
real_ip_header_name: заголовок_с_исходным_IP_адресом
response_compression_level: уровень_сжатия_ответа_сервера
client:
timeouts:
http: тайм_аут_HTTP_запросов
tls_handshake: тайм_аут_TLS-рукопожатия
dialer: тайм_аут_установки_подключения_к_серверу_для_HTTP
response_header: тайм_аут_ожидания_заголовков_HTTP_ответа
insecure_skip_verify: пропустить_проверку_сертификата_сервера
root_ca_files: [список_файлов_корневых_сертификатов_CA]
pagination:
max_page_size: максимальное_количество_объектов_в_одном_ответе
api:
disabled: {объект_с_отключёнными_конечными_точками_API}Параметры HTTP-сервера #
-
address(string, необязательный)# Сетевой адрес, на котором необходимо слушать.
Если указать пустую строку, сервер будет слушать на всех сетевых интерфейсах.
Значение по умолчанию:
localhost.-
port(номер порта, необязательный)# Сетевой порт, на котором необходимо слушать.
Значение по умолчанию:
8080.-
mtls_port(номер порта, необязательный)# Сетевой порт для mTLS, на котором необходимо слушать.
Этот параметр действует только когда в разделе
tlsнастроен mTLS.Значение по умолчанию:
9443.-
tls(object)# Параметры TLS-сертификата, необходимые для включения HTTPS как для веб-приложения, так и для соединений с агентами. Дополнительно можно настроить взаимную проверку TLS (mTLS).
Если механизм mTLS включён и настроен как на стороне менеджера, так и на стороне агента, то он добавляет дополнительный уровень безопасности.
Если не указать файлы сертификата и ключа (пустые строки), веб-приложение будет доступно только по HTTP, а HTTPS и mTLS не будут использоваться для соединений типа менеджер-агент.
Порт для веб-приложения указывается в параметре
port, а порт для mTLS/входящих соединений от агентов — в параметреmtls_port.-
cert_file(string)# Абсолютный путь к файлу публичного сертификата.
Значение по умолчанию:
""(пустая строка).-
key_file(string)# Абсолютный путь к файлу закрытого ключа.
Значение по умолчанию:
""(пустая строка).-
client_ca_file(string)# Абсолютный путь к корневому CA-сертификату, который используется для проверки сертификатов агентов.
Значение по умолчанию:
""(пустая строка).
-
-
static_files_path(string)# Путь к статическим файлам веб-приложения PPEM.
Значение по умолчанию:
""(пустая строка).-
timeout(time string, необязательный)# Тайм-аут обработки HTTP-запроса.
Значение по умолчанию:
60s.-
security(object)# Параметры безопасности HTTP-сервера. Эти параметры в основном используются для указания значений HTTP-заголовков, связанных с безопасностью.
Параметры
cross-origin-*-policyнеобходимо настроить вручную, так как PPEM не предоставляет для них значений по умолчанию.-
enabled(boolean, необязательный)# Указывает, включена ли обработка HTTP-заголовков, связанных с безопасностью.
Значение по умолчанию:
false— обработка отключена.-
csp_policy(string, необязательный)# Значение HTTP-заголовка ответа Content-Security-Policy. Помогает предотвратить XSS, кликджекинг и другие атаки с внедрением кода.
Значение по умолчанию зависит от того, настроен ли HTTP-сервер на работу с HTTPS:
Режим HTTP:
default-src 'none'; script-src 'self' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self'; connect-src 'self'; media-src 'self'; form-action 'self'; base-uri 'self'; frame-ancestors 'none'; frame-src https://postgrespro.com/; object-src 'none'.Режим HTTPS:
default-src 'none'; script-src 'self' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self'; connect-src 'self'; media-src 'self'; form-action 'self'; base-uri 'self'; frame-ancestors 'none'; frame-src https://postgrespro.com/; object-src 'none'; upgrade-insecure-requests.
-
cache_control(string, необязательный)# Значение HTTP-заголовка Cache-Control. Управляет кешированием в браузерах. Значение по умолчанию помогает предотвратить кеширование API-ответов, которые могут содержать конфиденциальные или постоянно изменяющиеся данные.
Значение по умолчанию:
no-store, no-cache, must-revalidate.-
pragma(string, необязательный)# Значение HTTP-заголовка Pragma.
Этот заголовок является устаревшим и обеспечивает обратную совместимость с кешами HTTP/1.0, которые не поддерживают HTTP-заголовок Cache-Control.
Значение по умолчанию:
no-cache.-
expires(string, необязательный)# Значение HTTP-заголовка ответа Expires.
Этот заголовок обеспечивает обратную совместимость с кешами HTTP/1.0, которые не поддерживают HTTP-заголовок Cache-Control.
Значение по умолчанию:
0.-
frame_options(string, необязательный)# Значение HTTP-заголовка ответа X-Frame-Options. Помогает предотвратить кликджекинг-атаки.
Значение по умолчанию:
""(пустая строка).-
content_type_options(string, необязательный)# Значение HTTP-заголовка ответа X-Content-Type-Options. Помогает предотвратить атаки с подменой MIME-типов.
Значение по умолчанию:
""(пустая строка).-
permissions_policy(string, необязательный)# Значение HTTP-заголовка ответа Permissions-Policy. Определяет, какие возможности браузера и API устройств могут быть использованы. Значение по умолчанию запрещает доступ к возможностям, которые могут раскрыть конфиденциальную информацию, таким как камера, микрофон и геолокация.
Значение по умолчанию:
"accelerometer=(), autoplay=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=()".-
referrer_policy(string, необязательный)# Значение HTTP-заголовка ответа Referrer-Policy. Определяет, какой объём информации о реферере включается в запросы.
Значение по умолчанию:
strict-origin-when-cross-origin.-
strict_transport_security(string, необязательный)# Значение HTTP-заголовка ответа Strict-Transport-Security. Принудительно заставляет браузеры использовать только HTTPS-подключения. Применяется, только если HTTP-сервер настроен на работу с HTTPS, иначе игнорируется.
Значение по умолчанию:
Режим HTTP:
""(пустая строка) — не применимо.Режим HTTPS:
max-age=31536000; includeSubDomains.
-
cross_origin_embedder_policy(string)# Значение HTTP-заголовка ответа Cross-Origin-Embedder-Policy.
Значение по умолчанию:
""(пустая строка).-
cross_origin_opener_policy(string)# Значение HTTP-заголовка ответа Cross-Origin-Opener-Policy.
Значение по умолчанию:
""(пустая строка).-
cross_origin_resource_policy(string)# Значение HTTP-заголовка ответа Cross-Origin-Resource-Policy.
Значение по умолчанию:
""(пустая строка).
-
-
cors(object)# Связанные с CORS параметры безопасности HTTP-сервера.
Большинство из этих параметров связаны с заголовками
Access-Control-*. Для удобства такие параметры представлены в виде списка строк. Затем, в зависимости от формата заголовка, эти строки обрабатываются следующим образом:Если в заголовке может быть указано только одно значение, каждая строка из списка отправляется в отдельном заголовке.
Пример:
allowed_origins: - "example.com" -> Access-Control-Allow-Origin: example.com - "prod.example.org" -> Access-Control-Allow-Origin: prod.example.org
Если в заголовке может быть указано несколько значений, строки из списка объединяются в одну, и полученная строка отправляется в заголовке.
Пример:
exposed_headers: -> Access-Control-Expose-Headers: Content-Encoding, X-Forwarded-For - "Content-Encoding" - "X-Forwarded-For"
-
allowed_origins(список строк)# Значения HTTP-заголовков ответа Access-Control-Allow-Origin.
Значение по умолчанию:
[](пустой список).-
allowed_methods(список строк)# Значения HTTP-заголовка ответа Access-Control-Allow-Methods.
Значение по умолчанию:
[](пустой список).-
allowed_headers(список строк)# Значения HTTP-заголовка ответа Access-Control-Allow-Headers.
Значение по умолчанию:
[](пустой список).-
exposed_headers(список строк)# Значения HTTP-заголовка ответа Access-Control-Expose-Headers.
Значение по умолчанию:
[](пустой список).-
allow_credentials(boolean)# Значение HTTP-заголовка ответа Access-Control-Allow-Credentials.
Значение по умолчанию:
false.-
max_age(integer)# Значение HTTP-заголовка ответа Access-Control-Max-Age.
Значение по умолчанию:
0.
-
real_ip_header_name(string, необязательный)# Имя HTTP-заголовка, который должен использоваться для определения исходного IP-адреса клиента, подключающегося к HTTP-серверу через прокси-сервер.
Заголовок X-Forwarded-For является примером такого заголовка.
Значение по умолчанию:
""(пустая строка).-
response_compression_level(integer, необязательный)# Уровень сжатия ответа от сервера.
Возможные значения:
-2(только сжатие Хаффмана)-1(уровень сжатия по умолчанию установлен на 6)0(сжатие отключено)Число в диапазоне от 1 (наилучшая скорость) до 9 (наилучшая степень сжатия)
Значение по умолчанию: 0 (сжатие отключено).
Параметры HTTP-клиента #
-
timeouts(object)# Тайм-ауты для HTTP-клиента.
-
http(time string)# Тайм-аут HTTP-запроса.
Значение по умолчанию:
60s.-
tls_handshake(time string)# Тайм-аут TLS-рукопожатия.
Значение по умолчанию:
2s.-
dialer(time string)# Тайм-аут установки подключения, когда клиент пытается подключиться к серверу. Попытка подключения должна завершиться успешно в течение этого интервала времени.
Значение по умолчанию:
2s.-
response_header(time string)# Тайм-аут ожидания HTTP-заголовков ответа после отправки HTTP-запроса серверу.
Значение по умолчанию:
20s.
-
-
отключить_проверку_безопасности(boolean, необязательный)# Важно
Использование этого параметра представляет риск для безопасности.
Рекомендуется использовать его исключительно для тестирования и отладки, но не в эксплуатационной среде.
Указывает, отключена ли проверка TLS-сертификата сервера.
Значение по умолчанию:
false— сертификат проверяется.-
root_ca_files(список строк, необязательный)# Список абсолютных путей к корневым CA-сертификатам, которые используются для проверки сертификата сервера.
Значение по умолчанию:
[](пустой список) — используются сертификаты из хранилища операционной системы.
Параметры HTTP API-сервера #
-
pagination.max_page_size(integer, необязательный)# Максимальное количество записей в одном API-ответе (размер страницы).
Значение по умолчанию:
100.-
api.disabled(object, необязательный)# Объект, содержащий отключённые конечные точки HTTP REST API. Если клиент запрашивает отключённую конечную точку, сервер возвращает ответ об ошибке с кодом состояния HTTP 503 Service Unavailable.
Объект содержит записи в следующем формате:
конечная_точка_API: список_отключённых_HTTP_методов.Пример:
api: disabled: "/v1/endpoint": ["GET", "POST", "PUT", "DELETE", "PATCH"] "/v1/instances/{id}/endpoint": ["POST"]Значение по умолчанию:
{}(пустой объект) — включены все конечные точки API.
Параметры JWT-сеансов #
Раздел jwt позволяет настроить параметры пользовательских сеансов и параметры, связанные с JSON Web Tokens.
jwt: secret:секрет_для_подписи_токенов_JWTSlifetime: access:время_жизни_токена_доступаrefresh:время_жизни_токена_обновленияmax_sessions_per_user:максимальное_количество_сеансов_на_пользователяmax_failed_login_attempts:максимальное_количество_неудачных_попыток_аутентификации_на_пользователяpassword_policy: length_min:минимальная_длина_пароляlength_max:максимальная_длина_пароляallowed_symbols:разрешённые_символы_в_паролеentropy_min:минимальная_энтропия_пароляhistory_depth:размер_хранимой_истории_паролей
-
secret(string)# Секрет, используемый для подписи выпущенного токена.
Токены обновления используются для выпуска токенов доступа. Токены доступа используются для аутентификации пользователей в PPEM.
За подробной информацией об этих токенах обратитесь к Разделу 7.5.
Значение по умолчанию:
secret.-
lifetime(object)# Значения времени жизни токенов. Токен, срок действия которого превышает указанное значение, считается истёкшим и не может быть использован. В таком случае необходимо выпустить новый токен.
-
max_sessions_per_user(integer)# Максимальное количество одновременных активных сеансов на пользователя.
Значение по умолчанию:
10.Сеанс считается активным, пока не истекло время жизни его токена обновления. Когда число активных сеансов достигает лимита, новая попытка входа отклоняется, но существующие сеансы не завершаются.
Ограничение распространяется только на сеансы пользователей. Оно не распространяется на встроенную учётную запись администратора и на сеансы агентов.
-
max_failed_login_attempts(integer)# Максимальное количество неудачных попыток входа в веб-приложение, после превышения которого пользователю автоматически блокируется вход в веб-приложение.
Значение по умолчанию:
0.Если установлено значение
0, автоматическая блокировка отключена, а неудачные попытки входа не подсчитываются. Если параметр больше0, учётная запись пользователя автоматически блокируется, когда число неудачных попыток входа достигает заданного порога. Счётчик неудачных попыток входа ведётся для каждого пользователя отдельно и сбрасывается после успешного входа.Когда автоматическая блокировка включена, таблица пользователей дополнительно отображает текущее число неудачных попыток входа для каждого пользователя. Для пользователя, заблокированного за превышение лимита неудачных попыток входа, также отображается время блокировки.
Пользователи, заблокированные за превышение лимита неудачных попыток входа, не разблокируются автоматически. Разблокировать такого пользователя может только администратор, изменив его статус на Активен, что также сбрасывает счётчик неудачных попыток входа. За подробной информацией обратитесь к Подразделу 42.1.5.
Примечание
Для соответствия политикам безопасности вашей организации задайте для параметра
max_failed_login_attemptsзначение, отличное от значения по умолчанию.-
password_policy(object)# Парольная политика, которая применяется ко всем объектам, требующим указания пароля. Эта политика действует глобально, на уровне установленного PPEM.
-
length_min(integer)# Минимальная длина пароля.
Значение по умолчанию:
8.-
length_max(integer)# Максимальная длина пароля.
Значение по умолчанию:
64.-
allowed_symbols(string)# Разрешённые символы пароля.
Этот параметр можно использовать для соответствия политикам безопасности организации, например, чтобы исключить неоднозначные символы из паролей.
Пример:
abcdEFGHI123456$%^
Значение по умолчанию:
""(пустая строка) — разрешены любые символы.-
entropy_min(integer)# Минимальное значение энтропии паролей, вычисляемое по формуле
длина_пароля × log2(размер(разрешённые_символы))Значение энтропии служит мерой сложности пароля и его криптографической стойкости. Рекомендуется поддерживать значение энтропии в диапазоне 50–70 или выше.
Пример:
Если разрешёнными символами являются
abcdefghijklmnopqrstuvwxyz, а паролем —helloaaa, энтропия составляет:8 × log2(размер(26)) = 37.6Следовательно, этот пароль имеет низкое значение энтропии.
Значение по умолчанию:
0— может использоваться пароль с любым значением энтропии.-
history_depth(integer)# Количество предыдущих паролей, которые хранит PPEM.
Если хеш нового пароля пользователя совпадает с любым из сохранённых хешей предыдущих паролей, PPEM отклоняет новый пароль, так как новый пароль должен отличаться от всех использованных ранее.
Этот параметр можно использовать для соответствия политикам безопасности организации, например, чтобы обязать пользователей регулярно менять свои пароли.
Значение по умолчанию:
0— ранее использованные пароли не сохраняются, новый пароль может быть любым.
-
Параметры шифрования #
Репозиторий может содержать конфиденциальную информацию.
Раздел crypto позволяет настроить дополнительный уровень защиты для таких секретов.
crypto: enabled:true_или_falsekey:ключ_шифрованияsalt:строка_соли
-
enabled(boolean)# Указывает, включено ли шифрование секретов.
Значение по умолчанию:
false— шифрование отключено.-
key(string)# Ключ шифрования.
Значение по умолчанию:
""(пустая строка).-
salt(string, необязательный)# Строка соли, которая добавляется к ключу перед его хешированием и сохранением.
Эта строка помогает защититься от атак с использованием предвычисленных хеш-таблиц для наиболее распространённых паролей.
Значение по умолчанию:
""(пустая строка) — соль к ключу не добавляется.
Параметры интеграции резервного копирования #
PPEM не предоставляет встроенных возможностей резервного копирования и восстановления. Вместо этого он интегрируется с решением для резервного копирования и восстановления, установленным на серверах СУБД.
Раздел backups позволяет настроить интеграцию с решениями для резервного копирования.
backups:
scheduler:
interval: интервал_синхронизации_данных
commands:
timeout: тайм_аут_команд_резервного_копирования_и_восстановленияПараметры интеграции с OIDC #
PPEM поддерживает различные сценарии аутентификации: пользователи могут проходить аутентификацию как локально, так и через сторонние службы.
Раздел oidc позволяет настроить интеграцию с поставщиком услуг OpenID Connect.
С точки зрения поставщика услуг PPEM является доверяющей стороной (relying party, RP).
За примером настройки поставщика услуг Keycloak обратитесь к Разделу 7.6.
oidc: issuer:URL_поставщика_услуг_OpenIDclient_id:идентификатор_доверяющей_стороныclient_secret:секрет_доверяющей_стороныcallback_host:хост_доверяющей_стороныlogin_timeout:тайм_аут_аутентификацииscopes: [области_доступа_OpenID]
-
issuer(string, непустое значение)# URL-адрес поставщика услуг OpenID Connect.
-
client_id(string, непустое значение)# Идентификатор клиента доверяющей стороны (RP).
Этот идентификатор должен быть выдан поставщиком услуг OpenID при настройке на его стороне.
-
client_secret(string, непустое значение)# Секрет клиента доверяющей стороны (RP).
Этот секрет должен быть выдан поставщиком услуг OpenID при настройке на его стороне.
-
callback_host(string, непустое значение)# Адрес и порт менеджера.
После успешной аутентификации пользователя поставщик услуг OpenID перенаправляет его обратно в PPEM, используя URL обратного вызова для завершения процесса аутентификации.
URL обратного вызова имеет следующий вид:
схема://хост_для_обратного_вызова/auth/oidc/callbackсхемаможет бытьhttpилиhttpsв зависимости от того, включён ли HTTPS для HTTP-сервера PPEM.-
login_timeout(time string)# Тайм-аут аутентификации пользователя.
Если происходит тайм-аут, требуется повторная аутентификация.
Значение по умолчанию:
10m.-
scopes(список строк)# Список областей доступа OpenID Connect.
Области доступа
openidиemailявляются обязательными для успешной интеграции PPEM с поставщиком услуг OpenID Connect.Значение по умолчанию:
[openid, profile, email].
Параметры интеграции с LDAP #
PPEM поддерживает различные сценарии аутентификации: пользователи могут проходить аутентификацию как локально, так и через сторонние службы.
Раздел ldap позволяет настроить интеграцию со службами каталогов OpenLDAP и Microsoft Active Directory.
За подробной информацией о настройке такой интеграции обратитесь к Главе 35.
ldap: type:тип_службы_каталоговurl:сетевой_адрес_службы_каталоговbind_username:имя_пользователя_службы_каталоговbind_password:пароль_пользователя_службы_каталоговbase_dn:базовое_отличительное_имя_службы_каталоговprefix_user_dn:префикс_отличительного_имени_для_пользователейprefix_group_dn:префикс_отличительного_имени_для_групп_пользователейuser_class:класс_объектов_пользователейuser_name_attr:атрибут_логина_пользователяuser_first_name_attr:атрибут_имени_пользователяuser_last_name_attr:атрибут_фамилии_пользователяuser_display_name_attr:атрибут_отображаемого_имени_пользователяuser_email_attr:атрибут_электронной_почты_пользователяuser_phone_attr:атрибут_телефона_пользователяuser_job_title_attr:атрибут_должности_пользователяuser_id_attr:атрибут_идентификатора_пользователяgroup_class:класс_объекта_группgroup_name_attr:атрибут_имени_группыgroup_filter:пользовательский_фильтр_группgroup_list_size_limit:максимальное_количество_групп_в_одном_запросеgroup_members_attr:атрибут_участника_группыgroup_membership_filter:пользовательский_фильтр_участия_в_группахuser_membership_attr:атрибут_участия_пользователя_в_группахuser_sync_interval:время_синхронизации_между_менеджером_и_службой_каталоговssl_cert_skip_verify:пропустить_проверку_сертификата_сервераssl_root_ca:файл_корневого_сертификата_CA
-
типу(enum, непустое значение)# Тип службы каталогов.
Возможные значения:
openldap: OpenLDAP.ms_active_directory: Microsoft Active Directory.
-
url(string, непустое значение)# Сетевой адрес службы каталогов.
-
bind_username(string, непустое значение)# Имя пользователя, используемое PPEM для подключения к службе каталогов.
Формат значения зависит от службы каталогов:
Для OpenLDAP обычно указывается полное отличительное имя (DN). Например,
cn=admin,ou=users,dc=example,dc=com.Для Microsoft Active Directory обычно указывается значение в формате
имя_пользователя@домен. Например,admin@example.com.
-
bind_password(string, непустое значение)# Пароль, используемый PPEM для подключения к службе каталогов.
-
base_dn(string, непустое значение)# Базовое отличительное имя службы каталогов.
-
prefix_user_dn(string, необязательный)# Префикс отличительного имени для пользователей.
Если этот параметр указан, поиск пользователей выполняется с помощью отличительного имени
base_user_dn=prefix_user_dn,base_dn.Значение по умолчанию:
""(пустая строка) — поиск пользователей происходит по всему каталогу.-
prefix_group_dn(string, необязательный)# Префикс отличительного имени для групп пользователей.
Если этот параметр указан, поиск групп выполняется с помощью отличительного имени
base_group_dn=prefix_group_dn,base_dn.Значение по умолчанию:
""(пустая строка) — поиск групп происходит по всему каталогу.-
user_class(string, непустое значение)# Имя класса объекта пользователя.
Обязательно для OpenLDAP, необязательно для Microsoft Active Directory.
Значение по умолчанию для Microsoft Active Directory:
""(пустая строка).-
user_name_attr(string)# Имя атрибута логина пользователя.
Значения по умолчанию:
Для OpenLDAP:
cn.Для Microsoft Active Directory:
sAMAccountName.
-
user_first_name_attr(string, необязательный)# Имя атрибута имени пользователя.
Значение по умолчанию:
givenName.-
user_last_name_attr(string, необязательный)# Имя атрибута фамилии пользователя.
Значение по умолчанию:
sn.-
user_display_name_attr(string, необязательный)# Имя атрибута отображаемого имени пользователя.
Значение по умолчанию:
displayName.-
user_email_attr(string, необязательный)# Имя атрибута электронной почты пользователя.
Значение по умолчанию:
mail.-
user_phone_attr(string, необязательный)# Имя атрибута телефона пользователя.
Значение по умолчанию:
telephoneNumber.-
user_job_title_attr(string, необязательный)# Имя атрибута должности пользователя.
Значение по умолчанию:
title.-
user_id_attr(string, необязательный)# Имя атрибута, который используется в качестве уникального идентификатора пользователя.
Значение по умолчанию для Microsoft Active Directory:
sAMAccountName.-
group_class(string, непустое значение)# Имя класса объекта группы.
Значение по умолчанию для Microsoft Active Directory:
group.-
group_name_attr(string)# Имя атрибута имени группы.
Значение по умолчанию:
cn.-
group_filter(string, необязательный)# Фильтр для поиска групп пользователей.
Пример:
(&(objectClass=group)(cn=*PPEM*))
Значение по умолчанию:
""(пустая строка).-
group_list_size_limit(integer, необязательный)# Максимальное количество групп пользователей, которое можно получить от службы каталогов в одном запросе.
Значение по умолчанию:
0— количество определяется службой каталогов.-
group_members_attr(string, необязательный)# Важно
Указывайте этот параметр, только если соответствующий атрибут существует в службе каталогов.
Имя атрибута списка участников группы.
Этот параметр и user_membership_attr — взаимоисключающие параметры.
Значение по умолчанию:
""(пустая строка).-
group_membership_filter(string, необязательный)# Фильтр для поиска групп, участником которых является указанный пользователь.
Оберните отличительное имя пользователя в знаки процента, чтобы использовать это имя в фильтре.
Переопределяет параметр
group_members_attr.Пример:
(&(objectClass=group)(uniqueMember=%
отличительное_имя_целевого_пользователя%))Значение по умолчанию:
""(пустая строка).-
user_membership_attr(string, необязательный)# Важно
Указывайте этот параметр, только если соответствующий атрибут существует в службе каталогов.
Имя атрибута, который перечисляет отличительные имена всех групп, участником которых является пользователь.
Этот параметр и group-members-attr — взаимоисключающие параметры.
Значения по умолчанию:
Для OpenLDAP:
""(пустая строка).Для Microsoft Active Directory:
memberOf.
-
user_sync_interval(time string, необязательный)# Интервал, с которым PPEM синхронизируется со службой каталогов.
Значение по умолчанию:
5m.-
ssl_cert_skip_verify(boolean, необязательный)# Важно
Использование этого параметра представляет риск для безопасности.
Рекомендуется использовать его исключительно для тестирования и отладки, но не в эксплуатационной среде.
Указывает, отключена ли проверка TLS-сертификата сервера.
Значение по умолчанию:
false— сертификат проверяется.-
ssl_root_ca(string, необязательный)# Абсолютный путь к корневому CA-сертификату, который используется для проверки сертификата сервера.
Значение по умолчанию:
""(пустая строка) — используются сертификаты из хранилища операционной системы.
Параметры менеджера пакетов #
Раздел package_managers позволяет настроить параметры, связанные с менеджером пакетов операционной системы серверов СУБД.
Это позволяет поддерживать репозитории пакетов и сами пакеты в актуальном состоянии.
package_managers:
scheduler:
interval: интервал_синхронизации
initial_delay: начальная_задержка_перед_запуском_планировщика
commands:
timeout: тайм_аут_команд_менеджера_пакетовПараметры сборщика метрик #
Раздел metrics позволяет настроить параметры сборщика метрик.
За подробной информацией о процессе сбора метрик и архитектуре мониторинга обратитесь к Разделу 3.4.
metrics: enabled:true_или_falsetimeout:тайм_аут_запроса_метрик
-
enabled(boolean)# Указывает, включён ли сбор метрик.
Значение по умолчанию:
true— метрики собираются.-
timeout(time string)# Тайм-аут запроса метрик.
Значение по умолчанию: такое же значение, что и для тайм-аута HTTP-клиента.
Параметры оповещений и уведомлений #
Раздел alerts позволяет настроить параметры оповещений и уведомлений.
За подробной информацией об оповещениях обратитесь к Главе 55.
alerts:
metrics:
request_chunk_size: количество_идентификаторов_экземпляров
logs:
request_chunk_size: количество_идентификаторов_экземпляров
cleanup_grace_period: интервал_очистки_оповещений_при_отсутствии_данных
scheduler:
interval: интервал_проверки_новых_оповещений
initial_delay: задержка_перед_запуском_планировщика_оповещений
timeout: тайм_аут_обновления_правил_триггеров_оповещений
delayed_data:
is_enabled: true_или_false
data_delay: задержка_поступления_данных_по_умолчанию_для_всех_источников
datasource_delays:
metrics: задержка_поступления_метрик
logs: задержка_поступления_журналов
max_delay: максимальная_разрешённая_задержка_поступления_данных
is_adaptive_delay: true_или_false
notifier:
num_workers: количество_параллельных_рабочих_процессов
worker_batch_size: количество_оповещений_в_одном_пакете
worker_interval: интервал_проверки_новых_оповещений
backoff_base: длительность_расчёта_экспоненциальной_задержки
max_retries: максимальное_количество_попыток_оповещения
notification_timeout: тайм_аут_оповещения
janitor_interval: интервал_опроса_рабочего_процесса_очистки
stale_processing_timeout: тайм_аут_обработки_устаревших_оповещений
email:
is_enabled: true_или_false
pool_size: максимальное_количество_параллельных_подключений
smtp:
host: имя_хоста_или_IP-адрес_SMTP-сервера
port: порт_SMTP-сервера
username: имя_пользователя_для_аутентификации_на_SMTP-сервере
password: пароль_для_аутентификации_на_SMTP-сервере
auth_type: тип_аутентификации_SMTP
from: электронная_почта_отправителя_оповещения
timeout: тайм_аут_подключения_к_SMTP-серверу
use_starttls: true_или_false
use_ssl: true_или_false
tls:
insecure_skip_verify: true_или_false
root_ca_path: файл_корневого_сертификата_CA
-
metrics.request_chunk_size(integer)# Максимальное количество идентификаторов экземпляров в одном запросе при обработке метрик.
Значение по умолчанию:
100.-
logs.request_chunk_size(integer)# Максимальное количество идентификаторов экземпляров в одном запросе при обработке журналов.
Значение по умолчанию:
100.-
cleanup_grace_period(time string)# Интервал очистки оповещений при отсутствии данных.
Значение по умолчанию:
6h.-
scheduler(object)# Параметры планировщика, который обновляет оповещения в памяти менеджера.
-
interval(time string)# Интервал проверки планировщиком новых оповещений для обработки.
Значение по умолчанию:
50s.-
initial_delay(time string)# Задержка перед первым запуском планировщика после запуска PPEM.
Значение по умолчанию:
10s.-
timeout(time string)# Тайм-аут планировщика для обновления правил триггеров оповещений.
Значение по умолчанию:
10m.
-
-
delayed_data(object)# Параметры для управления обработкой метрик и данных журналов, если они приходят с задержкой и точное время задержки неизвестно.
-
is_enabled(boolean)# Указывает, включена ли проверка метрик и журналов, получаемых с задержкой.
Значение по умолчанию:
false— PPEM не проверяет метрики и журналы, получаемые с задержкой.-
data_delay(time string)# Задержка данных по умолчанию для всех источников данных, если для них не настроены конкретные задержки.
Значение по умолчанию:
180s.-
datasource_delays(object)# Задержка при получении данных из конкретных источников. Этот параметр позволяет указывать различные задержки для метрик и журналов, так как они могут поступать с разной скоростью.
-
метрик(time string, непустое значение)# Задержка поступления метрик. Метрики обычно имеют более стабильные интервалы сбора, но могут задерживаться из-за проблем с сетью или обработкой.
-
журналов(time string, непустое значение)# Задержка поступления журналов. Журналы могут поступать чаще, но время их доставки может сильно варьироваться из-за ротации журналов и их обработки.
-
-
max_delay(time string)# Максимально допустимая задержка, исключающая обработку устаревших данных. Данные, поступившие раньше указанного времени, игнорируются для предотвращения ложных оповещений об устаревших данных.
Значение по умолчанию:
600s(10 минут).-
is_adaptive_delay(boolean)# Указывает, включён ли адаптивный механизм обучения на задержках получения данных, основанный на анализе истории получения данных.
Если этот параметр включён, фактические задержки при получении данных анализируются в PPEM на основе меток времени, и временное окно настраивается динамически.
Значение по умолчанию:
true— обучение включено.
-
-
notifier(object)# Параметры системы уведомлений, которая отправляет оповещения.
-
num_workers(integer)# Количество параллельных рабочих процессов, которые отправляют оповещения.
Значение по умолчанию:
5.-
worker_batch_size(integer)# Количество оповещений, обрабатываемых рабочими процессами в одном пакете.
Значение по умолчанию:
20.-
worker_interval(time string)# Интервал опроса, с которым рабочие процессы проверяют, не появились ли новые оповещения в базе данных репозитория.
Значение по умолчанию:
30s.-
backoff_base(time string)# Базовая длительность расчёта экспоненциальной задержки при повторной отправке неудавшегося оповещения.
Задержка повторной отправки оповещения рассчитывается как:
backoff_base × 2количество_попыток_повторной_отправкиЗначение по умолчанию:
10s.-
max_retries(integer)# Максимальное количество попыток повторно отправить неудавшееся оповещение.
Значение по умолчанию:
3.-
notification_timeout(time string)# Максимальное время, в течение которого система уведомлений должна ожидать отправки оповещения. Если по прошествии этого времени оповещение не было отправлено, оно считается неудавшимся.
Значение по умолчанию:
20s.-
janitor_interval(time string)# Интервал опроса рабочего процесса очистки (janitor worker), который очищает оповещения, застрявшие в состоянии обработки.
Значение по умолчанию:
1m.-
stale_processing_timeout(time string)# Время, по прошествии которого оповещения, застрявшие в состоянии обработки, считаются устаревшими и должны быть сброшены рабочим процессом очистки.
Значение по умолчанию:
10m.
-
-
email(object)# Параметры отправки оповещений по электронной почте.
-
is_enabled(boolean)# Указывает, включена ли отправка оповещений по электронной почте.
Если отправка по электронной почте отключена, вместо отправки по электронной почте оповещения попадают в журнал.
Значение по умолчанию:
false— оповещения по электронной почте отключены.-
pool_size(integer)# Количество параллельных подключений к SMTP-серверам.
Значение по умолчанию:
10.-
smtp(object)# Параметры SMTP-сервера, который используется для отправки оповещений.
-
host(string)# Имя хоста или IP-адрес SMTP-сервера.
Значение по умолчанию:
localhost.-
port(номер порта)# Номер порта SMTP-сервера.
Значение по умолчанию:
25.-
username(string)# Имя пользователя для аутентификации на SMTP-сервере.
Значение по умолчанию:
""(пустая строка).-
password(string)# Пароль для аутентификации на SMTP-сервере.
Значение по умолчанию:
""(пустая строка).-
auth_type(enum)# Тип аутентификации, который нужно использовать при аутентификации на SMTP-сервере.
Возможные значения:
plain: тип AUTH PLAIN.login: тип AUTH LOGIN.
Значение по умолчанию:
plain.-
from(string)# Адрес электронной почты отправителя оповещений.
Значение по умолчанию:
admin@localdomain.local.-
timeout(time string)# Тайм-аут подключения к SMTP-серверу.
Значение по умолчанию:
10s.-
use_starttls(boolean)# Указывает, включено ли расширение STARTTLS.
Если этот параметр включён, после установления незащищённого подключения выполняется команда
STARTTLSдля обновления этого подключения до защищённого.Значение по умолчанию:
false— STARTTLS отключён.-
use_ssl(boolean)# Указывает, включён ли TLS.
Если этот параметр включён, подключение является защищённым с самого начала.
Значение по умолчанию:
false— TLS отключён.-
tls(object)# Параметры протокола TLS.
-
отключить_проверку_безопасности(boolean)# Важно
Использование этого параметра представляет риск для безопасности.
Рекомендуется использовать его исключительно для тестирования и отладки, но не в эксплуатационной среде.
Указывает, отключена ли проверка TLS-сертификата сервера.
Значение по умолчанию:
false— сертификат проверяется.-
root_ca_path(string)# Абсолютный путь к корневому CA-сертификату, который используется для проверки сертификата сервера.
Значение по умолчанию:
""(пустая строка) — используются сертификаты из хранилища операционной системы.
-
-
-
Параметры исполнителя #
Раздел executor позволяет настроить параметры исполнителя заданий.
За подробной информацией о заданиях обратитесь к Главе 70.
executor: get_tasks_frequency:частота_сбора_заданийget_tasks_timeout:тайм_аут_сбора_заданийget_tasks_batch_size:размер_пакета_сбора_заданийprocessing_at_update_frequency:частота_обновления_параметра_processing_atstop_running_tasks_frequency:частота_остановки_заданий
-
get_tasks_frequency(time string, непустое значение)# Частота, с которой запланированные задания собираются исполнителем для выполнения.
-
get_tasks_timeout(time string, непустое значение)# Тайм-аут сбора запланированных заданий.
-
get_tasks_batch_size(integer, непустое значение)# Количество задач, которые могут быть собраны исполнителем в одном запросе.
-
processing_at_update_frequency(time string, непустое значение)# Частота обновления параметра
processing_atдля активных заданий.-
stop_running_tasks_frequency(time string, непустое значение)# Частота, с которой останавливаются задания.
Параметры OpenTelemetry (OTLP) #
Раздел otlp позволяет настроить параметры интеграции PPEM с инструментами трассировки, совместимыми с OpenTelemetry.
otlp:
traces:
sampler_ratio: коэффициент_выборки_трассировок
exporter:
protocol: протокол_экспорта_трассировок
endpoint_url: URL_конечной_точки_для_экспорта_трассировок
tls:
insecure_skip_verify: пропустить_проверку_сертификата_сборщика-
traces(object)# Параметры трассировки.
-
sampler_ratio(float, необязательный)# Процент трассировок, который подлежит выборке.
В зависимости от значения параметра выборка трассировок выполняется следующим образом:
0.0 <
sampler_ratio< 1.0: выборке подлежит указанный процент трассировок.Например, значение
0.7означает, что выборке подлежит 70% трассировок.sampler_ratio≥ 1.0: выборке подлежат все трассировки.Пример значения:
1.8.sampler_ratio≤ 0.0: никакие трассировки не подлежат выборке.Пример значения:
-3.3.
Значение по умолчанию:
1.0— выборке подлежат все трассировки.-
exporter(object)# Параметры экспортера.
-
protocol(enum, необязательный)# Протокол OpenTelemetry для экспорта трассировок.
Возможные значения:
http: OTLP через HTTP.grpc: OTLP через gRPC.Пустая строка: экспорт трассировок отключён.
Значение по умолчанию:
""(пустая строка) — экспорт трассировок отключён.-
endpoint_url(string, непустое значение)# URL-адрес конечной точки сборщика, используемый экспортером для отправки трассировок.
URL-адрес может содержать номер порта и путь, но не должен содержать полную или частичную строку запроса.
Примеры:
Для OTLP через HTTP:
http://localhost:4318/v1/traces.Для OTLP через gRPC:
http://localhost:4317.
-
tls.insecure_skip_verify(boolean, необязательный)# Важно
Использование этого параметра представляет риск для безопасности.
Рекомендуется использовать его исключительно для тестирования и отладки, но не в эксплуатационной среде.
Указывает, отключена ли проверка TLS-сертификата сервера.
Значение по умолчанию:
false— сертификат проверяется.
-
-
Параметры журнала событий аудита #
Раздел audit позволяет настроить параметры журнала событий аудита.
audit: enabled:true_или_falsesyslog: protocol:один_из_поддерживаемых_транспортных_протоколовaddress:адрес_syslog_сервераport:порт_Syslog_сервераfacility:категория_syslog_сообщенийtag:тег_syslog_сообщенийlog: path:путь_к_файлу_журналаmode:режим_доступа_к_файлу_журнала
-
enabled(boolean)# Указывает, включён ли журнал событий аудита.
Если журнал включён, PPEM добавляет системное правило очистки
audit_events_housekeepingдля базы данных репозитория.По умолчанию расписание автоматического запуска не настроено для этого правила. При необходимости настройте расписание.
Значение по умолчанию:
false— журнал отключён, PPEM не ведёт журнал событий аудита.-
syslog(object)# Параметры отправки журнала событий аудита на сервер syslog.
Если этот параметр не указан, для параметра
audit.enabledуказывается значениеtrue, события аудита записываются журнал, но не отправляются на syslog-сервер.-
protocol(enum)# Транспортный протокол, используемый для доставки syslog-сообщений.
Возможные значения:
localили''(пустая строка): сообщения доставляются в пределах исходного сервера и не отправляются по сети.tcp,tcp4илиtcp6: использовать TCP в качестве транспорта.Укажите
tcp4илиtcp6, чтобы явно использовать TCP поверх IPv4 или IPv6 соответственно. Укажитеtcp, чтобы PPEM выбирал протокол автоматически.udp,udp4илиudp6: использовать UDP в качестве транспорта.Укажите
udp4илиudp6, чтобы явно использовать UDP поверх IPv4 или IPv6 соответственно. Укажитеudp, чтобы PPEM выбирал протокол автоматически.ip,ip4илиip6: использовать IP в качестве транспорта.Укажите
ip4илиip6, чтобы явно использовать IPv4 или IPv6 соответственно. Укажитеip, чтобы PPEM выбирал протокол автоматически.unix,unixgramилиunixpacket: использовать сокет домена UNIX в качестве транспорта.Указанные выше значения являются типами сокетов домена UNIX, которые используют различную семантику:
Сокет типа
unixиспользует семантикуSOCK_STREAM.Сокет типа
unixgramиспользует семантикуSOCK_DGRAM.Сокет типа
unixpacketиспользует семантикуSOCK_SEQPACKET.
-
address(string)# Сетевой адрес syslog-сервера, если это требуется для выбранного транспортного протокола.
-
port(номер порта)# Порт syslog-сервера, если это требуется для выбранного транспортного протокола.
-
facility(enum)# Возможные значения:
kern: сообщения ядра.user: сообщения пользовательского уровня.mail: почтовая система.daemon: системные демоны.auth: сообщения безопасности/авторизации.syslog: сообщения, генерируемые внутри syslogd.lpr: подсистема строчной печати.news: подсистема сетевых новостей.uucp: подсистема UUCP.cron: демон планировщика задач.authpriv: сообщения безопасности/авторизации.ftp: служба FTP.local0—local7: локальная подсистема 0–7.
Значение по умолчанию:
kern.-
tag(string)# Тег syslog-сообщений.
Значение по умолчанию:
""(пустая строка) — в качестве тега используется значениеAUDIT.
-
-
log(object)# Параметры отправки журнала событий аудита в текстовый файл.
Если этот параметр не указан и для параметра
audit.enabledуказано значениеtrue, события аудита записываются в журнал, но не отправляются в текстовый файл.-
path(string)# Путь к текстовому файлу журнала.
Если файл не существует, он создаётся автоматически.
Пример:
/tmp/auth.log.-
mode(string)# Режим прав доступа для файла журнала, указанного с помощью параметра
path.Формат параметра —
0xxx, такой же, как и для командыchmod.Пример:
0644.
-
Параметры подключения к агентам #
Раздел agents_connection позволяет настроить параметры подключения к агентам.
agents_connection: read_timeout:тайм_аут_получения_данныхwrite_timeout:тайм_аут_отправки_данныхmax_connections_per_second:ограничение_частоты_подключенийlog_pings:true_или_false
-
read_timeout(time string)# Тайм-аут получения данных от агентов.
Значение по умолчанию:
30s.-
write_timeout(time string)# Тайм-аут отправки данных агентам.
Значение по умолчанию:
2s.-
max_connections_per_second(integer)# Ограничение частоты подключений.
Если количество подключений к агентам в секунду превышает это значение, любые новые подключения отклоняются с кодом состояния HTTP 429 Too Many Requests.
Значение по умолчанию:
100.-
log_pings(boolean, необязательный)# Указывает, собираются ли отладочные журналы для запросов проверки работоспособности между менеджером и агентом.
Значение по умолчанию:
false— журналирование запросов отключено.
Параметры автоматического обнаружения #
В этом разделе можно задать шаблон имени для экземпляров, обнаруженных автоматически.
autodiscovery:
instance_name_template: шаблон_имени_экземпляра-
instance_name_template(string, необязательный)# Шаблон имени для экземпляров, обнаруженных автоматически.
Файл конфигурации агента также поддерживает этот параметр. При этом значение из файла конфигурации агента имеет приоритет над значением, заданным в файле конфигурации менеджера.
Этот параметр применяется, когда в файле конфигурации агента не задан шаблон имени экземпляра.
Шаблон должен представлять собой одну строку без переносов.
Поддерживаются следующие переменные:
{{.Host}},{{.HostName}},{{.Port}},{{.Version}},{{.Edition}},{{.ServiceType}},{{.ClusterType}}и{{.SystemIdentifier}}.Если полученное имя совпадает с именем существующего экземпляра, к нему добавляется числовой суффикс (
-1,-2и так далее).Если шаблон не задан ни агентом, ни менеджером, используется шаблон по умолчанию
instance-{ID}.Значение по умолчанию:
""(пустая строка).
Параметры различных временных интервалов и тайм-аутов #
В этом разделе можно настроить различные временные интервалы и тайм-ауты.
collectors: agent_time_desync_allowance:максимально_допустимое_расхождение_времениreplication: worker: interval:интервал_между_циклами_перерасчёта_кластераoperations: watcher_timeout:тайм_аут_проверки_состояния_операцийnotifications: cleanup_age:срок_хранения_прочитанных_уведомленийcommands: cleanup_age:срок_хранения_истории_выполненных_команд
-
collectors.agent_time_desync_allowance(time string, необязательный)# Максимально разрешённое расхождение во времени между менеджером и агентами.
Если указанное ограничение превышается, в журналы PPEM записывается соответствующее предупреждение.
Значение по умолчанию:
1m.-
replication.worker.interval(time string, необязательный)# Интервал между циклами перерасчёта кластера.
Значение по умолчанию:
5s.-
operations.watcher_timeout(time string)# Тайм-аут проверки состояния операции.
-
notifications.cleanup_age(time string, необязательный)# Срок хранения прочитанных уведомлений.
По прошествии этого срока прочитанные уведомления исчезают из области уведомлений в веб-приложении.
Значение по умолчанию:
168h(7 дней).-
commands.cleanup_age(time string, необязательный)# Срок хранения истории выполненных команд.
По прошествии этого срока выполненные команды исчезают из области уведомлений веб-приложения.
Значение по умолчанию:
720h(30 дней).
ppem-manager.yml
ppem-manager.yml — YAML configuration file for the manager
Overview #
The configuration file is located at /etc/ppem-manager.yml.
You can specify how the parameters are handled using the special use_storage_config parameter.
After making any changes to the configuration file, the manager service must be restarted:
systemctl restart ppem
The configuration file is organized into the following sections:
log: Logging parameters.integrations: Integration parameters.http: HTTP parameters.jwt: JWT session parameters.crypto: Encryption parameters.backups: Backup integration parameters.oidc: OIDC integration parameters.ldap: LDAP integration parameters.package_managers: Package manager parameters.alerts: Alert and notification parameters.executor: Executor parameters.metrics: Metrics collector parameters.audit: Audit event log parameters.agents_connection: Agent connection parameters.autodiscovery: Automatic discovery parameters.
Configuring Parameter Handling #
The configuration file contains the special use_storage_config parameter.
If this parameter is set to true, values from the configuration storage override the ones from the configuration file.
Default value: false — the manager uses parameters from the configuration file.
Logging Parameters #
The log section allows configuring logging parameters for the manager.
For more information about configuring the audit event log and alert notifications, refer to the section called “Audit Event Log Parameters” and the section called “Alert and Notification Parameters”.
log: level:logging_levelformat:log_formatoptions: csv_field_delimiter:delimiter_characterfile: path:absolute_path_to_log_filemode:log_file_access_moderotation_age:rotation_age_of_log_filerotation_size:rotation_size_of_log_file
-
level(enum)# The logging level.
Possible values:
debuginfowarnerror
Each logging level includes the previous one, for example,
warnincludes log messages of theinfoanddebuglevels.-
format(enum, optional)# The logging format.
Possible values:
json: The JSON format.pretty: The prettified JSON format, such as the one the jq utility generates.csv: The plaintext CSV format.You can specify the CSV delimiter using the
options.csv_field_delimiterparameter.
Default value:
json.-
options.csv_field_delimiter(string, optional)# The single-character string that represents the CSV delimiter to use.
This parameter is only applicable if the
formatparameter is set tocsv.Default value:
,(comma character).-
file(object, optional)# The file for writing logs. The manager must have the privilege to write to this file. If the file does not exist, the manager creates it.
If this parameter is not specified, PPEM writes logs to
stdout.PPEM rotates the log file if any of the following conditions is met:
The ppem service receives the
SIGHUPsignal.The age or size of the log file equals to the value of the
rotation_ageorrotation_sizeparameter, respectively.
When rotating the log file, PPEM saves it and appends a timestamp to its name. Then the log file specified in the
pathparameter is cleared.-
path(string, not empty)# The absolute path to the log file, for example,
/var/log/ppem.log.-
mode(string, not empty)# The numeric string that represents the file access mode in the format similar to the one chmod uses, for example,
0644.-
rotation_age(time string, optional)# The maximum amount of time to use an individual log file. After this time a new log file is created.
Default value:
""(empty string) — the time-based creation of new log files is disabled.-
rotation_size(string, optional)# The maximum size of an individual log file. After this amount of data is emitted into a log file, a new log file is created.
Default value:
""(empty string) — the size-based creation of new log files is disabled.
Repository Database Parameters #
The repo section allows configuring the repository database parameters.
Most of the parameters specify how to connect to the repository database, and the schema parameter specifies the name of the schema where to store the database objects.
repo: schema:schema_for_repository_objectsurl:connection_URL# Key/value connection string (alternative) host:host_nameport:portname:database_nameuser:user_namepassword:user_passwordfallback_addresses: [list_of_fallback_host_addresses] target_session_attrs:target_session_attributessslmode:secure_connection_modesslrootcert:root_CA_certificate_filesslcert:public_certificate_filesslkey:private_key_filemax_conns:maximum_number_of_connectionsmax_conn_lifetime:active_connection_timeoutmax_conn_idle_time:idle_connection_timeout# Parameters of connections which relate to instance objects instance_objects_repo_pool: max_conns:maximum_number_of_connectionsmax_conn_lifetime:active_connection_timeoutmax_conn_idle_time:idle_connection_timeout
-
schema(string)# The name of the schema where to store the repository database objects.
For a new PPEM installation, you can simply specify the schema name. Changing the schema name for a running PPEM installation with multiple existing objects requires following a more complex procedure.
Default value:
public.-
url(string, optional)# The connection URL for the repository database.
Example:
postgres://ppem@dbms.example.org/ppem.Default value:
""(empty string).-
host(string, optional)
port(port number, optional)
name(string, optional)
user(string, optional)
password(string, optional)# Keyword/value connection string parameters for the repository database.
If the connection URI is specified using the url parameter, it takes precedence over the keyword/value connection string.
Default value for
port:5432.Default value for other parameters:
""(empty string).-
fallback_addresses(list of strings, optional)# The list of fallback addresses in the
host:portformat.If a connection attempt that uses the connection strings above fails, other connection attempts are made using fallback addresses.
Example:
fallback_addresses: - prod.example.org:5432 - dev.example.com:55432
Default value:
[](empty list).-
target_session_attrs(string, optional)# The target session attributes.
Default value:
any.-
sslmode(string, optional)
sslrootcert(string, optional)
sslcert(string, optional)
sslkey(string, optional)# The SSL parameters of the database connection.
Default value for
sslmode:prefer.Default value for other parameters:
""(empty string).-
max_conns(integer, optional)
max_conn_lifetime(time string, optional)
max_conn_idle_time(time string, optional)# The parameters of the connection pooler that is used when connecting to the repository database:
max_conns: The maximum number of allowed connections.Default value:
4.max_conn_lifetime: The active connection timeout.Active connections that exceed the timeout are closed.
Default value:
1h.max_conn_idle_time: The idle connection timeout.Idle connections that exceed the timeout are closed.
Default value:
10m.
-
instance_objects_repo_pool(object, optional)# The parameters of the connection pooler that is used when working with instance objects:
-
max_conns(integer, optional)
max_conn_lifetime(time string, optional)
max_conn_idle_time(time string, optional) max_conns: The maximum number of allowed connections.Default value:
4.max_conn_lifetime: The active connection timeout.Active connections that exceed the timeout are closed.
Default value:
1h.max_conn_idle_time: The idle connection timeout.Idle connections that exceed the timeout are closed.
Default value:
10m.
-
Integration Parameters #
The integrations section allows configuring PPEM integration with other Postgres Pro products and solutions.
integrations:
askpostgres:
enabled: true_or_false
base_url: "https://ask.postgrespro.ru"
source: "ppem"
timeouts:
base: non_streaming_HTTP_requests_timeout
time_to_first_token: first_token_timeout
idle: streaming_HTTP_requests_idle_timeout
-
askpostgres(object)# Parameters of integration with Ask Postgres. For more information, refer to Chapter 75.
-
enabled(boolean)# Specifies whether the AskPostgres chat integration is enabled.
If set to
false, the chat icon is not displayed in the web application, and the remaining parameters are optional.Default value:
false— integration is disabled.-
base_url(string)# The base URL of the Ask Postgres service.
Do not change this parameter unless you are using a locally deployed Ask Postgres instance.
Default value:
https://ask.postgrespro.ru/api/v1.-
source(string)# Important
This is a service parameter, do not change it.
The request source ID sent in the
X-SourceHTTP header to the Ask Postgres service.Fixed value:
ppem.-
timeouts(object)# The timeout parameters for requests to Ask Postgres:
-
base(time string)# The timeout for non-streaming HTTP requests, such as creating a chat, retrieving messages, or canceling response generation.
Default value:
20s.-
time_to_first_token(time string)# The timeout for receiving the first token in the response stream. If the stream starts but no token is received within this time, the request fails with a timeout error.
Default value:
120s.-
idle(time string)# The idle timeout for the response stream, which resets whenever a new token is received. If no token is received within this time, the stream fails with a timeout error.
Default value:
60s.
-
-
HTTP Parameters #
The http section allows configuring HTTP server and client parameters, as well as multiple API-related parameters.
http:
server:
address: listen_network_address
port: listen_network_port
mtls_port: listen_mtls_network_port
tls:
cert_file: public_certificate_file
key_file: private_key_file
client_ca_file: root_ca_certificate_file
static_files_path: path_to_web_application_static_files
timeout: HTTP_request_processing_timeout
security:
enabled: true_or_false
csp_policy: content_security_policy_header
cache_control: cache_control_header
pragma: Pragma_header
expires: expires_header
frame_options: x_content_type_header
content_type_options: x_content_type_options_header
permissions_policy: permissions_policy_header
referrer_policy: referrer_policy_header
strict_transport_security: strict_transport_security_header
cross_origin_embedder_policy: cross_origin_embedder_policy_header
cross_origin_opener_policy: cross_origin_opener_policy_header
cross_origin_resource_policy: cross_origin_resource_policy_header
cors:
allowed_origins: [list_of_allowed_origins]
allowed_methods: [list_of_allowed_HTTP_methods]
allowed_headers: [list_of_allowed_HTTP_headers]
exposed_headers: [list_of_exposed_HTTP_headers]
allow_credentials: access_control_allow_credentials_header
max_age: access_control_max_age_header
real_ip_header_name: header_with_originating_IP_address
response_compression_level: compression_level_of_server_response
client:
timeouts:
http: HTTP_request_timeout
tls_handshake: TLS_handshake_timeout
dialer: HTTP_dialer_timeout
response_header: HTTP_response_header_wait_timeout
insecure_skip_verify: skip_server_certificate_verification
root_ca_files: [list_of_root_CA_certificate_files]
pagination:
max_page_size: maximum_objects_in_single_response
api:
disabled: {object_with_disabled_API_endpoints}
HTTP Server Parameters #
-
address(string, optional)# The network address to listen on.
If you specify an empty string, the server listens on all network interfaces.
Default value:
localhost.-
port(port number, optional)# The network port to listen on.
Default value:
8080.-
mtls_port(port number, optional)# The mTLS network port to listen on.
This parameter takes effect only when mTLS is configured in the
tlssection.Default value:
9443.-
tls(object)# The TLS certificate parameters required to enable HTTPS on the server for both web application and agent connections. Optionally, mutual TLS (mTLS) can be configured.
If mTLS is enabled and configured on both the manager and agent sides, it adds an additional layer of security.
If you do not specify any certificate and key files (empty strings), the web application is only available via HTTP, and neither HTTPS nor mTLS are used for manager-to-agent connections.
The port for the web application is specified in
portand the port for mTLS/incoming agent connections is specified inmtls_port.-
cert_file(string)# The absolute path to the public certificate file.
Default value:
""(empty string).-
key_file(string)# The absolute path to the private key file.
Default value:
""(empty string).-
client_ca_file(string)# The absolute path to the CA certificate file used to verify agent certificates.
Default value:
""(empty string).
-
-
static_files_path(string)# The path to the static files of the PPEM web application.
Default value:
""(empty string).-
timeout(time string, optional)# The processing timeout for an HTTP request.
Default value:
60s.-
security(object)# Security parameters of the HTTP server. These parameters are mostly used to set the values of the security-related HTTP headers.
You must configure the
cross-origin-*-policyparameters manually because PPEM does not provide default values for them.-
enabled(boolean, optional)# Specifies whether the processing of the security-related HTTP headers is enabled.
Default value:
false— processing is disabled.-
csp_policy(string, optional)# The value of the Content-Security-Policy HTTP response header. Helps to prevent XSS, clickjacking, and other code injection attacks.
Default value depends on whether the HTTP server is configured to handle HTTPS:
HTTP mode:
default-src 'none'; script-src 'self' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self'; connect-src 'self'; media-src 'self'; form-action 'self'; base-uri 'self'; frame-ancestors 'none'; frame-src https://postgrespro.com/; object-src 'none'.HTTPS mode:
default-src 'none'; script-src 'self' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self'; connect-src 'self'; media-src 'self'; form-action 'self'; base-uri 'self'; frame-ancestors 'none'; frame-src https://postgrespro.com/; object-src 'none'; upgrade-insecure-requests.
-
cache_control(string, optional)# The value of the Cache-Control HTTP header. Controls caching in browsers. The default value helps to prevent caching of API responses that may contain sensitive or dynamic data.
Default value:
no-store, no-cache, must-revalidate.-
pragma(string, optional)# The value of the Pragma HTTP header.
This header is deprecated and provides backward compatibility with HTTP/1.0 caches that do not support the Cache-Control HTTP header.
Default value:
no-cache.-
expires(string, optional)# The value of the Expires HTTP response header.
This header provides backward compatibility with HTTP/1.0 caches that do not support the Cache-Control HTTP header.
Default value:
0.-
frame_options(string, optional)# The value of the X-Frame-Options HTTP response header. Helps to prevent clickjacking attacks.
Default value:
""(empty string).-
content_type_options(string, optional)# The value of the X-Content-Type-Options HTTP response header. Helps to prevent MIME type sniffing attacks.
Default value:
""(empty string).-
permissions_policy(string, optional)# The value of the Permissions-Policy HTTP response header. Controls which browser features and device APIs can be used. The default value denies access to the features which may disclose sensitive information, such as camera, microphone, and geolocation.
Default value:
"accelerometer=(), autoplay=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=()".-
referrer_policy(string, optional)# The value of the Referrer-Policy HTTP response header. Controls how much referrer information to include with requests.
Default value:
strict-origin-when-cross-origin.-
strict_transport_security(string, optional)# The value of the Strict-Transport-Security HTTP response header. Forces browsers to use HTTPS connections only. Applicable only if the HTTP server is configured to handle HTTPS, otherwise ignored.
Default value:
HTTP mode:
""(empty string) — not applicable.HTTPS mode:
max-age=31536000; includeSubDomains.
-
cross_origin_embedder_policy(string)# The value of the Cross-Origin-Embedder-Policy HTTP response header.
Default value:
""(empty string).-
cross_origin_opener_policy(string)# The value of the Cross-Origin-Opener-Policy HTTP response header.
Default value:
""(empty string).-
cross_origin_resource_policy(string)# The value of the Cross-Origin-Resource-Policy HTTP response header.
Default value:
""(empty string).
-
-
cors(object)# CORS-related security parameters of the HTTP server.
Most of these parameters are related to the
Access-Control-*headers. For convenience, such parameters are represented as a list of strings. Then, depending on the header format, these strings are processed as follows:If a single value can be specified in the header, then each string from the list is sent in the dedicated header.
Example:
allowed_origins: - "example.com" -> Access-Control-Allow-Origin: example.com - "prod.example.org" -> Access-Control-Allow-Origin: prod.example.org
If multiple values can be specified in the header, then the strings from the list are concatenated, and the resulting string is sent in the header.
Example:
exposed_headers: -> Access-Control-Expose-Headers: Content-Encoding, X-Forwarded-For - "Content-Encoding" - "X-Forwarded-For"
-
allowed_origins(list of strings)# The values of the Access-Control-Allow-Origin HTTP response headers.
Default value:
[](empty list).-
allowed_methods(list of strings)# The values of the Access-Control-Allow-Methods HTTP response header.
Default value:
[](empty list).-
allowed_headers(list of strings)# The values of the Access-Control-Allow-Headers HTTP response header.
Default value:
[](empty list).-
exposed_headers(list of strings)# The values of the Access-Control-Expose-Headers HTTP response header.
Default value:
[](empty list).-
allow_credentials(boolean)# The value of the Access-Control-Allow-Credentials HTTP response header.
Default value:
false.-
max_age(integer)# The value of the Access-Control-Max-Age HTTP response header.
Default value:
0.
-
real_ip_header_name(string, optional)# The name of the HTTP header which must be used for identifying the originating IP address of a client connecting to the HTTP server through a proxy server.
The X-Forwarded-For header is an example of such header.
Default value:
""(empty string).-
response_compression_level(integer, optional)# Compression level of the response from the server.
Possible values:
-2(Huffman only compression)-1(Default compression level is set to 6)0(Compression is disabled)Number in a range from 1 (best speed) to 9 (best compression)
Default value: 0 (compression is disabled).
HTTP Client Parameters #
-
timeouts(object)# Timeouts for the HTTP client.
-
http(time string)# The HTTP request timeout.
Default value:
60s.-
tls_handshake(time string)# The TLS handshake timeout.
Default value:
2s.-
dialer(time string)# The dialer timeout when the client tries to reach the server. A connection attempt must succeed within this time interval.
Default value:
2s.-
response_header(time string)# The timeout of waiting for the HTTP response headers after sending an HTTP request to a server.
Default value:
20s.
-
-
insecure_skip_verify(boolean, optional)# Important
Using this parameter poses a security risk.
It is recommended to use it exclusively for testing and debugging purposes, but not in the production environment.
Specifies whether the verification of a server TLS certificate is disabled.
Default value:
false— the certificate is verified.-
root_ca_files(list of strings, optional)# The list of absolute paths to root CA certificates used to verify a server certificate.
Default value:
[](empty list) — the certificates from the operating system store are used.
HTTP API Server Parameters #
-
pagination.max_page_size(integer, optional)# The maximum number of entries in a single API response (the page size).
Default value:
100.-
api.disabled(object, optional)# The object that contains the disabled HTTP REST API endpoints. If a client requests a disabled endpoint, a server sends an error response with 503 Service Unavailable HTTP status code.
The object contains entries in the following format:
api_endpoint: list_of_disabled_http_methods.Example:
api: disabled: "/v1/endpoint": ["GET", "POST", "PUT", "DELETE", "PATCH"] "/v1/instances/{id}/endpoint": ["POST"]Default value:
{}(empty object) — all API endpoints are enabled.
JWT Session Parameters #
The jwt section allows configuring user session parameters and parameters related to JSON Web Tokens.
jwt: secret:secret_for_signing_JWTSlifetime: access:access_token_lifetimerefresh:refresh_token_lifetimemax_sessions_per_user:maximum_sessions_per_usermax_failed_login_attempts:maximum_failed_login_attempts_per_userpassword_policy: length_min:minimum_password_lengthlength_max:maximum_password_lengthallowed_symbols:allowed_characters_in_passwordentropy_min:minimum_entropy_of_passwordhistory_depth:size_of_stored_password_history
-
secret(string)# The secret that is used to sign an issued token.
Refresh tokens are used to issue access tokens. Access tokens are used to authenticate users in PPEM.
For more information about these tokens, refer to Section 7.5.
Default value:
secret.-
lifetime(object)# The token lifetime values. A token that is valid longer than the specified value is considered expired and cannot be used. In such case, a new token must be issued.
-
max_sessions_per_user(integer)# The maximum number of simultaneous active sessions per user.
Default value:
10.A session is considered active until its refresh token expires. When the number of active sessions reaches the limit, a new login attempt is rejected, but existing sessions are not terminated.
The limit applies only to user sessions. It does not apply to the built-in administrator account and to agent sessions.
-
max_failed_login_attempts(integer)# The maximum number of failed attempts to log in to the web application, after which the user is automatically blocked from logging in again.
Default value:
0.When set to
0, automatic blocking is disabled and failed login attempts are not counted. When set to a value greater than0, the user account is automatically blocked when the number of failed login attempts reaches the specified threshold. The failed login attempt counter is maintained for each user individually and is reset after a successful login.When automatic blocking is enabled, the table of users additionally displays the current number of failed login attempts for each user. For a user blocked for exceeding the failed login attempt limit, the time when the user was blocked is also displayed.
Users blocked for exceeding the failed login attempt limit are not unblocked automatically. Only an administrator can unblock such a user by changing the user status to Active, which also resets the failed login attempt counter. For more information, refer to Section 42.1.5.
Note
Set
max_failed_login_attemptsto a non-default value to comply with your organization security policies.-
password_policy(object)# The password policy that is applied for all objects that require a password to be specified. The policy is in effect for the entire PPEM installation.
-
length_min(integer)# The minimum password length.
Default value:
8.-
length_max(integer)# The maximum password length.
Default value:
64.-
allowed_symbols(string)# Allowed password characters.
This parameter can be used for compliance with the organization security policies, for example, to exclude ambiguous characters from passwords.
Example:
abcdEFGHI123456$%^
Default value:
""(empty string) — any character is permitted.-
entropy_min(integer)# The minimum entropy value for passwords calculated as:
password_length × log2(size_of(allowed_symbols))The entropy value serves as the measure of the password complexity and its cryptographic strength. It is recommended to maintain an entropy value of 50–70 or higher.
Example:
If allowed characters are
abcdefghijklmnopqrstuvwxyz, and the password ishelloaaa, then the entropy is:8 × log2(size_of(26)) = 37.6Therefore, this password has low entropy value.
Default value:
0— a password of any entropy can be used.-
history_depth(integer)# The number of previous passwords that PPEM stores.
If the hash of a new password of a user matches any of the stored previous password hashes, then PPEM rejects the new password, requiring it to differ from all previously used passwords.
This parameter can be used for compliance with the organization security policies, for example, to enforce users to rotate their passwords.
Default value:
0— no previously used passwords are stored, a new password can be any.
-
Encryption Parameters #
The repository can contain sensitive information.
The crypto section allows configuring an additional protection level for such secrets.
crypto: enabled:true_or_falsekey:encryption_keysalt:salt_string
-
enabled(boolean)# Specifies whether the encryption of secrets is enabled.
Default value:
false— encryption is disabled.-
key(string)# The encryption key.
Default value:
""(empty string).-
salt(string, optional)# The salt string that is added to the key prior to hashing and storing it.
This string helps to defend against attacks that use precomputed hash tables for the most common passwords.
Default value:
""(empty string) — salt is not added to the key.
Backup Integration Parameters #
PPEM does not provide the backup and restore capabilities. Instead, it integrates with a backup and restore solution which is installed on the DBMS servers.
The backups section allows configuring integration with backup solutions.
backups:
scheduler:
interval: interval_between_data_synchronization
commands:
timeout: timeout_of_backup_and_restore_commands
OIDC Integration Parameters #
PPEM supports different authentication flows: it can authenticate users either locally or via third-party services.
The oidc section allows configuring integration with an OpenID Connect provider.
PPEM is the relying party (RP) from the provider point of view.
For a configuration example of the Keycloak provider, refer to Section 7.6.
oidc: issuer:OpenID_provider_URLclient_id:relying_party_IDclient_secret:relying_party_secretcallback_host:relying_party_hostlogin_timeout:authentication_timeoutscopes: [OpenID_scopes]
-
issuer(string, not empty)# The URL of the OpenID Connect provider.
-
client_id(string, not empty)# The client ID of the relying party (RP).
This ID must be issued by the OpenID provider during the configuration process on the provider side.
-
client_secret(string, not empty)# The client secret of the relying party (RP).
This secret must be issued by the OpenID provider during the configuration process on the provider side.
-
callback_host(string, not empty)# The address and port of the manager.
After successful authentication of a user, the OpenID provider redirects the user back to PPEM using the callback URL to finish the authentication flow.
The callback URL is as follows:
scheme://callback_host/auth/oidc/callbackThe
schemecan behttporhttpsdepending on whether HTTPS is enabled for the PPEM HTTP server.-
login_timeout(time string)# The user authentication timeout.
If the timeout occurs, reauthentication is required.
Default value:
10m.-
scopes(list of strings)# The list of OpenID Connect scopes.
The
openidandemailscopes are mandatory for successful integration of PPEM with the OpenID Connect provider.Default value:
[openid, profile, email].
LDAP Integration Parameters #
PPEM supports different authentication flows: it can authenticate users either locally or via third-party services.
The ldap section allows configuring integration with the OpenLDAP and Microsoft Active Directory directory services.
For more information about configuring such integration, refer to Chapter 35.
ldap: type:directory_service_typeurl:directory_service_network_addressbind_username:directory_service_usernamebind_password:directory_service_user_passwordbase_dn:directory_service_base_DNprefix_user_dn:DN_prefix_for_usersprefix_group_dn:DN_prefix_for_user_groupsuser_class:user_object_classuser_name_attr:user_login_attributeuser_first_name_attr:user_first_name_attributeuser_last_name_attr:user_last_name_attributeuser_display_name_attr:user_display_name_attributeuser_email_attr:user_email_attributeuser_phone_attr:user_phone_attributeuser_job_title_attr:user_job_title_attributeuser_id_attr:user_ID_attributegroup_class:group_object_classgroup_name_attr:group_name_attributegroup_filter:custom_group_filtergroup_list_size_limit:maximum_number_of_groups_in_single_requestgroup_members_attr:group_member_attributegroup_membership_filter:custom_group_membership_filteruser_membership_attr:user_group_membership_attributeuser_sync_interval:manager_and_directory_service_synchronization_timessl_cert_skip_verify:skip_server_certificate_verificationssl_root_ca:root_CA_certificate_file
-
type(enum, not empty)# The type of the directory service.
Possible values:
openldap: OpenLDAP.ms_active_directory: Microsoft Active Directory.
-
url(string, not empty)# The network address of the directory service.
-
bind_username(string, not empty)# The user name that is used by PPEM to connect to the directory service.
The value format depends on the directory service:
For OpenLDAP, a complete distinguished name (DN) is usually specified. For example,
cn=admin,ou=users,dc=example,dc=com.For Microsoft Active Directory, a value in the
username@domainformat is usually specified. For example,admin@example.com.
-
bind_password(string, not empty)# The password that is used by PPEM to connect to the directory service.
-
base_dn(string, not empty)# The base distinguished name of the directory service.
-
prefix_user_dn(string, optional)# The distinguished name prefix for users.
If this parameter is specified, users are searched using the
base_user_dn=prefix_user_dn,base_dndistinguished name.Default value:
""(empty string) — search for users in the entire directory.-
prefix_group_dn(string, optional)# The distinguished name prefix for user groups.
If this parameter is specified, groups are searched using the
base_group_dn=prefix_group_dn,base_dndistinguished name.Default value:
""(empty string) — search for groups in the entire directory.-
user_class(string, not empty)# The name of the user object class.
Required for OpenLDAP, optional for Microsoft Active Directory.
Default value for Microsoft Active Directory:
""(empty string).-
user_name_attr(string)# The name of the user login attribute.
Default values:
For OpenLDAP:
cn.For Microsoft Active Directory:
sAMAccountName.
-
user_first_name_attr(string, optional)# The name of the user first name attribute.
Default value:
givenName.-
user_last_name_attr(string, optional)# The name of the user last name attribute.
Default value:
sn.-
user_display_name_attr(string, optional)# The name of the user display name attribute.
Default value:
displayName.-
user_email_attr(string, optional)# The name of the user email address attribute.
Default value:
mail.-
user_phone_attr(string, optional)# The name of the user phone number attribute.
Default value:
telephoneNumber.-
user_job_title_attr(string, optional)# The name of the user job title attribute.
Default value:
title.-
user_id_attr(string, optional)# The name of the attribute that is used as a unique user ID.
Default value for Microsoft Active Directory:
sAMAccountName.-
group_class(string, not empty)# The name of the group object class.
Default value for Microsoft Active Directory:
group.-
group_name_attr(string)# The name of the group name attribute.
Default value:
cn.-
group_filter(string, optional)# The filter for searching user groups.
Example:
(&(objectClass=group)(cn=*PPEM*))
Default value:
""(empty string).-
group_list_size_limit(integer, optional)# The maximum number of user groups that can be received from the directory service in a single query.
Default value:
0— the number is determined by the directory service.-
group_members_attr(string, optional)# Important
Specify this parameter only if the corresponding attribute exists in the directory service.
The name of the group member list attribute.
This parameter is mutually exclusive with the user_membership_attr parameter.
Default value:
""(empty string).-
group_membership_filter(string, optional)# The filter to search for the groups the specified user is a member of.
Wrap the distinguished name of the user into the percent signs to use the name in the filter.
Overrides the
group_members_attrparameter.Example:
(&(objectClass=group)(uniqueMember=%
target_user_DN%))Default value:
""(empty string).-
user_membership_attr(string, optional)# Important
Specify this parameter only if the corresponding attribute exists in the directory service.
The name of the attribute that lists the distinguished names of all the groups the user belongs to.
This parameter is mutually exclusive with the group-members-attr parameter.
Default values:
For OpenLDAP:
""(empty string).For Microsoft Active Directory:
memberOf.
-
user_sync_interval(time string, optional)# The interval in which PPEM synchronizes with the directory service.
Default value:
5m.-
ssl_cert_skip_verify(boolean, optional)# Important
Using this parameter poses a security risk.
It is recommended to use it exclusively for testing and debugging purposes, but not in the production environment.
Specifies whether the verification of a server TLS certificate is disabled.
Default value:
false— the certificate is verified.-
ssl_root_ca(string, optional)# The absolute path to the root CA certificate used to verify a server certificate.
Default value:
""(empty string) — the certificates from the operating system store are used.
Package Manager Parameters #
The package_managers section allows configuring the parameters related to the package manager of the operating system of DBMS servers.
This allows maintaining package repositories and packages up to date.
package_managers:
scheduler:
interval: synchronization_time_interval
initial_delay: initial_delay_before_starting_scheduler
commands:
timeout: timeout_of_package_manager_related_commands
Metrics Collector Parameters #
The metrics section allows configuring the metric collector parameters.
For more information about the metric collection process, and monitoring architecture, refer to Section 3.4.
metrics: enabled:true_or_falsetimeout:metrics_request_timeout
-
enabled(boolean)# Specifies whether the metrics collection is enabled.
Default value:
true— metrics are collected.-
timeout(time string)# The metrics request timeout.
Default value: The same value as for HTTP client timeout.
Alert and Notification Parameters #
The alerts section allows configuring alert and notification parameters.
For more information about alerts, refer to Chapter 55.
alerts:
metrics:
request_chunk_size: number_of_instance_IDs
logs:
request_chunk_size: number_of_instance_IDs
cleanup_grace_period: alert_cleanup_interval_if_no_data_is_received
scheduler:
interval: interval_for_checking_new_alerts
initial_delay: delay_for_starting_alert_scheduler
timeout: timeout_for_updating_alert_trigger_rules
delayed_data:
is_enabled: true_or_false
data_delay: default_data_arrival_delay_for_all_sources
datasource_delays:
metrics: delay_for_metrics_arrival
logs: delay_for_log_arrival
max_delay: maximum_allowed_data_arrival_delay
is_adaptive_delay: true_or_false
notifier:
num_workers: number_of_concurrent_workers
worker_batch_size: number_of_alerts_in_one_batch
worker_interval: interval_for_checking_new_alerts
backoff_base: exponential_backoff_calculation_duration
max_retries: maximum_number_of_alert_attempts
notification_timeout: alert_timeout
janitor_interval: janitor_worker_polling_interval
stale_processing_timeout: stale_alert_processing_timeout
email:
is_enabled: true_or_false
pool_size: maximum_number_of_concurrent_connections
smtp:
host: SMTP_server_hostname_or_IP
port: SMTP_server_port
username: username_for_SMTP_server_authentication
password: password_for_SMTP_server_authentication
auth_type: SMTP_authentication_type
from: alert_sender_email
timeout: SMTP_server_connection_timeout
use_starttls: true_or_false
use_ssl: true_or_false
tls:
insecure_skip_verify: true_or_false
root_ca_path: root_CA_certificate_file
-
metrics.request_chunk_size(integer)# The maximum number of instance IDs contained within a single request when processing metrics.
Default value:
100.-
logs.request_chunk_size(integer)# The maximum number of instance IDs contained within a single request when processing logs.
Default value:
100.-
cleanup_grace_period(time string)# The interval after which alerts are cleaned up if no data is received.
Default value:
6h.-
scheduler(object)# The parameters of the scheduler that updates alerts in the manager memory.
-
interval(time string)# The interval for the scheduler to check for new alerts to process.
Default value:
50s.-
initial_delay(time string)# The delay before starting the scheduler for the first time after the start of PPEM.
Default value:
10s.-
timeout(time string)# The scheduler timeout for updating alert trigger rules.
Default value:
10m.
-
-
delayed_data(object)# The parameters for managing delayed metrics and logs with unknown delay time.
-
is_enabled(boolean)# Specifies whether the checking of delayed metrics and logs is enabled.
Default value:
false— PPEM does not check delayed metrics and logs.-
data_delay(time string)# The default data delay for all data sources when specific delays are not configured.
Default value:
180s.-
datasource_delays(object)# The data delay for specific data sources. This parameter allows specifying different delays for metrics and logs as they may arrive at different rates.
-
metrics(time string, not empty)# The delay for the metrics arrival. Metrics typically have more consistent collection intervals but may be delayed due to network or processing issues.
-
logs(time string, not empty)# The delay for the logs arrival. Logs may arrive more frequently but with higher variability in timing due to log rotation and processing.
-
-
max_delay(time string)# The maximum allowed delay to prevent processing data that is too old. Data found earlier than this value is ignored to prevent false alerts from stale data.
Default value:
600s(10 minutes).-
is_adaptive_delay(boolean)# Specifies whether the adaptive delay learning based on observed data arrival patterns is enabled.
When enabled, PPEM learns on actual delays from data timestamps and adjusts the lookback window dynamically.
Default value:
true— the learning is enabled.
-
-
notifier(object)# The parameters of the notifier that sends alerts.
-
num_workers(integer)# The number of concurrent workers that will send alerts.
Default value:
5.-
worker_batch_size(integer)# The number of alerts processed by workers in one batch.
Default value:
20.-
worker_interval(time string)# The polling interval for workers to check for new alerts in the repository database.
Default value:
30s.-
backoff_base(time string)# The base duration for the exponential backoff calculation when resending a failed alert.
The delay for resending the alert is calculated as:
backoff_base × 2number_of_retry_attemptsDefault value:
10s.-
max_retries(integer)# The maximum number of attempts to resend a failed alert.
Default value:
3.-
notification_timeout(time string)# The maximum amount of time for the notifier to wait for an alert to be sent before considering it failed.
Default value:
20s.-
janitor_interval(time string)# The polling interval for the janitor worker that cleans alerts stuck in the processing state.
Default value:
1m.-
stale_processing_timeout(time string)# The amount of time after which alerts stuck in the processing state are considered stale and must be reset by the janitor worker.
Default value:
10m.
-
-
email(object)# The parameters for sending alerts via email.
-
is_enabled(boolean)# Specifies whether the email notification channel is enabled.
If the email notification channel is disabled, then alerts are written to logs instead of being sent via email.
Default value:
false— email notification channel is disabled.-
pool_size(integer)# The number of concurrent connections to SMTP servers.
Default value:
10.-
smtp(object)# The parameters of the SMTP server used for sending alerts.
-
host(string)# The hostname or IP address of the SMTP server.
Default value:
localhost.-
port(port number)# The port number of the SMTP server.
Default value:
25.-
username(string)# The username for authenticating in the SMTP server.
Default value:
""(empty string).-
password(string)# The password for authenticating in the SMTP server.
Default value:
""(empty string).-
auth_type(enum)# The authentication type to use when authenticating in the SMTP server.
Possible values:
plain: The AUTH PLAIN type.login: The AUTH LOGIN type.
Default value:
plain.-
from(string)# The email address of the alert sender.
Default value:
admin@localdomain.local.-
timeout(time string)# The SMTP server connection timeout.
Default value:
10s.-
use_starttls(boolean)# Specifies whether the STARTTLS extension is enabled.
If enabled, then the
STARTTLScommand is issued after establishing an insecure connection to upgrade the connection to a secure one.Default value:
false— STARTTLS is disabled.-
use_ssl(boolean)# Specifies whether TLS is enabled.
If enabled, then the connection is secured from the beginning.
Default value:
false— TLS is disabled.-
tls(object)# The TLS protocol parameters.
-
insecure_skip_verify(boolean)# Important
Using this parameter poses a security risk.
It is recommended to use it exclusively for testing and debugging purposes, but not in the production environment.
Specifies whether the verification of a server TLS certificate is disabled.
Default value:
false— the certificate is verified.-
root_ca_path(string)# The absolute path to the root CA certificate used to verify a server certificate.
Default value:
""(empty string) — the certificates from the operating system store are used.
-
-
-
Executor Parameters #
The executor section allows configuring the task executor parameters.
For more information about tasks, refer to Chapter 70.
executor: get_tasks_frequency:task_gathering_frequencyget_tasks_timeout:task_gathering_timeoutget_tasks_batch_size:task_gathering_batch_sizeprocessing_at_update_frequency:updating_processing_at_frequencystop_running_tasks_frequency:task_stopping_frequency
-
get_tasks_frequency(time string, not empty)# The frequency at which scheduled tasks are gathered by the executor to be executed.
-
get_tasks_timeout(time string, not empty)# The timeout of gathering scheduled tasks.
-
get_tasks_batch_size(integer, not empty)# The number of tasks that can be gathered by the executor in a single request.
-
processing_at_update_frequency(time string, not empty)# The frequency at which the
processing_atparameter is updated for the active tasks.-
stop_running_tasks_frequency(time string, not empty)# The frequency at which the tasks are stopped.
OpenTelemetry (OTLP) Parameters #
The otlp section allows configuring parameters of the PPEM integration with the OpenTelemetry-compatible tracing tools.
otlp:
traces:
sampler_ratio: trace_sampling_ratio
exporter:
protocol: protocol_for_exporting_traces
endpoint_url: collector_endpoint_URL_for_exporting_traces
tls:
insecure_skip_verify: skip_collector_certificate_verification
-
traces(object)# The tracing parameters.
-
sampler_ratio(float, optional)# The percentage of traces that are sampled.
Depending on the parameter value, traces are sampled as follows:
0.0 <
sampler_ratio< 1.0: The specified percentage of traces is sampled.For example, the
0.7value means that 70% of traces are sampled.sampler_ratio≥ 1.0: All traces are sampled.Example value:
1.8.sampler_ratio≤ 0.0: No traces are sampled.Example value:
-3.3.
Default value:
1.0— all traces are sampled.-
exporter(object)# The exporter parameters.
-
protocol(enum, optional)# The OpenTelemetry protocol to use for exporting traces.
Possible values:
http: OTLP over HTTP.grpc: OTLP over gRPC.Empty string: Trace exporting is disabled.
Default value:
""(empty string) — trace exporting is disabled.-
endpoint_url(string, not empty)# The endpoint URL of the collector to be used by the exporter for sending traces.
The URL can contain a port number and path, but not a full or partial query string.
Examples:
For OTLP over HTTP:
http://localhost:4318/v1/traces.For OTLP over gRPC:
http://localhost:4317.
-
tls.insecure_skip_verify(boolean, optional)# Important
Using this parameter poses a security risk.
It is recommended to use it exclusively for testing and debugging purposes, but not in the production environment.
Specifies whether the verification of a server TLS certificate is disabled.
Default value:
false— the certificate is verified.
-
-
Audit Event Log Parameters #
The audit section allows configuring the audit event log parameters.
audit: enabled:true_or_falsesyslog: protocol:one_of_supported_transport_protocolsaddress:address_of_Syslog_serverport:port_of_Syslog_serverfacility:facility_of_Syslog_messagestag:tag_of_Syslog_messageslog: path:path_to_log_filemode:access_mode_for_log_file
-
enabled(boolean)# Specifies whether the audit event log is enabled.
If the log is enabled, PPEM adds the
audit_events_housekeepingsystem housekeeping rule for the repository database.By default, the auto-run schedule is not configured for this rule. Configure the schedule if necessary.
Default value:
false— the log is disabled, PPEM does not log audit events.-
syslog(object)# The parameters for sending audit event log to a syslog server.
If omitted and the
audit.enabledparameter is set totrue, audit events are logged but not sent to a syslog server.-
protocol(enum)# The transport protocol used for the delivery of syslog messages.
Possible values:
localor''(empty string): The messages are transported within the originating server and not sent over a network.tcp,tcp4, ortcp6: Use TCP as the transport.Specify
tcp4ortcp6to explicitly use TCP over IPv4 or IPv6, respectively. Specifytcpto leave the protocol selection to PPEM.udp,udp4, orudp6: Use UDP as the transport.Specify
udp4orudp6to explicitly use UDP over IPv4 or IPv6, respectively. Specifyudpto leave the protocol selection to PPEM.ip,ip4, orip6: Use IP as the transport.Specify
ip4orip6to explicitly use IPv4 or IPv6, respectively. Specifyipto leave the protocol selection to PPEM.unix,unixgram, orunixpacket: Use a UNIX domain socket as the transport.The values above are the types of UNIX domain sockets that use different semantics:
The socket of the
unixtype usesSOCK_STREAMsemantics.The socket of the
unixgramtype usesSOCK_DGRAMsemantics.The socket of the
unixpackettype usesSOCK_SEQPACKETsemantics.
-
address(string)# The network address of the syslog server, if required by the selected transport protocol.
-
port(port number)# The port of the syslog server, if required by the selected transport protocol.
-
facility(enum)# The facility of syslog messages.
Possible values:
kern: Kernel messages.user: User-level messages.mail: Mail system.daemon: System daemons.auth: Security/authorization messages.syslog: Messages generated internally by syslogd.lpr: Line printer subsystem.news: Network news subsystem.uucp: UUCP subsystem.cron: Clock daemon.authpriv: Security/authorization messages.ftp: FTP daemon.local0tolocal7: Local use 0–7.
Default value:
kern.-
tag(string)# The tag of syslog messages.
Default value:
""(empty string) — theAUDITvalue is used as the tag.
-
-
log(object)# The parameters for sending the audit event log to a plain text file.
If omitted and the
audit.enabledparameter is set totrue, audit events are logged but not sent to a plain text file.-
path(string)# The path to the plain text log file.
If the file does not exist, it is created automatically.
Example:
/tmp/auth.log.-
mode(string)# The file mode of the log file specified using the
pathparameter.The parameter format is
0xxx, the same as for thechmodcommand.Example:
0644.
-
Agent Connection Parameters #
The agents_connection section allows configuring the agent connection parameters.
agents_connection: read_timeout:timeout_for_receiving_datawrite_timeout:timeout_for_sending_datamax_connections_per_second:connection_rate_limitlog_pings:true_or_false
-
read_timeout(time string)# The timeout for receiving data from agents.
Default value:
30s.-
write_timeout(time string)# The timeout for sending data to agents.
Default value:
2s.-
max_connections_per_second(integer)# The connection rate limit.
If the number of connections to agents per second exceeds this value, then any new connections are rejected with the 429 Too Many Requests HTTP status code.
Default value:
100.-
log_pings(boolean, optional)# Specifies whether the collecting of debug logs for the manager-agent healthcheck pings is enabled.
Default value:
false— ping logging is disabled.
Automatic Discovery Parameters #
This section allows specifying the naming template for automatically discovered instances.
autodiscovery:
instance_name_template: instance_naming_template
-
instance_name_template(string, optional)# A template for naming automatically discovered instances.
The agent configuration file also supports this parameter. The value specified in the agent configuration file takes precedence over the template specified in the manager configuration file.
This parameter is used only when the agent configuration file does not provide an instance naming template.
The template must be a single line without line breaks.
The following variables are supported:
{{.Host}},{{.HostName}},{{.Port}},{{.Version}},{{.Edition}},{{.ServiceType}},{{.ClusterType}}, and{{.SystemIdentifier}}.If the resolved name matches an existing instance, a numeric suffix (
-1,-2, etc.) is added.If neither the agent nor the manager provides a template, the default naming pattern
instance-{ID}is used.Default value:
""(empty string).
Miscellaneous Time Interval and Timeout Parameters #
This section allows configuring miscellaneous time interval and timeout parameters.
collectors: agent_time_desync_allowance:maximum_allowed_time_skewreplication: worker: interval:interval_between_cluster_recalculation_cyclesoperations: watcher_timeout:operation_state_checking_timeoutnotifications: cleanup_age:retention_period_for_storing_read_notificationscommands: cleanup_age:retention_period_for_storing_completed_command_history
-
collectors.agent_time_desync_allowance(time string, optional)# The maximum allowed time skew on the manager and agents.
If this time limit is exceeded, then a corresponding warning message is written in the PPEM logs.
Default value:
1m.-
replication.worker.interval(time string, optional)# The interval between the cluster recalculation cycles.
Default value:
5s.-
operations.watcher_timeout(time string)# The operation state checking timeout.
-
notifications.cleanup_age(time string, optional)# The retention period for storing the read notifications.
After this period, the read notifications disappear from the notification area in the web application.
Default value:
168h(7 days).-
commands.cleanup_age(time string, optional)# The retention period for storing the completed command history.
After this period, the completed commands disappear from the notification area in the web application.
Default value:
720h(30 days).