On this page

设置对象

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

设置

settings 对象具有以下属性。

属性 类型 描述
default_lang string 系统默认语言。

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

默认值：system - 系统默认。

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

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

默认值：1000。
max_overview_table_size integer 仪表板中“数据概览”和“触发器概览”部件的最大列数和行数。

默认值：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 在“最新数据”、“Web”和“数据概览”仪表板部件中显示历史数据的最大时间段。
接受秒数和带后缀的时间单位。

默认值：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 “未分类”严重性的名称。

默认值：未分类。
severity_name_1 string “信息”严重性的名称。

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

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

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

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

默认值：灾难。
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 方案。

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

默认值：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。

Property behavior：
- required
socket_timeout string 网络默认超时时间。

可能的值范围：1-300s。

默认值：3s。

Property behavior：
- required
media_type_test_timeout string 媒介类型测试的网络超时时间。

可能的值范围：1-300s。

默认值：65s。

Property behavior：
- required
item_test_timeout string 监控项测试的网络超时时间。

可能的值范围：1-600s。

默认值：60s。

Property behavior：
- required
script_timeout string 脚本执行的网络超时时间。

可能的值范围：1-300s。

默认值：60s。

Property behavior：
- required
report_test_timeout string 计划报表测试的网络超时时间。

可能的值范围：1-300s。

默认值：60s。

Property behavior：
- required
auditlog_enabled integer 是否启用审计日志记录。

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

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

默认值：1m。

Property behavior：
- 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。

Property behavior：
- 当 geomaps_tile_provider 设置为空字符串时，supported
geomaps_max_zoom integer 地理地图最大缩放级别。

可能的值：0-30。

Property behavior：
- 当 geomaps_tile_provider 设置为空字符串时，supported
geomaps_attribution string 地理地图署名文本。

Property behavior：
- 当 geomaps_tile_provider 设置为空字符串时，supported
vault_provider integer Vault 提供者。

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

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

可能的值范围：1-600s。

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

Property behavior：
- 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