1 常规

概述

Administration > General 部分包含多个子部分，用于设置前端相关的默认值并自定义 Zabbix。

可用子部分列表会在 Administration 菜单部分中点击 General 后显示。 也可以通过使用左上角的标题下拉菜单在各子部分之间切换。

GUI

本节介绍若干与前端相关的默认设置自定义。

配置参数：

Parameter Description
Default language 未在个人资料中指定语言的用户和访客用户的默认语言。
更多信息，请参见安装附加前端语言。
Default time zone 未在个人资料中指定时区的用户和访客用户的默认时区。
Default theme 未在个人资料中指定主题的用户和访客用户的默认主题。
Limit for search and filter results 将在 Web 前端列表中显示的元素（行）最大数量，例如在数据采集 > 主机中。
注意：如果设置为例如“50”，则在所有受影响的前端列表中只会显示前 50 个元素。如果某个列表包含超过 50 个元素，则会在"Displaying 1 to 50 of 50+ found"中以“+”号表示。此外，如果使用过滤且匹配项仍超过 50 个，则只会显示前 50 个。
请注意，提高此参数的值可能会导致 Web 服务器端性能下降并增加内存消耗。
Max number of columns
and rows in overview tables		 在触发器概览仪表板小部件中显示的最大列数和行数。该限制同时适用于列和行。如果实际存在的行数和/或列数超过显示数量，系统将在表格底部显示警告：“未显示所有结果。请提供更具体的搜索条件。”
Max count of elements
to show inside table cell		 对于显示在单个表格单元格中的条目，这里配置的显示数量不会超过上限。
Show warning if Zabbix server is down 启用此参数后，如果无法连接到 Zabbix 服务器（可能已宕机），浏览器窗口中将显示警告消息。即使用户向下滚动页面，该消息仍会保持可见。将鼠标悬停其上时，该消息会暂时隐藏，以显示其下方内容。
Working time 此全局参数定义工作时间。在图表中，工作时间显示为白色背景，非工作时间显示为灰色。
有关时间格式的说明，请参见时间段规范页面。
支持用户宏。
Show technical errors 勾选后，所有已注册用户都可以看到技术错误（PHP/SQL）。未勾选时，这些信息仅对Zabbix 超级管理员以及所属用户组启用了调试模式的用户可见。
Max history display period 在监控 > 最新数据中显示历史数据、在监控 > 主机中显示主机web 场景信息，以及在Top items仪表板小部件中显示历史数据的最长时间范围。
允许范围：24 小时（默认）- 1 周。时间后缀，例如 1w（一周）、36h（36 小时），均受支持。
Time filter default period 图表和仪表板默认使用的时间范围。允许范围：1 分钟 - 10 年（默认：1 小时）。
支持时间后缀，例如 10m（10 分钟）、5w（5 周）。
注意：当用户在查看图表时更改时间范围后，该时间范围会作为用户偏好保存，并替换全局默认值或用户之前的选择。
Max period for time selector 图表和仪表板可用的最大时间范围。用户将无法查看更早的数据。允许范围：1 年 - 10 年（默认：2 年）。
支持时间后缀，例如 1y（1 年）、365w（365 周）。

自动注册

在本节中，您可以为主动 agent 自动注册配置加密级别。

adm\_autoreg2.png

带星号的参数为必填项。

配置参数：

Parameter Description
加密级别 选择一个或两个加密级别选项：
无加密 - 允许未加密连接
PSK - 允许使用预共享密钥的 TLS 加密连接
PSK 标识 输入预共享密钥标识字符串。
仅当将 'PSK' 选为 加密级别 时，此字段才可用。
请勿在 PSK 标识中放入敏感信息，因为它会以未加密方式在网络中传输，以告知接收方应使用哪个 PSK。
PSK 输入预共享密钥（偶数个十六进制字符）。
最大长度：如果 Zabbix 使用 GnuTLS 或 OpenSSL 库，则为 512 个十六进制数字（256 字节 PSK）；如果 Zabbix 使用 mbed TLS（PolarSSL）库，则为 64 个十六进制数字（32 字节 PSK）。
示例：1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
仅当将 'PSK' 选为 加密级别 时，此字段才可用。

