Параметры конфигурации: Zabbix web service

Обзор

Веб-служба Zabbix — это процесс, который используется для взаимодействия с внешними веб-службами.

Параметры, поддерживаемые файлом конфигурации веб-службы Zabbix (zabbix_web_service.conf), перечислены в этом разделе.

Параметры перечислены без дополнительной информации. Щелкните параметр, чтобы увидеть полные сведения.

Parameter Description
AllowedIP Список IP-адресов, разделенных запятыми, при необходимости в нотации CIDR, или DNS-имен серверов Zabbix и прокси Zabbix.
DebugLevel Уровень отладки.
IgnoreURLCertErrors Определяет обработку ошибок проверки TLS-сертификата при обращении к URL веб-интерфейса.
Include Вы можете включать отдельные файлы или все файлы в каталоге в файл конфигурации.
ListenPort Служба будет прослушивать этот порт для подключений от сервера.
LogFile Имя файла журнала.
LogFileSize Максимальный размер файла журнала.
LogType Тип вывода журнала.
Timeout Максимальное время (в секундах), затрачиваемое на формирование PDF отчета панели мониторинга.
TLSAccept Какие входящие подключения принимать.
TLSCAFile Полный путь к файлу, содержащему сертификаты корневого CA, используемые для проверки сертификата узла связи при защищенном обмене данными между компонентами Zabbix.
TLSCertFile Полный путь к файлу, содержащему сертификат службы или цепочку сертификатов, используемые для защищенного обмена данными между компонентами Zabbix.
TLSKeyFile Полный путь к файлу, содержащему закрытый ключ службы, используемый для защищенного обмена данными между компонентами Zabbix.

Все параметры являются необязательными, если явно не указано, что параметр обязателен.

Обратите внимание:

  • Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации;
  • Значения поддерживают переменные среды;
  • Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM;
  • Комментарии, начинающиеся с #, поддерживаются только в начале строки.

Сведения о параметре

AllowedIP

Список IP-адресов, разделенных запятыми, при необходимости в нотации CIDR, или DNS-имен серверов Zabbix и прокси Zabbix. Входящие подключения будут приниматься только от узлов сети, перечисленных здесь.
Если поддержка IPv6 включена, то 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 считаются эквивалентными, а ::/0 позволит использовать любой IPv4- или IPv6-адрес. 0.0.0.0/0 можно использовать, чтобы разрешить любой IPv4-адрес.

Пример:

127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Обязательно: да

DebugLevel

Укажите уровень отладки:

  • 0 - базовая информация о запуске и остановке процессов Zabbix;
  • 1 - критическая информация;
  • 2 - информация об ошибках;
  • 3 - предупреждения;
  • 4 - для отладки (выводит много информации);
  • 5 - расширенная отладка (выводит еще больше информации).

По умолчанию: 3
Диапазон: 0-5

IgnoreURLCertErrors

Определяет обработку ошибок проверки TLS-сертификата при обращении к URL веб-интерфейса:
0 - не игнорировать ошибки сертификата;
1 - игнорировать ошибки сертификата.

По умолчанию: 0
Диапазон: 0-1

Include

Укажите каталог или отдельные файлы, которые нужно включить в файл конфигурации.
Во время установки Zabbix этот параметр устанавливается в /usr/local/etc, если вы не измените его на этапе компиляции.

Общие правила для параметра Include:

  • Путь может быть относительным к расположению файла zabbix_web_service.conf.
  • В одном файле конфигурации можно указать несколько параметров Include.
  • Zabbix обрабатывает параметр Include сразу после его чтения, поэтому рекомендуется размещать его в конце файла конфигурации.

Правила для включаемых файлов:

  • Каждый файл должен быть доступен для чтения.
  • Каждый файл должен иметь корректный синтаксис. В противном случае компонент не запустится.

Правила для включения каталогов или шаблонов файлов:

  • Не следует предполагать какой-либо порядок включения (например, файлы не включаются в алфавитном порядке).
  • Не определяйте один и тот же параметр более чем в одном включаемом файле (например, чтобы переопределить общее значение более конкретным), так как невозможно предсказать, какое значение будет использовано.
  • Обратите внимание на резервные копии, которые некоторые текстовые редакторы создают автоматически (например, при редактировании include/my_specific.conf может быть создан include/my_specific.conf.BAK), поскольку будут включены оба файла.

Чтобы включить только нужные файлы из каталога, используйте подстановочный знак (*) для сопоставления шаблонов.

Пример:

Include=/absolute/path/to/config/files/*.conf
ListenPort

Служба будет прослушивать этот порт для подключений от сервера.

По умолчанию: 10053
Диапазон: 1024-32767

LogFile

Имя файла журнала.

Пример:

/tmp/zabbix_web_service.log

Обязательно: да, если LogType установлено в file; в противном случае — нет

LogFileSize

Максимальный размер файла журнала в МБ.
0 - отключить автоматическую ротацию журнала.
Примечание: если достигается ограничение размера файла журнала и ротация файла по какой-либо причине не выполняется, существующий файл журнала усекается и создается заново.

По умолчанию: 1
Диапазон: 0-1024

LogType

Тип вывода журнала:

  • file - записывать журнал в файл, указанный параметром LogFile;
  • system - записывать журнал в syslog;
  • console - записывать журнал в стандартный вывод.

По умолчанию: file

Тайм-аут

Максимальное время (в секундах), затрачиваемое на форматирование PDF отчета панели мониторинга.

По умолчанию: 10
Диапазон: 1-30

TLSAccept

Какие входящие подключения принимать:

  • unencrypted - принимать подключения без шифрования (по умолчанию);
  • cert - принимать подключения с TLS и сертификатом.

По умолчанию: unencrypted

TLSCAFile

Полный путь к файлу, содержащему сертификаты корневого CA для проверки сертификата узла-пира, используемому для зашифрованного обмена данными между компонентами Zabbix.

TLSCertFile

Полный путь к файлу, содержащему сертификат службы или цепочку сертификатов, используемый для зашифрованной связи с компонентами Zabbix.

TLSKeyFile

Полный путь к файлу, содержащему закрытый ключ службы, используемый для зашифрованной связи между компонентами Zabbix.