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.