另请参见：安全自动注册

超时

在本节中，可以设置全局监控项类型超时和网络超时。 此表单中的所有字段均为必填项。

参数 描述
监控项类型超时 Zabbix 在中止检查前应等待多少秒（基于其类型）。
有关更多详细信息和限制，请参见监控项超时。
允许范围：1 - 600s（默认：3s；browser 监控项的默认值：60s）。
支持时间后缀，例如 30s、1m，以及用户宏。

请注意，如果配置了 proxy 级别的超时，则会覆盖这些全局设置。此外，如果为特定监控项 配置了超时，则会同时覆盖全局和 proxy 设置。
UI 的网络超时
通信 在关闭空闲套接字之前等待多少秒（如果此前已建立到 Zabbix 服务器的连接，但前端在此时间内无法完成数据读取/发送操作，则该连接将被断开）。允许范围：1 - 300s（默认：3s）。
连接 在停止尝试连接到 Zabbix 服务器之前等待多少秒。允许范围：1 - 30s（默认：3s）。
媒介类型测试 测试媒介类型时，等待响应的秒数。允许范围：1 - 300s（默认：65s）。
脚本执行 执行脚本时，等待响应的秒数。允许范围：1 - 300s（默认：60s）。
此超时适用于整个脚本执行链，该链的长度可能各不相同。例如，如果脚本在 agent 上执行，则会经过服务器（也可能还经过 proxy）到 agent 再返回的往返过程。
对于在 agent 上执行的脚本，适用服务器 或 proxy 超时。
对于仅在主动 agent 上执行的脚本，很可能需要提高默认的服务器/proxy 超时。服务器/proxy 超时必须高于主动检查刷新频率，否则服务器/proxy 超时可能会在主动 agent 甚至尚未收到脚本之前就已超出。
另请参见：脚本超时。
监控项测试 测试监控项时，等待返回数据的秒数。允许范围：1 - 600s（默认：60s）。
计划报告测试 测试计划报告时，等待返回数据的秒数。允许范围：1 - 300s（默认：60s）。

图片

“图片”部分显示 Zabbix 中可用的所有图片。 图片存储在数据库中。

Type 下拉框允许您在图标和背景图片之间切换：

  • 图标用于显示网络地图元素。
  • 背景用于作为网络地图的背景图片。

添加图片

您可以通过点击右上角的 Create icon 或 Create background 按钮来添加自己的图片。

图片属性：

Parameter Description
Name 图片的唯一名称。
Upload 从本地系统选择要上传到 Zabbix 的文件（PNG、JPEG、GIF 或 WebP）。
Note 请注意，可能可以上传其他格式，这些格式在上传过程中会转换为 PNG。图像处理使用 GD 库，因此支持的格式取决于所使用的库版本（Zabbix 需要 2.0.28 或更高版本）。

上传文件的最大大小受 ZBX_MAX_IMAGE_SIZE 的值限制，即 1024x1024 字节或 1 MB。

如果图片大小接近 1 MB，并且 max_allowed_packet MySQL 配置参数的默认值为 1MB，则图片上传可能会失败。 在这种情况下，请增大 max_allowed_packet 参数。

图标映射

本节允许创建某些主机与某些图标之间的映射。 系统会使用主机资产清单字段信息来创建映射。

随后，这些映射可用于网络地图配置，以便自动为匹配的主机分配合适的图标。

要创建新的图标映射，请点击右上角的 Create icon map。

配置参数：

参数 说明
Name 图标映射的唯一名称。
Mappings 映射列表。映射的顺序决定其优先级。你可以通过拖放将映射在列表中上下移动。
Inventory field 用于查找匹配项的主机资产清单字段。
Expression 描述匹配条件的正则表达式。
Icon 如果找到表达式匹配项，则使用的图标。
Default 要使用的默认图标。

正则表达式

