9 Zabbix Web 服务
概述
Zabbix web service 是一个用于与外部 web 服务通信的进程。
本节列出了 Zabbix web service 配置文件 (zabbix_web_service.conf) 支持的参数。
这些参数仅列出名称,不包含额外信息。点击参数可查看完整详情。
| Parameter | Description |
|---|---|
| AllowedIP | 以逗号分隔的 IP 地址列表,可选使用 CIDR 表示法,或 Zabbix 服务器和 Zabbix proxy 的 DNS 名称。 |
| DebugLevel | 调试级别。 |
| IgnoreURLCertErrors | 在访问前端 URL 时,指定 TLS 证书验证错误的处理方式。 |
| Include | 您可以在配置文件中包含单个文件或目录中的所有文件。 |
| ListenPort | 该服务将监听此端口,接收来自服务器的连接。 |
| LogFile | 日志文件名。 |
| LogFileSize | 日志文件的最大大小。 |
| LogType | 日志输出类型。 |
| Timeout | 格式化仪表板的 PDF report 所允许的最长时间(秒)。 |
| TLSAccept | 接受哪些传入连接。 |
| TLSCAFile | 包含用于对等证书验证的顶级 CA 证书的文件完整路径名,用于 Zabbix 组件之间的加密通信。 |
| TLSCertFile | 包含服务证书或证书链的文件完整路径名,用于 Zabbix 组件之间的加密通信。 |
| TLSKeyFile | 包含服务私钥的文件完整路径名,用于 Zabbix 组件之间的加密通信。 |
除非明确说明某个参数为必需,否则所有参数均为非必需。
请注意:
- 默认值反映的是进程默认值,而不是随软件包提供的配置文件中的值;
- Zabbix 仅支持 UTF-8 编码且不带 BOM 的配置文件;
- 以
#开头的注释仅支持位于行首。
参数详情
AllowedIP
以逗号分隔的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
必填项:是
DebugLevel
指定调试级别:
- 0 - 关于 Zabbix 进程启动和停止的基本信息;
- 1 - 关键信息;
- 2 - 错误信息;
- 3 - 警告;
- 4 - 用于调试(会产生大量信息);
- 5 - 扩展调试(会产生更多信息)。
默认值:3
范围:0-5
IgnoreURLCertErrors
指定访问前端URL时的TLS证书验证错误处理方式:
0 - 不忽略证书错误;
1 - 忽略证书错误。
默认值:0
范围:0-1
包含
您可以在配置文件中包含单个文件或目录中的所有文件。
在安装过程中,Zabbix 会在 /usr/local/etc 中创建 include 目录,除非在编译时进行了修改。
该路径可以相对于 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
日志file的最大大小(以MB为单位)。
0 - 禁用自动日志轮转。
注意:如果日志file大小达到限制且file轮转失败(无论何种原因),现有日志file将被截断并重新开始记录。
默认值:1
范围:0-1024
LogType
日志输出类型:
- file - 将日志写入
LogFile参数指定的文件; - system - 将日志写入 syslog;
- console - 将日志写入标准输出。
默认值:file
Timeout
仪表板PDF report 格式化的最大时间(以秒为单位)。
默认值:10
范围:1-30
TLSAccept
接受哪些传入连接:
- unencrypted - 接受未加密连接(默认);
- cert - 接受使用 TLS 和证书的连接。
默认值:unencrypted
TLSCAFile
包含用于对等证书验证的Top级CA证书的file完整路径名,用于Zabbix组件之间的加密通信。
TLSCertFile
包含服务证书或证书链的file完整路径名,用于与Zabbix组件进行加密通信。
TLSKeyFile
包含服务私钥的file的完整路径名,用于Zabbix组件之间的加密通信。