9. Zabbix веб-сервис

Обзор

Веб-сервис 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

Включение

Вы можете включать отдельные файлы или все файлы в каталоге в файл конфигурации. Во время установки Zabbix создаст каталог include в /usr/local/etc, если он не был изменен во время компиляции. Путь может быть относительным к расположению файла zabbix_web_service.conf.
Чтобы включать только соответствующие файлы в указанном каталоге, для сопоставления шаблонов поддерживается символ подстановки звездочка.
См. special notes о ограничениях.

Пример:

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

Timeout

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

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

TLSAccept

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

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

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

TLSCAFile

Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла, используется для зашифрованных соединений между компонентами Zabbix.

TLSCertFile

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

TLSKeyFile

Абсолютный путь к файлу, содержащему закрытый ключ сервиса (private key), используется для зашифрованных коммуникаций между компонентами Zabbix.