On this page

设置对象

以下对象都是与settings 直接相关的API。

设置

settings 对象具有以下属性。

Property Type Description
default_lang string 系统默认语言。

默认值：en_US。
default_timezone string 系统默认时区。

默认值：system - 系统默认值。

有关支持的完整时区列表，请参阅 PHP 文档。
default_theme string 默认主题。

可选值：
blue-theme - (默认) 蓝色；
dark-theme - 深色；
hc-light - 高对比度浅色；
hc-dark - 高对比度深色。
search_limit integer 搜索和筛选结果的限制。

默认值：1000。
max_overview_table_size integer Data overview 和 Trigger overview 仪表板小部件中的最大列数和行数。

默认值：50。
max_in_table integer 表格单元格内显示的最大元素数量。

默认值：50。
server_check_interval integer 如果 Zabbix 服务器宕机则显示警告。

可选值：
0 - 不显示警告；
10 - (默认) 显示警告。
work_period string 工作时间。

默认值：1-5,09:00-18:00。
show_technical_errors integer 向非超级管理员用户以及未加入启用调试模式的用户组的用户显示技术错误（PHP/SQL）。

可选值：
0 - (默认) 不显示技术错误；
1 - 显示技术错误。
history_period string 在 Latest data、Web 和 Data overview 仪表板小部件中显示历史数据的最大时间范围。
接受带后缀的秒数和时间单位。

默认值：24h。
period_default string 时间筛选器的默认时间范围。
接受带后缀的秒数和时间单位，并支持月和年（30s、1m、2h、1d、1M、1y）。

默认值：1h。
max_period string 时间筛选器的最大时间范围。
接受带后缀的秒数和时间单位，并支持月和年（30s、1m、2h、1d、1M、1y）。

默认值：2y。
severity_color_0 string “未分类”严重性的颜色，使用十六进制颜色代码。

默认值：97AAB3。
severity_color_1 string “信息”严重性的颜色，使用十六进制颜色代码。

默认值：7499FF。
severity_color_2 string “警告”严重性的颜色，使用十六进制颜色代码。

默认值：FFC859。
severity_color_3 string “一般”严重性的颜色，使用十六进制颜色代码。

默认值：FFA059。
severity_color_4 string “严重”严重性的颜色，使用十六进制颜色代码。

默认值：E97659。
severity_color_5 string “灾难”严重性的颜色，使用十六进制颜色代码。

默认值：E45959。
severity_name_0 string “未分类”严重性的名称。

默认值：Not classified。
severity_name_1 string “信息”严重性的名称。

默认值：Information。
severity_name_2 string “警告”严重性的名称。

默认值：Warning。
severity_name_3 string “一般”严重性的名称。

默认值：Average。
severity_name_4 string “严重”严重性的名称。

默认值：High。
severity_name_5 string “灾难”严重性的名称。

默认值：Disaster。
custom_color integer 使用自定义事件状态颜色。

可选值：
0 - (默认) 不使用自定义事件状态颜色；
1 - 使用自定义事件状态颜色。
ok_period string 显示 OK 触发器的时间范围。
接受带后缀的秒数和时间单位。

默认值：5m。
blink_period string 状态变更时触发器闪烁的时间范围。
接受带后缀的秒数和时间单位。

默认值：2m。
problem_unack_color string 未确认 PROBLEM 事件的颜色，使用十六进制颜色代码。

默认值：CC0000。
problem_ack_color string 已确认 PROBLEM 事件的颜色，使用十六进制颜色代码。

默认值：CC0000。
ok_unack_color string 未确认 RESOLVED 事件的颜色，使用十六进制颜色代码。

默认值：009900。
ok_ack_color string 已确认 RESOLVED 事件的颜色，使用十六进制颜色代码。

默认值：009900。
problem_unack_style integer 未确认 PROBLEM 事件的闪烁效果。

可选值：
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
problem_ack_style integer 已确认 PROBLEM 事件的闪烁效果。

可选值：
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
ok_unack_style integer 未确认 RESOLVED 事件的闪烁效果。

可选值：
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
ok_ack_style integer 已确认 RESOLVED 事件的闪烁效果。