本节允许创建自定义正则表达式，这些表达式可在前端的多个位置使用。 有关详细信息，请参见 正则表达式 部分。

触发器显示选项

本节允许自定义触发器状态在前端中的显示方式，以及 触发器严重性 名称和颜色。

Parameter Description
使用自定义事件状态颜色 勾选此参数可启用已确认/未确认问题的颜色自定义。
未确认的 PROBLEM 事件,
已确认的 PROBLEM 事件,
未确认的 RESOLVED 事件,
已确认的 RESOLVED 事件		 输入新的颜色代码，或单击颜色，从提供的调色板中选择新的颜色。
如果勾选了 闪烁 复选框，触发器在状态变更后会闪烁一段时间，以便更醒目。
为以下对象显示 OK 触发器 显示 OK 触发器的时间段。允许范围：0 - 24 小时。支持 时间后缀，例如 5m、2h、1d。
状态变更时触发器闪烁时长 触发器闪烁的持续时间。允许范围：0 - 24 小时。支持 时间后缀，例如 5m、2h、1d。
未分类,
信息,
警告,
平均,
高,
灾难		 用于替代系统默认值显示的自定义严重性名称和/或颜色。
输入新的颜色代码，或单击颜色，从提供的调色板中选择新的颜色。

请注意，此处输入的自定义严重性名称将用于所有语言环境。如果需要为某些用户将其翻译为其他语言，请参见 自定义触发器严重性 页面。

地理地图

本节允许选择地理地图瓦片服务提供商，并配置 Geomap 仪表板小部件 的服务提供商设置。
为了通过地理地图提供可视化，Zabbix 使用开源的 JavaScript 交互式地图库 Leaflet。
请注意，Zabbix 无法控制第三方瓦片提供商所提供图像的质量，包括预定义的瓦片提供商。

Parameter Description
Tile provider 从可用的瓦片服务提供商中选择一个，或选择 Other 以添加其他瓦片提供商或自托管瓦片（参见 使用自定义瓦片服务提供商）。
Tile URL 用于在地理地图上加载和显示瓦片图层的 URL 模板（最多 2048 个字符）。
仅当 Tile provider 设置为 Other 时，此字段才可编辑。

支持以下占位符：
{s} 表示可用子域名之一；
{z} 表示 URL 中的缩放级别参数；
{x} 和 {y} 表示瓦片坐标；
{r} 可用于在 URL 中添加 "\@2x" 以加载 retina 瓦片。

示例：https://{s}.example.com/{z}/{x}/{y}{r}.png
Attribution text 要显示在地图上小文本框中的瓦片提供商署名文本。仅当 Tile provider 设置为 Other 时，此字段可见。
Max zoom level 地图的最大缩放级别。仅当 Tile provider 设置为 Other 时，此字段才可编辑。
使用自定义瓦片服务提供商

Geomap 小组件能够从自托管或第三方瓦片提供商服务加载栅格瓦片图像。 要使用自定义的第三方瓦片提供商服务，或自托管的瓦片文件夹或服务器，请在 Tile provider 字段中选择 Other，并在 Tile URL 字段中使用正确的占位符指定自定义 URL。

模块

本节允许管理自定义以及内置的前端模块。

点击 Scan directory 以注册/取消注册任何自定义模块。
已注册的模块将显示在列表中；未注册的模块将从列表中移除。

点击列表中的模块状态可启用/禁用模块。
您也可以通过在列表中选择模块，然后点击列表下方的 Enable/Disable 按钮，批量启用/禁用模块。

点击列表中的模块名称，可在弹出窗口中查看其详细信息。

模块状态也可以在模块详细信息弹出窗口中更新；为此，请勾选/取消勾选 Enabled 复选框，然后点击 Update。

您可以按名称或状态（已启用/已禁用）筛选模块。

连接器

本节允许通过 HTTP 配置用于 Zabbix 数据流式传输到外部系统的连接器。

点击 Create connector 以配置新的连接器。

您可以按名称或状态（启用/禁用）筛选连接器。 在列表中点击连接器状态即可启用/禁用该连接器。 您还可以在列表中选择多个连接器，然后点击列表下方的 Enable/Disable 按钮来批量启用/禁用连接器。

