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.