可选值：
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
url string 前端 URL。
discovery_groupid ID 自动放置发现的主机的主机组 ID。
default_inventory_mode integer 默认主机资产模式。

可选值：
-1 - (默认) 禁用；
0 - 手动；
1 - 自动。
alert_usrgrpid ID 将发送数据库宕机告警消息的用户组 ID。

如果设置为 "0"，则不会发送告警消息。
snmptrap_logging integer 记录未匹配的 SNMP trap。

可选值：
0 - 不记录未匹配的 SNMP trap；
1 - (默认) 记录未匹配的 SNMP trap。
login_attempts integer 登录失败次数达到该值后，登录表单将被阻止。

默认值：5。
login_block string 如果登录失败次数超过 login_attempts 字段中定义的值，登录表单将被阻止的时间间隔。
接受带后缀的秒数和时间单位。

默认值：30s。
validate_uri_schemes integer 验证 URI scheme。

可选值：
0 - 不验证；
1 - (默认) 验证。
uri_valid_schemes string 有效的 URI scheme。

默认值：http,https,ftp,file,mailto,tel,ssh。
x_frame_options string X-Frame-Options HTTP 头。

默认值：SAMEORIGIN。
iframe_sandboxing_enabled integer 使用 iframe 沙箱。

可选值：
0 - 不使用；
1 - (默认) 使用。
iframe_sandboxing_exceptions string iframe 沙箱例外。
connect_timeout string 与 Zabbix 服务器的连接超时。

可选值范围：1-30s。

默认值：3s。

属性行为：
- required
socket_timeout string 网络默认超时。

可选值范围：1-300s。

默认值：3s。

属性行为：
- required
media_type_test_timeout string 媒体类型测试的网络超时。

可选值范围：1-300s。

默认值：65s。

属性行为：
- required
item_test_timeout string 监控项测试的网络超时。

可选值范围：1-600s。

默认值：60s。

属性行为：
- required
script_timeout string 脚本执行的网络超时。

可选值范围：1-300s。

默认值：60s。

属性行为：
- required
report_test_timeout string 计划报告测试的网络超时。

可选值范围：1-300s。

默认值：60s。

属性行为：
- required
auditlog_enabled integer 是否启用审计日志。

可选值：
0 - 禁用；
1 - (默认) 启用。
auditlog_mode integer 是否启用由服务器（System user）执行的低级别发现、网络发现和自动注册活动的审计日志记录。

可选值：
0 - 禁用；
1 - (默认) 启用。
ha_failover_delay string 故障切换延迟（秒）。

默认值：1m。

属性行为：
- read-only
geomaps_tile_provider string 地理地图瓦片提供商。

可选值：
OpenStreetMap.Mapnik - (默认) OpenStreetMap Mapnik；
OpenTopoMap - OpenTopoMap；
Stamen.TonerLite - Stamen Toner Lite；
Stamen.Terrain - Stamen Terrain；
USGS.USTopo - USGS US Topo；
USGS.USImagery - USGS US Imagery。

支持空字符串，以指定 geomaps_tile_url、geomaps_max_zoom 和 geomaps_attribution 的自定义值。
geomaps_tile_url string 地理地图瓦片 URL。

属性行为：
- 如果 geomaps_tile_provider 设置为空字符串，则 supported
geomaps_max_zoom integer 地理地图最大缩放级别。

可选值：0-30。

属性行为：
- 如果 geomaps_tile_provider 设置为空字符串，则 supported
geomaps_attribution string 地理地图署名文本。

属性行为：
- 如果 geomaps_tile_provider 设置为空字符串，则 supported
vault_provider integer Vault 提供商。

可选值：
0 - (默认) HashiCorp Vault；
1 - CyberArk Vault。
proxy_secrets_provider integer 通过以下方式解析 secret 宏值：

可选值：
0 - (默认) 仅服务器；
1 - 服务器和 proxy 独立解析。
timeout_zabbix_agent string 处理 timeout_* 时长不超过指定秒数。
接受带后缀的秒数或时间单位（例如 30s、1m）。也接受用户宏。

可选值范围：1-600s。

默认值：3s。
timeout_browser 的默认值：60s。

属性行为：
- required
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser