Перейти к основному содержимому
Версия: Пульт 2.2.0

Параметры конфигурации

Сервер Пульта​

ПараметрОписаниеЗначение по умолчанию
ZBX_ALLOWUNSUPPORTEDDBVERSIONSРазрешить серверу запускаться со старыми версиями БД, которые не входят в список официально поддерживаемых0
ZBX_DBTLSCONNECTНастройка TLS соединения для подключения к БД. Возможные значения: required (использовать TLS), verify_ca (использовать TLS и проверять сертификаты), verify_full (использовать TLS, проверять валидность сертификатов и совпадение имени БД из параметра DBName с именем в сертификате)
ZBX_DBTLSCAFILEПолный путь до CA сертификата
ZBX_DBTLSCERTFILEПолный путь к файлу, содержащему сертификат сервера pult для аутентификации в базе данных
ZBX_DBTLSKEYFILEПолный путь к файлу, содержащему закрытый ключ для аутентификации в базе данных
ZBX_DBTLSCIPHERСписок алгоритмов шифрования, которые Zabbix сервер разрешает для протоколов TLS вплоть до TLS v1.2. Поддерживается только для MySQL.
ZBX_DBTLSCIPHER13Список алгоритмов шифрования, которые Zabbix сервер разрешает для протокола TLS v1.3. Поддерживается только для MySQL, начиная с версии 8.0.16.
ZBX_VAULTDBPATH
ZBX_VAULTURLhttps://127.0.0.1:8200
VAULT_TOKEN
ZBX_LISTENIPСписок IP адресов, которые будет слушать pult сервер. Эти адреса используются для получения данных от активных агентов и трапперов. Можно указать несколько IP адресов через запятую.0.0.0.0
ZBX_LISTENPORTПорт pult сервера. Используется для получения данных от активных агентов и трапперов.10051
ZBX_LISTENBACKLOGМаксимальное количество ожидающих соединений в очереди TCP.Максимальное количество TCP соединений, настроенное в ОС
ZBX_STARTREPORTWRITERSЧисло процессов создающих дефолтные отчёты zabbix0
ZBX_WEBSERVICEURLhttp://zabbix-web-service:10053/report
ZBX_SERVICEMANAGERSYNCFREQUENCYКак часто pult сервер будет синхронизировать конфигурацию всех запущенных менеджеров сервисов. Возможные значения 1-360060
ZBX_HISTORY_ELASTIC_STORAGE_URLURL адрес ElasticSearch: http://elk:9200
ZBX_HISTORY_ELASTIC_STORAGE_TYPESСписок типов данных отправляемых в ElasticSearch. Поддерживаемые типы данных: uint,dbl,str,log,text
ZBX_HISTORYSTORAGEDATEINDEXВключение/отключение дополнительной обработки исторических значений по дате, перед записью в ElasticSearch. Возможные значения 0-10
ZBX_STARTPOLLERSКоличество запускаемых поллер (процессов сбора данных по SNMP, пассивных агентских проверок ). Возможные значения 0-10005
ZBX_IPMIPOLLERSКоличество запускаемых IPMI поллеров. Возможные значения 0-10000
ZBX_STARTCONNECTORSКолличество запускаемых процессов collecor. Процессы предназначены для передачи исторических данных и событий в удалённые системы. Возможные значения 0-10000
ZBX_STARTPREPROCESSORSКоличество запускаемых процессов препроцессинга данных. Возможные значения 1-10003
ZBX_STARTPOLLERSUNREACHABLEКоличество запускаемых процессов, отслеживающих недоступные узлы (включая java и ipmi ). Возможные значения 0-10001
ZBX_STARTTRAPPERSКоличество запускаемых процессов трапперов. Данные процессы служат для приёма данных от активных агентов, активных прокси и по протоколу zabbix sender. Возможные значения 1-10005
ZBX_STARTPINGERSКоличество запущенных процессов, проверяющих сетевую доступность узлов по ICMP протоколу. Возможные значения 0-10001
ZBX_STARTDISCOVERERSКоличество запущенных процессов автоматического обнаружения узлов по сети. Возможные значения 0-2501
ZBX_STARTHISTORYPOLLERSКоличество запущенных процессов, использующихся для обработки "вычисляемых" элементов данных. Возможные значения 0-10005
ZBX_STARTHTTPPOLLERSКоличество запущенных процессов, использующихся для выполнения HTTP проверок с pult сервера. Возможные значения 0-10001
ZBX_STARTODBCPOLLERSКоличество запущенных процессов, использующихся для подключения к СУБД с использованием ODBC интерфейса и драйверов. Возможные значения 0-10001
ZBX_STARTSNMPPOLLERSКоличество запущенных процессов, использующихся для обработки SNMP запросов с помощью ключей snmp.walk Возможные значения 0-10001
ZBX_STARTTIMERSКоличество запущенных процессов, отвечающих за обработку периодов обслуживания. Возможные значения 1-10001
ZBX_STARTESCALATORSКоличество запущенных процессов, отвечающих за обработку эскалаций ( шагов действий ). Возможные значения 1-1001
ZBX_STARTALERTERSКоличество запущенных процессов, отвечающих за отправку оповещений. Возможные значения 1-1003
ZBX_JAVAGATEWAYfqnd java гейтвея (используется для работы с JMX проверками). Можно указать IP адрес или доменное имя.zabbix-java-gateway
ZBX_JAVAGATEWAYPORTПорт Java гейтвея10052
ZBX_STARTJAVAPOLLERSКоличество процессов, обрабатывающих JMX метрики. Возможные значения 0-10005
ZBX_STARTLLDPROCESSORSКоличество процессов, обрабатывающих правила автоматического обнаружения метрик. Возможные значения 0-1002
ZBX_STATSALLOWEDIPСписок IP адресов или DNS имён внешних серверо pult/zabbix. Данный параметр указывает с каких адресов можно собирать данные о состоянии pult сервера и его процессов.
ZBX_STARTVMWARECOLLECTORSКоличество процессов, собирающих данные о работе VMWare. Возможные значения 0-2500
ZBX_VMWAREFREQUENCYЧастота опроса компонентов VMware (датацентры, гипервизоры, виртуальные машины). Значение задаётся в секундах и возможный интервал равен 10-86400 c.60
ZBX_VMWAREPERFFREQUENCYЧастота опроса счётчиков производительности VMware. Значение задаётся в секундах и возможный интервал равен 10-86400 c.60
ZBX_VMWARECACHESIZEРазмер памяти используемой для хранения данных VMWare перед записью в БД. Возможные значения 256K-2G8M
ZBX_VMWARETIMEOUTМаксимальное количество секунд, в течение которых сборщик VMware будет ожидать ответа от службы VMware (гипервизор vCenter или ESX). Возможные значения 1-300 с.10
ZBX_ENABLE_SNMP_TRAPSПараметр включает/отключает приём SNMP трапов системой. Возможные значения true/false.false
ZBX_SOURCEIPIP адрес pult сервера, с которого он будет устанавливать соединения с прокси серверами, пассивными агентами, совершать HTTP проверки и отправлять уведомления0.0.0.0
ZBX_SMSDEVICESПуть к интерфейсу модема в ОС linux. Используется для отправки СМС, через модем подключенный к физическому или виртуальному серверу, встроенными механизмами pult сервера. Пример: /dev/ttyUSB1
ZBX_HOUSEKEEPINGFREQUENCYЧастота запуска процесса удаления и ротации старых исторических данных. Возможные значения 1-24 в часах.1
ZBX_MAXHOUSEKEEPERDELETEКоличество данных, которое процесс housekeeper, может удалить за один запуск.5000
ZBX_PROBLEMHOUSEKEEPINGFREQUENCYЧастота запуска процесса очистики старых событий. Возможные значения 1-3600 с.60
ZBX_CACHESIZEРазмер конфигурационного кэша pult server. Кэш хранит информацию о всех элементах данных, триггерах, узлах, сервисах, правилах оповещених. Возможные значения 128K-64G8M
ZBX_CACHEUPDATEFREQUENCYЧастота обновления конфигурационного кэша. Возможные значения 1-3600 с.10
ZBX_STARTDBSYNCERSКоличество процессов записи данных в БД системы мониторинга. Обратите внимание, что большое число запущенных процессов, может негативно сказаться на работе системы, т.к. они будут конкурировать за доступ к кэшам и могут значительно повысить нагрузку на БД. Возможные значения 1-1004
ZBX_EXPORTFILESIZEМаксимальный размер экспортируемых из системы мониторинга данных в реальном времени (данные экспортируются в виде JSON документов). Возможные значения 1M-1G1G
ZBX_EXPORTTYPEТип данных, которые система должна экспортировать, разделённые через запятую. Возможные типы данных: history,trends,events
ZBX_AUTOHANODENAMEАвтоматическое назначение имени ноды HA кластера. Используется, если вы хотите настроить работу pult сервера в отказоустойчивом кластере. Разрешенные значения: fqdn, hostname.
ZBX_HANODENAMEПараметр позволяет в ручном режиме задать имя ноды HA кластера pult сервера.
ZBX_AUTONODEADDRESSАвтоматическое назначение IP адреса/DNS имени pult сервера, при настройке HA кластера. Возможные значения: fqdn, hostname
ZBX_NODEADDRESSPORTПорт ноды HA кластера, который используется для подключения к нему и сбора статистики. Должен быть аналогичен тому, что указан для работы pult сервера с пассивными агентами.10051
ZBX_NODEADDRESSПараметр указывающий IP адрес или fqdn текущей ноды HA кластера.localhost
ZBX_HISTORYCACHESIZEРазмер кэша, используемого для хранения исторических значений ( значения собранные системой или отправленные в неё траппером, но ещё не записанные в БД ). Возможные значения: 128K-2G16M
ZBX_HISTORYINDEXCACHESIZEРазмер кэша, используемого для индексации значений, хранимых в HISTORY кэше. На одно хранимое в history cache значпние, потребляется примерно 100 байт history index cache. Возможные значения 128K-2G4M
ZBX_TRENDCACHESIZEРазмер кэша, используемого для хранения данных трендов. Возможные значения 128K-2G4M
ZBX_TRENDFUNCTIONCACHESIZEРазмер кэша, используемого для хранения обработанных данных трендов. Эти данные могут использоваться функциями триггеров, рассчитанными на работу с трендовыми данными. Возможные значения 128K-2G4M
ZBX_VALUECACHESIZEРазмер кэша, используемого для хранения полученных исторических значений метрик. Кэш используется системой, для расчёта функций триггеров, где в логику заложено смещение по времени или задержка перед срабатыванием ( например функции min, max, avg ). Возможные значения 0,128K-64G8M
ZBX_TRAPPERTIMEOUTМаксимальное время траппер сессии, в течении которого она может принимать данные от клиента. Возможные значения 1-300.300
ZBX_UNREACHABLEPERIODПараметр определяет через сколько секунд недоступности, узел будет считать полностью недоступным. Возможные значения 1-3600 с.45
ZBX_UNREACHABLEDELAYПараметр определяет, как часто система будет проверять доступность узла, который перестал отвечать на пассивные, SNMP, JMX, JAVA проверки. Этот итервал используется, пока хост находится в режиме UNREACHABLE и не закончился период UNREACHABLEDELAY. Возможные значения 1-360015
ZBX_UNAVAILABLEDELAYПараметр определяет, как часто будет проверять узел, помеченный системой как полностью недоступный. Узел становится для системы полностью недоступным, если он ни разу не ответил на зпрос в течении UNREACHABLEPERIOD. Такие узлы опрашиваются системой всего по одной выбранной случайной метрике (включая LLD правила), с указанным в этом параметре интервалом. Обработка таких метрик происходит с помощью Unreachable poller. Возможные значения 1-360060
ZBX_LOGSLOWQUERIESЛоггировать все запросы к БД, длящиеся дольше указанного количества милисекунд. Возможные значения 0-36000003000
ZBX_STARTPROXYPOLLERSКоличество процессов, собирающих данные через пассивные прокси сервера. Возможные значения 0-2501
ZBX_PROXYCONFIGFREQUENCYЧастота обновления конфигурации прокси серверов. Возможные значения 1-604800 с. Используется только для пассивных прокси.10
ZBX_PROXYDATAFREQUENCYКак часто сервер мониторинга будет запрашивать исторические данные с прокси серверов. Используется только для пассивных прокси.1
ZBX_TLSCAFILEПолный путь к файлу, содержащему сертификаты CA верхнего уровня для проверки сертификатов одноранговых узлов сети, используемые для зашифрованной связи между компонентами pult (сервера, прокси, агенты).
ZBX_TLSCA
ZBX_TLSCRLFILEПолный путь к файлу, содержащему сертификат сервера или цепочку сертификатов, используемых для зашифрованной связи между компонентами pult (сервера, прокси, агенты).
ZBX_TLSCRL
ZBX_TLSCERTFILEПолный путь к файлу, содержащему сертификат сервера или цепочку сертификатов, используемых для зашифрованной связи между компонентами pult (сервера, прокси, агенты).
ZBX_TLSCERT
ZBX_TLSKEYFILEПолный путь к файлу, содержащему закрытый ключ, используемый для зашифрованной связи между компонентами pult (сервера, прокси, агенты).
ZBX_TLSKEY
ZBX_TLSCIPHERALLСписок алгоритмов шифрования, используемый GNUtls или OpenSSL (TLS 1.2) для шифрования соединения между компонентами pult. Пример: TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256
ZBX_TLSCIPHERALL13Список алгоритмов шифрования, используемый OpenSSL 1.1.1 (TLS 1.3) для шифрования соединения между компонентами pult. Пример: EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
ZBX_TLSCIPHERCERTПараметр указывает приоритет выбора алгоритма шифрования для GNUTls или OpenSSL (TLS 1.2), на основе данных из сертификатов. Например: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509
ZBX_TLSCIPHERCERT13Параметр указывает приоритет выбора алгоритма шифрования для OpenSSL 1.1.1 (TLS 1.3), на основе данных из сертификатов.
ZBX_TLSCIPHERPSKПараметр аналогичен ZBX_TLSCIPHERALL, но используется для PSK шифрования.
ZBX_TLSCIPHERPSK13Параметр аналогичен ZBX_TLSCIPHERCERT13, но используется для PSK шифрования.
ZBX_HISTORY_CLICKHOUSE_STORAGE_URLURL адрес HTTP интерфейса clickhouse, используется для хранения исторических данных в clickhouse. URL должен включать имя базы данны в clickhouse и данные для авторизации, если они используются. Например: http://clickhouse:8123/?database=pult&user=pult&password=pult
ZBX_HISTORY_CLICKHOUSE_STORAGE_TYPESСписок типов данных, которые будут храниться в Clickhouse. Поддерживаемые типы данных: uint,dbl,str,log,text,bin
ZBX_HISTORY_CLICKHOUSE_CHUNK_SIZEМаксимальный размер чанка данных. Система записывает данные в clickhouse чанками, для уменьшения нагрузки на БД. Размер одного чанка может составлять 1-10000000 байт10000
ZBX_HISTORY_CLICKHOUSE_FLUSH_TIMEOUTКоличество времени в секундах, в течение которых Clickhouse хранит данные в памяти перед тем как записать их на диск. Возможные значения - 1-100000с3
ZBX_HISTORY_CLICKHOUSE_NS_DISABLEОтключение записи данных о времени получения исторических значений в наносекундах. Данный параметр может быть полезен, если у вас есть метрики, которые собираются раз в секунду. Если их нет, то отключить запись этих данных в clickhouse и уменьших размер исторических таблиц. Возможные значения 0-10
ZBX_HISTORY_CLICKHOUSE_READ_TIMEOUTКоличество времени в секундах для ожидания данных от clickhouse при операциях чтения. Возможные значения - 1-100000с5
ZBX_HISTORY_CLICKHOUSE_SUPPRESS_VC_READ_TIMEOUTКоличество времени в секундах с момента старта системы, в течение которого система не обращается к clickhouse. Возможные значения - 1-100000с60

