2022 Zabbix中国峰会
2022 Zabbix中国峰会

Settings object

> 设置对象

The following objects are directly related to the settings API. 以下对象都是与settings 直接相关的API。

Settings

这是

The settings object has the following properties. 设置对象具有以下属性 |Property属性|Type类型|Description描述| |--|--|------| |default_lang|string|System language by default.默认系统语言。

Default: en_GB.默认: en_GB。| |default_timezone|string|System time zone by default.默认系统时区

Default: system - system default.默认: system - 系统默认

For the full list of supported time zones please refer to 所有支持的时区清单参考PHP documentation.| |default_theme|string|Default theme.默认主题。

Possible values:可能的值:
blue-theme - (default) Blue;(默认) 蓝色;
dark-theme - Dark;深色;
hc-light - High-contrast light;高对比亮色
hc-dark - High-contrast dark.高对比暗色| |search_limit|integer|Limit for search and filter results.搜索和过滤结果限制。

Default: 1000.默认:1000。| |max_overview_table_size|integer|Max number of columns and rows in Data overview and Trigger overview dashboard widgets.数据概览和触发器概览仪表盘组件的行和列最大值。

Default: 50.默认:50。| |max_in_table|integer|Max count of elements to show inside table cell.要在表格单元格内显示的最大元素数。

Default: 50.默认:50| |server_check_interval|integer|Show warning if Zabbix server is down.显示Zabbix server宕机的告警。

Possible values:可能的值:
0 - Do not show warning;0 - 不显示告警;
10 - (default) Show warning.- (默认) 显示告警| |work_period|string|Working time.工作时间。

Default: 1-5,09:00-18:00.默认:1-5,09:00-18:00。| |show_technical_errors|integer|Show technical errors (PHP/SQL) to non-Super admin users and to users that are not part of user groups with debug mode enabled.向非超级管理员用户和未开启调试模式群组的用户显示技术错误(PHP/SQL)。

Possible values:可能的值:
0 - (default) Do not technical errors;- (默认) 不显示技术错误;
1 - Show technical errors.显示技术错误。| |history_period|string|Max period to display history data in Latest data, Web, and Data overview dashboard widgets.
Accepts seconds and time unit with suffix.在最新数据,网页,和数据概览仪表盘组件中展示历史数据的最长时间。接受秒和带后缀的时间单位。

Default: 24h.默认:24h。| |period_default|string|Time filter default period.
Accepts seconds and time unit with suffix with month and year support (30s, 1m, 2h, 1d, 1M, 1y).时间过滤默认时长。接受秒和带后缀的时间单位,支持月和年(30s,1m,2h,1d,1M,1y)。

Default: 1h.默认:1h| |max_period|string|Max period for time filter.
Accepts seconds and time unit with suffix with month and year support (30s, 1m, 2h, 1d, 1M, 1y).时间过滤最长时间。接受秒和带后缀的时间单位,支持月和年(30s,1m,2h,1d,1M,1y)。

Default: 2y.默认:2年。| |severity_color_0|string|Color for "Not classified" severity as a hexadecimal color code.十六进制颜色码表示的“未分类”严重性颜色。

Default: 97AAB3.默认:97AAB3。| |severity_color_1|string|Color for "Information" severity as a hexadecimal color code.十六进制颜色码表示的“信息”严重性颜色。

Default: 7499FF.默认:7499FF。| |severity_color_2|string|Color for "Warning" severity as a hexadecimal color code.十六进制颜色码表示的“警告”严重性颜色。

Default: FFC859.默认:FFC859。| |severity_color_3|string|Color for "Average" severity as a hexadecimal color code.十六进制颜色码表示的“一般”严重性颜色。

Default: FFA059.默认:FFA059。| |severity_color_4|string|Color for "High" severity as a hexadecimal color code.十六进制颜色码表示的“严重”严重性颜色。

Default: E97659.默认:E97659。| |severity_color_5|string|Color for "Disaster" severity as a hexadecimal color code.十六进制颜色码表示的“灾难”严重性颜色。

Default: E45959.默认:E45959;| |severity_name_0|string|Name for "Not classified" severity.“未分类”严重性名称。

Default: Not classified.默认:Not classified| |severity_name_1|string|Name for "Information" severity.“信息”严重性名称。

Default: Information.默认: Information。| |severity_name_2|string|Name for "Warning" severity.“警告”严重性名称。

Default: Warning.默认:Warning。| |severity_name_3|string|Name for "Average" severity.
“一般”严重性名称。

Default: Average.默认:Average。| |severity_name_4|string|Name for "High" severity.“严重”严重性名称。

Default: High.默认:High。| |severity_name_5|string|Name for "Disaster" severity.“灾难”严重性名称。

Default: Disaster.默认:Disaster。| |custom_color|integer|Use custom event status colors.使用自定义事件状态颜色。

Possible values:可能的值:
0 - (default) Do not use custom event status colors;(默认) 不使用自定义事件状态颜色;
1 - Use custom event status colors. 使用自定义事件状态颜色。| |ok_period|string|Display OK triggers period.显示触发器恢复时间。
Accepts seconds and time unit with suffix.接受秒和带后缀的时间单位。

Default: 5m.默认:5m。| |blink_period|string|On status change triggers blink period.
Accepts seconds and time unit with suffix.状态变化时触发器闪烁时间。接受秒和带后缀的时间单位。

Default: 2m.默认:2m。| |problem_unack_color|string|Color for unacknowledged PROBLEM events as a hexadecimal color code.十六进制颜色码表示的已取消确认故障事件颜色。

Default: CC0000.默认:CC0000。| |problem_ack_color|string|Color for acknowledged PROBLEM events as a hexadecimal color code.十六进制颜色码表示的已确认故障事件颜色。

Default: CC0000.默认:CC0000。| |ok_unack_color|string|Color for unacknowledged RESOLVED events as a hexadecimal color code.十六进制颜色码表示的已取消确认的未解决故障事件颜色。

Default: 009900.默认:009900。| |ok_ack_color|string|Color for acknowledged RESOLVED events as a hexadecimal color code.十六进制颜色码表示的已确认的解决故障事件颜色。

Default: 009900.默认:009900。| |problem_unack_style|integer|Blinking for unacknowledged PROBLEM events已取消确认的故障事件闪烁。.

Possible values:可能的值:
0 - Do not show blinking;不闪烁;
1 - (default) Show blinking._(默认)_ 闪烁。| |problem_ack_style|integer|Blinking for acknowledged PROBLEM events.已确认的故障事件闪烁。

Possible values:可能的值:
0 - Do not show blinking;不闪烁
1 - (default) Show blinking._(默认)_ 闪烁| |ok_unack_style|integer|Blinking for unacknowledged RESOLVED events.已取消确认的已解决事件闪烁。

Possible values:可能的值:
0 - Do not show blinking;不闪烁
1 - (default) Show blinking._(默认)_ 闪烁| |ok_ack_style|integer|Blinking for acknowledged RESOLVED events.已确认的已解决事件闪烁。

Possible values:可能的值
0 - Do not show blinking不闪烁;
1 - (default) Show blinking._(默认)_ 闪烁| |url|string|Frontend URL.前端URL。| |discovery_groupid|ID|ID of the host group to which will be automatically placed discovered hosts.自动放置发现主机的主机组ID。| |default_inventory_mode|integer|Default host inventory mode.默认主机资产清单模式。

Possible values:可能的值:
-1 - (default) Disabled;(默认) 禁用;
0 - Manual;手动
1 - Automatic.自动| |alert_usrgrpid|ID|ID of the user group to which will be sending database down alarm message.

If set to "0", the alarm message will not be sent.接收数据库宕机告警信息的用户组ID。如果设置为空,告警信息不会发送。| |snmptrap_logging|integer|Log unmatched SNMP traps.未匹配的SNMP traps记录。

Possible values:可能的值:
0 - Do not log unmatched SNMP traps;不记录未匹配的SNMP traps
1 - (default) Log unmatched SNMP traps._(默认)_ 记录 未匹配的SNMP traps| |login_attempts|integer|Number of failed login attempts after which login form will be blocked.失败登录尝试次数,超过后登录会被禁止。

Default: 5.默认:5。| |login_block|string|Time interval during which login form will be blocked if number of failed login attempts exceeds defined in login_attempts field.
Accepts seconds and time unit with suffix.如果登录失败次数超过了login_attempts字段定义的值,登录表格将会被锁住的时间。接受秒和带后缀的时间单位。

Default: 30s.30s。| |validate_uri_schemes|integer|Validate URI schemes.验证URI方案。

Possible values:可能的值:
0 - Do not validate;不验证;
1 - (default) Validate._(默认)_ 验证。| |uri_valid_schemes|string|Valid URI schemes.有效的URI方案。

