Параметры конфигурации: Zabbix web service
Обзор
Веб-служба 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
Include
Укажите каталог или отдельные файлы, которые нужно включить в файл конфигурации.
Во время установки Zabbix этот параметр устанавливается в /usr/local/etc, если вы не измените его на этапе компиляции.
Общие правила для параметра Include:
- Путь может быть относительным к расположению файла
zabbix_web_service.conf. - В одном файле конфигурации можно указать несколько параметров
Include. - Zabbix обрабатывает параметр
Includeсразу после его чтения, поэтому рекомендуется размещать его в конце файла конфигурации.
Правила для включаемых файлов:
- Каждый файл должен быть доступен для чтения.
- Каждый файл должен иметь корректный синтаксис. В противном случае компонент не запустится.
Правила для включения каталогов или шаблонов файлов:
- Не следует предполагать какой-либо порядок включения (например, файлы не включаются в алфавитном порядке).
- Не определяйте один и тот же параметр более чем в одном включаемом файле (например, чтобы переопределить общее значение более конкретным), так как невозможно предсказать, какое значение будет использовано.
- Обратите внимание на резервные копии, которые некоторые текстовые редакторы создают автоматически (например, при редактировании
include/my_specific.confможет быть созданinclude/my_specific.conf.BAK), поскольку будут включены оба файла.
Чтобы включить только нужные файлы из каталога, используйте подстановочный знак (*) для сопоставления шаблонов.
Пример:
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
Тайм-аут
Максимальное время (в секундах), затрачиваемое на форматирование PDF отчета панели мониторинга.
По умолчанию: 10
Диапазон: 1-30
TLSAccept
Какие входящие подключения принимать:
- unencrypted - принимать подключения без шифрования (по умолчанию);
- cert - принимать подключения с TLS и сертификатом.
По умолчанию: unencrypted
TLSCAFile
Полный путь к файлу, содержащему сертификаты корневого CA для проверки сертификата узла-пира, используемому для зашифрованного обмена данными между компонентами Zabbix.
TLSCertFile
Полный путь к файлу, содержащему сертификат службы или цепочку сертификатов, используемый для зашифрованной связи с компонентами Zabbix.
TLSKeyFile
Полный путь к файлу, содержащему закрытый ключ службы, используемый для зашифрованной связи между компонентами Zabbix.