Documentation
1 概述
概述
管理 → 常规 界面包含多个子部分，用于设置前端相关的默认值并自定义 Zabbix。
按下 管理 菜单部分中的 常规 后，将显示可用子部分的列表。也可以通过使用 Top 左上角的标题下拉菜单在各个子部分之间切换。
GUI
本节提供若干与前端相关的默认设置的自定义。
配置参数：
| 参数 | 描述 |
|---|---|
| Default language | 对于未在个人资料中指定语言的用户和访客用户的默认语言。 有关更多信息，请参见 Installation of additional frontend languages。 |
| Default time zone | 对于未在个人资料中指定时区的用户和访客用户的默认 概述。 |
| Default theme | 对于未在个人资料中指定主题的用户和访客用户的默认主题。 |
| Limit for search and filter results | 在Web界面列表中显示的最大元素（行）数，例如在 数据采集 > 主机 中。 注意：如果设置为例如 '50'，则所有受影响的前端列表中仅显示前 50 个元素。如果某个列表包含超过五十个元素，则会以 "显示 1 到 50，共 50+ 项" 中的 "+" 符号表示。此外，如果使用了过滤器，但匹配项仍超过 50 个，则仅显示前 50 个。 请注意，增加此参数的值可能导致Web服务器端性能下降和 memory 消耗增加。 |
| 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 server 无法访问（可能已关闭）。即使用户向下滚动页面，该消息仍然可见。当鼠标悬停其上时，消息会暂时隐藏以显示其下方的内容。 |
| Working time | 此全局参数定义了工作时间。在图表中，工作时间显示为白色背景，非工作时间显示为灰色背景。 有关时间格式的描述，请参见 Time period specification 页面。 支持 User macros。 |
| Show technical errors | 如果选中，所有注册用户都将能够看到技术错误（PHP/SQL）。如果未选中，该信息仅对 Zabbix Super Admins 和启用了 debug mode 的用户组中的用户可见。 |
| Max history display period | 显示历史数据的最大时间周期，用于 监控 > 最新数据、主机 web scenario 信息在 监控 > 主机 中，以及 数据概览 仪表板小部件中。 允许范围：24 小时（默认） - 1 周。支持 Time suffixes，例如 1w（一周），36h（36 小时）。 |
| Time filter default period | 图表和仪表板中默认使用的时间周期。允许范围：1 分钟 - 10 年（默认：1 小时）。 支持 Time suffixes，例如 10m（十分钟），5w（五周）。 注意：当用户在查看图表时更改时间周期，该时间周期将作为用户偏好存储，替换全局默认值或之前的用户选择。 |
| Max period for time selector | 图表和仪表板中可用的最大时间周期。用户将无法可视化更旧的数据。允许范围：1 年 - 10 年（默认：2 年）。 支持 Time suffixes，例如 1y（一年），365w（365周）。 |
自动注册
在此部分中，您可以配置主动 agent 自注册的加密级别。
带星号的参数是必填项。
配置参数：
| 参数 | 描述 |
|---|---|
| Encryption level | 选择一个或两个加密级别选项： 无加密 - 允许未加密的连接 PSK - 允许使用预共享密钥的 TLS 加密连接 |
| PSK identity | 输入预共享密钥的身份标识 string。 仅当 加密级别 选择为“PSK”时，此字段才可用。 请勿在 PSK 身份标识中放置敏感信息，它会以未加密的形式通过网络传输，用于告知接收方使用哪个 PSK。 |
| PSK | 输入预共享密钥（必须为偶数个十六进制字符）。 最大长度：如果 Zabbix 使用 GnuTLS 或 OpenSSL 库，则为 512 个十六进制数字（256 字节 PSK）；如果使用 mbed TLS（PolarSSL）库，则为 64 个十六进制数字（32 字节 PSK）。 示例：1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 此字段仅在 加密级别 选择为“PSK”时可用。 |
另请参阅：安全自动注册
超时
在本节中，可以设置全局监控项类型超时和网络超时。 此表单中的所有字段均为必填项。
| 参数 | 描述 | |
|---|---|---|
| Timeouts for item types | 等待受监控监控项响应的时间（基于其类型）。 允许范围：1 - 600秒（默认：3秒；Browser类型监控项默认值：60秒）。 支持Time suffixes格式，例如30s、1m以及user macros。 支持的监控项类型： - Zabbix agent（包括被动和主动检查） - Simple check（除 icmpping*、vmware.* 监控项外）- SNMP agent（仅限SNMP walk[OID]和get[OID] 监控项）- External check - Database monitor - HTTP agent - SSH agent - TELNET agent - Script - Browser 注意：如果使用了proxy且设置了超时添加-proxies，则proxy的超时设置将覆盖全局设置。若为特定配置设置了超时，它们将覆盖proxy和全局设置。 |
|
| Network timeouts for UI | ||
| 通信 | 关闭空闲套接字前的等待时间（如果已建立与Zabbix server的连接，但前端在此时间内无法完成数据读取/发送操作，则连接将被丢弃）。允许范围：1 - 300秒（默认：3秒）。 | |
| 连接 | 停止尝试连接Zabbix server前的等待时间。允许范围：1 - 30秒（默认：3秒）。 | |
| 媒介类型测试 | 测试媒介类型时等待响应的最长时间。允许范围：1 - 300秒（默认：65秒）。 | |
| 脚本执行 | 执行脚本时等待响应的最长时间。允许范围：1 - 300秒（默认：60秒）。 | |
| 监控项测试 | 测试监控项时等待返回数据的超时时间。允许范围：1 - 600秒（默认：60秒）。 | |
| 计划报告测试 | 测试计划报告时等待返回数据的超时时间。允许范围：1 - 300秒（默认：60秒）。 | |
图像
图像部分显示了Zabbix中所有可用的图像。图像存储在数据库中。
类型下拉菜单允许你在图标和背景图像之间切换：
- 图标用于显示network map元素
- 背景用于作为网络拓扑图的背景图像
添加图像
您可以通过点击Top右上角的创建图标或创建背景按钮来添加自己的图像。
图像属性：
| 参数 | 描述 |
|---|---|
| Name | 图像的唯一名称。 |
| Upload | 从本地系统中选择要上传到Zabbix的file（PNG、JPEG、GIF）格式。 注意，可能还可以上传其他格式的图像，这些图像在上传时将被转换为PNG格式。图像处理使用GD库，因此支持的格式取决于所使用的库version版本（Zabbix要求使用2.0.28或更高版本）。 |
上传的file最大尺寸受ZBX_MAX_IMAGE_SIZE值的限制，即1024x1024字节或1 MB。
如果图像大小接近1 MB，且MySQL配置参数max_allowed_packet处于默认的1MB值，上传图像可能会失败。在这种情况下，请增加max_allowed_packet参数的值。
图标映射
本节允许将特定的 主机 与特定图标进行映射。使用 主机 资产字段信息来进行映射的create。
映射关系可以在 network map configuration 中使用，以便自动为匹配的 主机 分配相应的图标。
要create新的图标映射，请点击 Top 右上角的 创建图标映射。
配置参数：
| 参数 | 描述 |
|---|---|
| Name | 图标映射的唯一名称。 |
| Mappings | 映射列表。映射的顺序决定了优先级。您可以使用拖放功能在列表中上下移动映射。 |
| Inventory field | 将要查找以进行匹配的 主机 资产字段。 |
| Expression | 描述匹配的正则表达式。 |
| Icon | 如果找到匹配表达式，则使用的图标。 |
| Default | 默认使用的图标。 |
正则表达式
本节允许创建可在前端多个位置使用的自定义正则表达式。详细信息请参见Regular expressions章节。
触发器显示选项
本节允许自定义触发器状态在前端的显示方式以及trigger severity名称和颜色。
| 参数 | 描述 |
|---|---|
| Use custom event status colors | 勾选此参数将启用已确认/未确认问题的颜色自定义功能。 |
| Unacknowledged PROBLEM events, Acknowledged PROBLEM events, Unacknowledged RESOLVED events, Acknowledged RESOLVED events |
输入新的颜色代码或点击颜色从提供的调色板中选择新颜色。 如果勾选了闪烁复选框，则触发器状态发生变化时将在一段时间内闪烁，以提高可见性。 |
| Display OK triggers for | 显示正常触发器的时间段。允许范围：0 - 24 小时。支持Time suffixes格式，例如 5m、2h、1d。 |
| On status change triggers blink for | 触发器闪烁的持续时间。允许范围：0 - 24 小时。支持Time suffixes格式，例如 5m、2h、1d。 |
| Not classified, Information, Warning, Average, High, Disaster |
自定义严重性名称和/或颜色以替代系统默认值。 输入新的颜色代码或点击颜色从提供的调色板中选择新颜色。 请注意，此处输入的自定义严重性名称将在所有语言环境中使用。如果您需要将其翻译为某些用户的其他语言，请参见Customizing trigger severities页面。 |
地理地图
此部分允许选择地理地图瓦片服务提供商，并配置地理地图 dashboard widget 的服务提供商设置。 为了提供地理地图的可视化功能，Zabbix 使用了开源 JavaScript 交互式地图库 Leaflet。请注意，Zabbix 无法控制第三方瓦片提供商（包括预定义的瓦片提供商）所提供的图像质量。
| 参数 | 描述 |
|---|---|
| Tile provider | 选择一个可用的瓦片服务提供商，或者选择 Other 以添加其他瓦片提供商或自托管瓦片（参见 使用自定义瓦片服务提供商）。 |
| Tile URL | 用于在地理地图上加载和显示瓦片层的 URL 模板（最多 2048 个字符）。 仅当 Tile provider 设置为 Other 时，此字段才可编辑。 支持以下占位符： {s} 表示一个可用的子域； {z} 表示 URL 中的缩放级别参数； {x} 和 {y} 表示瓦片坐标； {r} 可用于在 URL 中添加 "@2x" 以加载高清瓦片。 示例： https://{s}.example.com/{z}/{x}/{y}{r}.png |
| Attribution text | 在地图上的小文本框中显示的瓦片提供商署名文本。仅当 Tile provider 设置为 Other 时，此字段可见。 |
| Max zoom level | 地图的最大缩放级别。仅当 Tile provider 设置为 Other 时，此字段才可编辑。 |
使用自定义瓦片服务提供商
Geomap小部件get能够从自定义源加载栅格瓦片图像 自托管或第三方瓦片提供商服务。要使用自定义 第三方瓦片提供商服务或自托管瓦片文件夹或 服务器，在Tile provider字段中选择Other并指定 在Tile URL字段中使用正确的占位符自定义URL。
模块
本节允许管理自定义的以及内置的 frontend modules。
点击 扫描目录 以注册/取消注册任何自定义模块。
已注册的模块将出现在列表中；未注册的模块将从列表中移除。
点击列表中的模块状态以启用/禁用模块。
您还可以通过在列表中选择多个模块，然后点击列表下方的 启用/禁用 按钮来批量启用/禁用模块。
点击列表中的模块名称可在弹出窗口中查看其 details。
模块状态也可以在模块详情弹出窗口中更新；为此，请勾选/取消勾选 已启用 复选框，然后点击 更新。
您可以按名称或状态（已启用/已禁用）筛选模块。
连接器
本节允许通过 HTTP 配置 Zabbix 数据的连接器 streaming to external systems。
点击 创建连接器 以配置新的 配置。
您可以通过名称或状态（启用/禁用）来筛选连接器。点击列表中的连接器状态以启用或禁用该连接器。 您也可以通过在列表中选择多个连接器，然后点击列表下方的 启用/禁用 按钮来批量启用或禁用连接器。
其他
本节允许配置其他前端相关参数。
| 参数 | 描述 |
|---|---|
| Frontend URL | 指向 Zabbix Web 界面的 URL（最多 2048 个字符）。 该参数由 Zabbix Web 服务用于与前端通信，启用计划报表功能时必须指定。 |
| Group for discovered hosts | 通过 network discovery 和 agent autoregistration 发现的 主机 将自动放置在在此选择的 主机 组中。 |
| Default host inventory mode | 主机 资产清单的默认 mode。每当服务器或前端创建新的 主机 或 主机 原型时，都将遵循此设置，除非在通过 设置 主机 资产清单模式 操作进行 主机 发现/自动注册时覆盖。 |
| User group for database down message | 用于发送告警消息的用户组，或设置为“无”。 Zabbix server 依赖于后端数据库的可用性。没有数据库时无法工作。如果数据库宕机，Zabbix 可以通知所选用户。通知将通过启用的用户媒介条目发送到此处设置的用户组。通知通过以下 media types（启用时）传输：电子邮件；短信；自定义告警脚本。即使配置并启用了 Webhook 媒介条目，也不会触发通知。 Zabbix server 不会停止；它将等待数据库恢复后继续处理。 通知包含以下内容： [MySQL|PostgreSQL|Oracle] database <DB Name> [on <DB Host>:<DB Port>] is not available: <error message depending on the type of DBMS (database)>如果 <DB 主机> 被定义为空值，则不会添加到消息中；如果 <DB Port> 是默认值（"0"），则不会添加。告警管理器（一个特殊的 Zabbix server 进程）会每隔 10 秒尝试建立新的数据库连接。如果数据库仍然宕机，告警管理器将重复发送告警，但不会比每 15 分钟更频繁。 |
| Log unmatched SNMP traps | 如果未找到对应的 SNMP 接口，则记录 SNMP trap。 |
授权
| 参数 | 说明 |
|---|---|
| Login attempts | 在登录被阻止之前允许的失败 login 尝试次数。 |
| Login blocking interval | 当超过登录尝试次数限制时，禁止登录的时间段。允许范围：0 - 3600 秒。支持的格式示例：Time suffixes，如 90s、5m、1h。 |
存储密钥
Vault provider 参数允许选择用于存储 配置 值的密钥管理软件。支持的选项：
- HashiCorp Vault（默认）
- CyberArk Vault
另请参阅：Storage of secrets。
安全
| 参数 | 描述 |
|---|---|
| Validate URI schemes | 取消勾选此复选框将禁用URI方案验证（默认启用）。 如果勾选，您可以指定允许的URI方案的逗号分隔列表（默认：http,https,ftp,file,mailto,tel,ssh）。适用于前端中使用URI的所有字段（例如，地图元素URL）。 |
| Use X-Frame-Options HTTP header | 取消勾选此复选框将禁用HTTP X-Frame-options头（不推荐）。 如果勾选，您可以指定HTTP X-Frame-options头的值。支持的值： SAMEORIGIN（默认）或'self'（必须用单引号括起）- 页面只能在与其自身来源相同的框架中显示； DENY或'none'（必须用单引号括起）- 页面无法在框架中显示，无论尝试显示的站点是什么； 空格分隔的主机名string；在列表中添加'self'（必须用单引号括起）允许页面在其自身来源的框架中显示。 请注意，使用没有单引号的'self'或'none'将被视为主机名。 |
| Use iframe sandboxing | 取消勾选此复选框将禁用将检索到的URL内容放入沙箱（不推荐）。 如果勾选，您可以指定iframe沙箱例外情况；未指定的限制仍将适用。如果此字段为空，则应用所有沙箱属性限制。 有关更多信息，请参见 sandbox属性的描述。 |