Default: http,https,ftp,file,mailto,tel,ssh.默认:http,https,ftp,file,mailto,tel,ssh。| |x_frame_options|string|X-Frame-Options HTTP header.X-Frame-Options HTTP头;

Default: SAMEORIGIN.默认值:SAMEORIGIN| |iframe_sandboxing_enabled|integer|Use iframe sandboxing.使用iframe沙盒。

Possible values:可能的值
0 - Do not use;不使用
1 - (default) Use._(默认)_ 使用| |iframe_sandboxing_exceptions|string|Iframe sandboxing exceptions.Iframe沙盒异常。| |connect_timeout|string|Connection timeout with Zabbix server.Zabbix server连接超时。

Possible values range: 1-30s.值范围1-30s

Default: 3s.默认:3s。

Property behavior:
- required| |socket_timeout|string|Network default timeout.网络默认超时。

Possible values range: 1-300s.值范围:1-300s

Default: 3s.默认:3s。

Property behavior:
- required| |media_type_test_timeout|string|Network timeout for media type test.媒介类型测试网络超时。

Possible values range: 1-300s.值范围:1-300s

Default: 65s.默认65s

Property behavior:
- required| |item_test_timeout|string|Network timeout for item tests.监控项测试网络超时。

Possible value range: 1-600s.值范围:1-600s

Default: 60s.默认60s

Property behavior:
- required| |script_timeout|string|Network timeout for script execution.脚本运行网络超时。

Possible values range: 1-300s.值范围:1-300s

Default: 60s.默认:60s。

Property behavior:
- required| |report_test_timeout|string|Network timeout for scheduled report test.定时报表测试网络超时。

Possible values range: 1-300s.值范围:1-300s

Default: 60s.默认:60s。

Property behavior:
- required| |auditlog_enabled|integer|Whether to enable audit logging.启用审计日志。

Possible values:可能的值:
0 - Disable禁用;
1 - (default) Enable._(默认)_ 启用| |auditlog_mode|integer|Whether to enable audit logging of low-level discovery, network discovery and autoregistration activities performed by the server (System user).是否启用服务器(系统用户)执行的低级别发现、网络发现和自动注册活动的审核日志记录

Possible values::可能的值
0 - Disable;禁用
1 - (default) Enable._(默认)_ 启用| |ha_failover_delay|string|Failover delay in seconds.故障延迟(秒)。

Default: 1m.默认:1分钟

Property behavior:
- read-only| |geomaps_tile_provider|string|Geomap tile provider.地理地图tile供应商。

Possible values:地理地图tile供应商。
OpenStreetMap.Mapnik - (default) OpenStreetMap Mapnik;(默认) OpenStreetMap
OpenTopoMap - OpenTopoMap;
Stamen.TonerLite - Stamen Toner Lite;
Stamen.Terrain - Stamen Terrain;
USGS.USTopo - USGS US Topo;
USGS.USImagery - USGS US Imagery.

Supports empty string to specify custom values of geomaps_tile_url, geomaps_max_zoom and geomaps_attribution.支持空字符串指定geomas_tile_url、geomas_max_zoom和geomas_attribution的自定义值| |geomaps_tile_url|string|Geomap tile URL.

Property behavior:
- supported if geomaps_tile_provider is set to empty string当geomaps_tile_provider设置为空字符串时地理地图磁贴的URL。| |geomaps_max_zoom|integer|Geomap max zoom level.

Possible values: 0-30.当geomaps_tile_provider设置为空字符串时地理地图的最大缩放级别。最大缩放必须在0到30之间。

Property behavior:
- supported if geomaps_tile_provider is set to empty string| |geomaps_attribution|string|Geomap attribution text.当geomaps_tile_provider设置为空字符串时的地理地图属性文本。

Property behavior:
- supported if geomaps_tile_provider is set to empty string| |vault_provider|integer|Vault provider.Vault提供商。

Possible values:
0 - (default) HashiCorp Vault;
1 - CyberArk Vault.| |timeout_zabbix_agent|string|Spend no more than timeout_* seconds on processing.
Accepts seconds or time unit with suffix (e.g., 30s, 1m). Also accepts user macros.处理时间不超过timeout_秒。接受带后缀的秒或时间单位(例如30s、1m)。也接受用户宏

Possible values range: 1-600s.值范围:1-600s

Default: 3s.默认3s
Default for timeout_browser: 60s.浏览器默认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|||