其他

本节允许配置其他杂项前端参数。

Parameter Description
Frontend URL Zabbix Web 界面的 URL（最长 2048 个字符）。
此参数由 Zabbix Web 服务用于与前端通信，应指定此参数以启用计划报表。
Group for discovered hosts 通过网络发现和agent 自动注册发现的主机将自动放入此处所选的主机组中。
Default host inventory mode 主机资产记录的默认模式。除非在主机发现/自动注册期间通过 Set host inventory mode 操作覆盖，否则当服务器或前端创建新的主机或主机原型时，将遵循此模式。
User group for database down message 用于发送数据库不可用告警消息的用户组。
Zabbix 服务器依赖后端数据库的可用性。没有数据库它将无法工作。如果数据库不可用，Zabbix 可以通知所选用户。通知将使用已启用的用户媒介条目发送到此处设置的用户组。通知通过以下媒介类型发送（启用时）：电子邮件；短信；自定义告警脚本。即使配置并启用了 webhook 媒介条目，也不会触发通知。
Zabbix 服务器不会停止；它会等待数据库恢复后再继续处理。
通知包含以下内容：
[MySQL|PostgreSQL] database <DB Name> [on <DB Host>:<DB Port>] is not available: <error message depending on the type of DBMS (database)>
如果 <DB Host> 定义为空值，则不会将其添加到消息中；如果 <DB Port> 为默认值（“0”），则也不会添加。告警管理器（Zabbix 服务器中的一个特殊进程）每 10 秒尝试重新建立与数据库的连接。如果数据库仍然不可用，告警管理器会重复发送告警，但频率不会高于每 15 分钟一次。
Log unmatched SNMP traps 如果未找到对应的 SNMP 接口，则记录SNMP trap。
授权
参数 说明
登录尝试次数 在登录被阻止之前，允许的不成功登录尝试次数。
登录阻止间隔 当超过 登录尝试次数 限制时，禁止登录的时间段。允许范围：30 - 3600 秒。支持时间后缀，例如 90s、5m、1h。
密钥的存储
Parameter Description
Vault provider 选择用于存储 用户宏 值的密钥管理软件 - HashiCorp Vault（默认）或 CyberArk Vault。
Resolve secret vault macros by 按以下方式解析密钥 vault 宏：
Zabbix 服务器 - 密钥由 Zabbix 服务器获取，并在需要时转发给 proxy（默认）；
Zabbix 服务器和 proxy - 密钥由 Zabbix 服务器和 proxy 共同获取，使它们能够独立解析宏。

另请参见：密钥的存储。

安全
参数 说明
验证 URI 方案 取消选中此复选框以禁用 URI 方案验证（默认启用）。
如果选中，则可以指定允许的 URI 方案的逗号分隔列表（默认值：http、https、ftp、file、mailto、tel、ssh）。适用于前端中使用 URI 的所有字段（例如，地图元素 URL）。
使用 X-Frame-Options HTTP 标头 取消选中此复选框以禁用 HTTP X-Frame-options 标头（不推荐）。
如果已标记，则可以指定 HTTP X-Frame-options 标头的值。支持的值：
SAMEORIGIN (默认) 或 'self' (必须使用单引号) - 页面只能显示在与页面本身同源(same origin)的框架中;
DENY 或 'none' (必须使用单引号) - 无论哪个网站试图这样做，页面都不能在框架中显示;
一串以空格分隔的主机名字符串; 将 'self' (必须使用单引号) 添加到列表中，可以将页面显示在与页面自身同源的框架中。
请注意，使用不带单引号的 'self' 或 'none' 将导致它们被视为主机名。
使用 iframe 沙盒 取消选中此复选框以禁止将检索到的 URL 内容放入沙盒（不推荐）。
如果已选中，则可以指定 iframe 沙盒例外;未指定的限制仍将应用。如果此字段为空，则所有沙盒属性限制均适用。
详情请参阅 sandbox 属性说明.