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

Тип журнала

Тип вывода журнала:
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.