Веб-сервер Пульта​

ПараметрОписаниеЗначение по умолчанию
ZBX_SERVER_HOSTАдрес pult сервера, использующийся для проверки доступности сервера мониторинга и выполнения тестовых проверок.pult-server
BX_SERVER_PORTПорт pult сервера.10051
ZBX_SERVER_NAMEИмя инсталляции мониторинга, отображаемое в веб интерфейсе.Composed installation
ZBX_DB_ENCRYPTIONПараметр включает защищённое соединение с БД мониторинга.true
ZBX_DB_KEY_FILEРасположение закрытого ключа, используемого для установления защищённого подключения к БД мониторинга./run/secrets/client-key.pem
ZBX_DB_CERT_FILEРасположение сертификата, используемого для установления защищённого подключения к БД мониторинга./run/secrets/client-cert.pem
ZBX_DB_CA_FILEРасположение CA сертификата, используемого для проверки сертификата в процессе установления защищённого подключения к БД мониторинга./run/secrets/root-ca.pem
ZBX_DB_VERIFY_HOSTОбязательно ли проверять соответствие hostname БД на соответствие с именем, указанным в сертификате.false
ZBX_DB_CIPHER_LISTСписок алгоритмов шифрования, используемых для защищённого подключения к БД.
ZBX_VAULTПараметр указывает, используется ли VAULT для получения данных макросов.
ZBX_VAULTDBPATHПуть к хранимым секретам в vault
ZBX_VAULTURLhttps://127.0.0.1:8200
VAULT_TOKENТокен авторизации в VAULT
ZBX_VAULTCERTFILE
ZBX_VAULTKEYFILE
ZBX_VAULTCACHEИспользовать ли в WEB интерфейсе кэш, для временного хранения значений макросов, полученных из vaultfalse
ZBX_HISTORY_ELASTIC_URLАдрес ElasticSearch инстанса для получения исторических данных. Например: http://elasticsearch:9200/
ZBX_HISTORY_ELASTIC_TYPESТип данных, которые мы храним в ElasticSearch ['uint', 'dbl', 'str', 'text', 'log']
ZBX_HISTORY_CLICKHOUSE_URLАдрес Clickhouse БД для получения исторических данных. Например: http://clickhouse:8123/?database=pult&user=pult&password=pult
ZBX_HISTORY_CLICKHOUSE_TYPESТип данных, которые мы храним в Clickhouse ['uint', 'dbl', 'str', 'text', 'log', 'bin']
ZBX_SSO_SETTINGSПараметр задаёт настройки авторизации с помощью SSO. Данный параметр принимает JSON документ с типом авторизации, url sso сервиса. Например {"strict" : false, "baseurl" : "https://pult.xxxxxx.ru/", "use_proxy_headers" : true} []
ZBX_SSO_SP_KEY/usr/share/zabbix/conf/certs/sp.key
ZBX_SSO_SP_CERT/usr/share/zabbix/conf/certs/sp.crt
ZBX_SSO_IDP_CERT/usr/share/zabbix/conf/certs/idp.crt
ENABLE_WEB_ACCESS_LOGВключить логгирование запросов к WEB интерфейсуtrue
ZBX_MAXEXECUTIONTIMEМаксимальное время выполнения тестовых проверок и запросов к БД.600
ZBX_MEMORYLIMITМаксимальное кол-во памяти, выделяемое на выполнение php скриптов web интерфейса ( включая API ).128M
ZBX_POSTMAXSIZEМаксимальное кол-во данных, которые можно передать веб интерфейсу в рамках одного POST запроса. ( включая API ).16M
ZBX_UPLOADMAXFILESIZEМаксимальный размер загружаемых данных ( изображения и шаблоны мониторинга )2M
ZBX_MAXINPUTTIMEМаксимальное время ожидания передачи данных веб интерфейсу.300
ZBX_SESSION_NAMEzbx_sessionid
PHP_TZTimezone one of: http://php.net/manual/en/timezones.phpEurope/Moscow
ZBX_DENY_GUI_ACCESSЗапретить доступ к WEB интерфейсу со всех адресов, кроме тех, что перечисленны в ZBX_GUI_ACCESS_IP_RANGE.false
ZBX_GUI_ACCESS_IP_RANGEМассив, в котором перечислены IP адреса имеющие доступ к web интерфейсу pult. Используется, только если активен параметр: ZBX_DEBY_GUI_ACCESS['127.0.0.1']
ZBX_GUI_WARNING_MSGСообщение, которое будут видеть пользователи, подключаемые из запрещённых сетей.Zabbix is under maintenance.
HTTP_INDEX_FILEindex.php
EXPOSE_WEB_SERVER_INFOon
PHP_FPM_PMdynamic
PHP_FPM_PM_MAX_CHILDREN50
PHP_FPM_PM_START_SERVERS5
PHP_FPM_PM_MIN_SPARE_SERVERS5
PHP_FPM_PM_MAX_SPARE_SERVERS35
PHP_FPM_PM_MAX_REQUESTS0
ZBX_HISTORY_CLICKHOUSE_URL
ZBX_HISTORY_CLICKHOUSE_TYPES

