9 Zabbix web 服务

概述

Zabbix Web 服务是一个用于与外部 Web 服务通信的进程。

本节列出了 Zabbix Web 服务配置文件 (zabbix_web_service.conf) 支持的参数。

这些参数仅列出而未附加更多信息。单击参数可查看完整详细信息。

Parameter Description
AllowedIP 以逗号分隔的 IP 地址列表,可选用 CIDR 表示法,或 Zabbix 服务器和 Zabbix proxy 的 DNS 名称。
DebugLevel 调试级别。
IgnoreURLCertErrors 指定访问前端 URL 时对 TLS 证书验证错误的处理方式。
Include 您可以在配置文件中包含单个文件或目录中的所有文件。
ListenPort 服务将在此端口上侦听来自服务器的连接。
LogFile 日志文件名称。
LogFileSize 日志文件的最大大小。
LogType 日志输出类型。
Timeout 格式化仪表板 PDF 报告 所花费的最长时间(以秒为单位)。
TLSAccept 接受哪些传入连接。
TLSCAFile 包含顶级 CA 证书的文件完整路径名,用于对等端证书验证,供 Zabbix 组件之间的加密通信使用。
TLSCertFile 包含服务证书或证书链的文件完整路径名,供 Zabbix 组件之间的加密通信使用。
TLSKeyFile 包含服务私钥的文件完整路径名,供 Zabbix 组件之间的加密通信使用。

除非明确说明某个参数是必需的,否则所有参数均为非必需。

请注意:

  • 默认值反映的是进程默认值,而不是随附配置文件中的值;
  • 参数值支持环境变量
  • Zabbix 仅支持采用 UTF-8 编码且不带 BOM 的配置文件;
  • 仅支持以 "#" 开头且位于行首的注释。

参数详情

允许的IP

一个由逗号分隔的IP地址列表,可以是CIDR表示法,或者是Zabbix servers和Zabbix proxies的DNS名称。只有来自此处列出的主机的传入连接才会被接受。
如果启用了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

必填:是

Debug级别

指定调试级别:
0 - 有关启动和停止 Zabbix 进程的基本信息
1 - 关键信息;
2 - 错误信息;
3 - 警告;
4 - 用于调试(产生大量信息);
5 - 扩展调试(产生更多信息)。

默认值:3
范围: 0-5

IgnoreURLCertErrors

指定访问前端 URL 时 TLS 证书验证错误的处理方式:
0 - 不忽略证书错误;
1 - 忽略证书错误。

默认值:0
取值范围:0-1

Include

您可以在配置文件中包含单个文件,或包含目录中的所有文件。 在安装过程中,除非在编译时进行了修改,Zabbix 将在 /usr/local/etc 中创建 include 目录。 该路径可以相对于 zabbix_web_service.conf 文件所在位置。
若只包含指定目录中的相关文件,则支持使用星号通配符进行模式匹配。
有关限制,请参见特别说明

示例:

Include=/absolute/path/to/config/files/*.conf
ListenPort

服务将在该端口上监听来自服务器的连接。

默认值:10053
范围:1024-32767

LogFile

日志文件的名称。

示例:

/tmp/zabbix_web_service.log

必填:是,如果LogType设置为文件;否则不需要。

LogFileSize

日志文件的最大大小,单位为MB。
0 - 禁用自动日志轮转。
注意:如果日志文件大小达到限制,并且由于任何原因文件轮转失败,现有的日志文件将被截断并重新开始记录。

默认值:1
范围:0-1024

LogType

日志输出的类型:
file - 将日志写入 LogFile 参数指定的文件;
system - 将日志写入 syslog;
console - 将日志写入标准输出。

默认值:file

超时

用于格式化仪表板 PDF 报告 所花费的最长时间(秒)。

默认值:10
范围:1-30

TLSAccept

接受哪些传入连接:
未加密(unencrypted) - 接受未加密的连接(默认设置)
证书(cert) - 接受使用TLS和证书的连接

默认值: 未加密

TLSCAFile

包含顶层CA(证书颁发机构)证书的文件的完整路径名,这些证书用于Zabbix组件之间的加密通信中的同级证书验证。

TLSCertFile

包含服务证书或证书链的文件的完整路径名,这些证书用于与Zabbix组件之间的加密通信。

TLSKeyFile

包含服务私钥的文件的完整路径名,这些私钥用于Zabbix组件之间的加密通信。