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

Обзор

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

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

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

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

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

• Значения по умолчанию отражают значения по умолчанию для процесса, а не значения в поставляемых файлах конфигурации;
• 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_web_service.conf.
Во время установки Zabbix создаст каталог include в /usr/local, если он не был изменен во время компиляции.

Директива Include обрабатывается немедленно после обнаружения. Для предсказуемого поведения рекомендуется размещать параметр Include в конце файла конфигурации.

В файле конфигурации можно указать несколько директив Include.

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

Если включается каталог или файлы, соответствующие шаблону, не следует предполагать какой-либо определенный порядок включения (например, файлы не включаются в алфавитном порядке). Поэтому не определяйте один и тот же параметр в нескольких включаемых файлах (например, чтобы переопределить общее значение более конкретным).

Если включается каталог, учитывайте, что некоторые текстовые редакторы автоматически создают резервные копии файлов. Например, при редактировании файла include/my_specific.conf может быть создана резервная копия include/my_specific_conf.BAK; в этом случае будут включены оба файла. В Linux используйте команду ls -al, чтобы проверить содержимое каталога include на наличие ненужных файлов.

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

Пример:

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.