Модуль отчетов​

Конфигурационный файл модуля пользовательских отчетов имеет следующее содержимое:

#Настройка подключения к конфигурационной БД
database:
  type: 'postgresql'
  username: 'postgres'
  password: '123456'
  port: 5432
  ip: 'postgres.local'
  name: 'pult'

#Настройка подключения к API Пульта
pult:
  username: 'admin'
  password: 'Zabbix'
  api_url: 'http://pult.local/'

#Количество потоков программы
application:
  threads_count: 10

#Настройка пути для скачивания отчетов
#Можно использовать встроенный web сервер, реализуемый сервером отчётов, либо использовать внешний веб сервер.
#Параметр report_link указывает url, который будет использоваться при сохранении информации о отчётах в СУБД pult.
#Именно этот адрес будет использоваться для загрузки отчётов, поэтому тут необходимо указывать адрес, доступный для пользователей системы.
#Например, если вы используете встроенный веб сервер, то необходимо указать внешний IP адрес или доменное имя и порт из параметра port.
#Если вы используете внешний WEB сервер, то необходимо организовать синхронизацию каталога generated_reports с ним (например с помощью общего диска или периодического запуска rsync, если системы находятся на разных серверах). И соответственно в report_link, необходимо указать адрес и порт внешнего сервера и убедиться, что при обращении к endpoint generated_reports, веб сервер предоставляет доступ к каталогу с файлами отчётов.
web_server:
  active: false
  ip: ''
  port: 8080
  report_link: 'http://pult.local/generated_reports/'

#Настройка housekeeper для сформированных отчетов (сколько времени хранятся сформированные отчеты)
housekeeper:
  active: True
  timeout: 3600
  older_report_hour: 72

Для того, чтобы данная конфигурация применилась при запуске контейнера с модулем, необходимо примонтировать ее к файлу /app/config.yaml внутри контейнера.

Модуль отчетов хранит сгенерированные отчеты в директории /app/generated_reports внутри контейнера. Если вы хотите иметь возможность получать доступ к отчётам с host машины, то необходимо "пробросить каталог" внутрь контейнера. Например:

services:
  report-server:
    restart: always
    image: registry.pult.chislitellab.ru:8123/releases/2.2.0/report-server-redos8:7.0.16
    environment:
      TZ: "Europe/Moscow"
    volumes:
      - ./reports/generated_reports:/app/generated_reports
      - ./reports/config.yaml:/app/config.yaml
    ports:
     - 8088:8080