Table of Contents
1 概述
概述
管理 → 常规 部分包含多个子部分 用于设置前端相关默认值及自定义Zabbix
可用子部分列表会在点击管理菜单部分的常规后显示 也可通过Top左侧角落的标题下拉菜单切换子部分
1 图形用户界面
本节提供多个前端相关默认设置的自定义选项。
配置参数：
| 参数 | 描述 |
|---|---|
| Default language | 未在个人资料中指定语言的用户及访客用户的默认语言。 更多信息请参阅Installation of additional frontend languages。 |
| Default time zone | 未在个人资料中指定时区的用户及访客用户的默认概述。 |
| Default theme | 未在个人资料中指定主题的用户及访客用户的默认主题。 |
| Limit for search and filter results | Web界面列表（如配置 > 主机）中显示的最大元素数量（行数）。 注意：若设置为'50'，所有受影响的前端列表仅显示前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不可达（可能宕机）时，在浏览器窗口显示警告消息。该消息在页面滚动时保持可见，悬停时可临时隐藏以查看下方内容。 本参数自Zabbix 2.0.1起支持。 |
| Working time | 系统级参数定义工作时间。图表中工作时间显示为白色背景，非工作时间显示为灰色。 时间格式说明参见Time period specification页面。 支持User macros（自Zabbix 3.4.0起）。 |
| Show technical errors | 勾选后所有注册用户可查看技术错误（PHP/SQL）。未勾选时仅6-用户及具有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周）。 |
2 自动注册
在本节中，您可以配置主动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'时可用. |
另请参阅：安全自动注册
3 管家服务
管家服务是一个周期性进程，由Zabbix server执行。 该进程会移除过期的信息以及用户删除的信息。
在本节中，可以针对以下类别单独启用或禁用管家任务： 事件和告警/IT服务/用户会话/历史数据/趋势数据。审计管家设置位于独立的审计日志。
若启用管家服务，可设置数据记录在被管家移除前的保留天数。
删除监控项/触发器时，将同时delete由该监控项/触发器生成的问题。
此外，只有当事件与问题完全无关时，管家才会删除该事件。这意味着若事件属于问题事件或恢复事件，则需等待相关问题记录被移除后才会删除。管家会先delete问题，再处理事件，以避免残留事件或问题记录引发潜在问题。
对于历史数据和趋势数据，提供额外选项：覆盖监控项历史周期和覆盖监控项趋势周期。此选项可全局设置监控项历史/趋势数据的保留时长（1小时至25年；或"0"），此时将覆盖item configuration中历史存储周期/趋势存储周期字段为单个监控项设置的值。注意，对于已启用配置选项不保留历史和/或不保留趋势的监控项，存储周期不会被覆盖。
即使禁用内部管家服务，仍可覆盖历史/趋势存储周期。因此，使用外部管家时，可通过历史数据存储周期字段设置历史存储周期。
若使用TimescaleDB， 为充分利用TimescaleDB对历史和趋势表的自动分区功能， 必须启用覆盖监控项历史周期和覆盖监控项趋势周期选项， 同时为历史和趋势启用启用内部管家服务选项。 否则这些表中的数据仍会存储在分区中， 但管家不会清理过期分区， 且会显示配置错误的警告。 当启用过期分区删除功能后， Zabbix server和前端将不再跟踪已删除的监控项， 且已删除监控项的历史数据会在过期分区删除时被清除。
周期字段支持Time suffixes， 例如1d（一天）、1w（一周）。最小值为1天（历史数据为1小时）， 最大值为25年。
重置默认值按钮可还原所有修改。
4 审计日志
本部分用于配置审计日志设置。
可配置以下参数：
| 参数 | 描述 |
|---|---|
| Enable audit logging | 启用/禁用审计日志记录。默认已勾选。 |
| Enable internal housekeeping | 启用/禁用审计的内部维护功能。默认已勾选。 |
| Data storage period | 审计记录在被维护程序删除前应保留的天数。若启用维护功能则必须设置。默认值：365天。 |
5 镜像
图像部分显示Zabbix中所有可用的图像。图像存储在数据库中。
通过类型下拉菜单可在图标与背景图像之间切换：
- 图标用于显示network map元素
- 背景图像用作网络地图的背景
添加图像
您可以通过点击Top右上角的创建图标或创建背景按钮来添加自定义图像。
图像属性：
| 参数 | 描述 |
|---|---|
| Name | 图像的唯一名称。 |
| Upload | 从本地系统选择file格式（PNG/JPEG/GIF）文件上传至Zabbix。 注意：其他格式文件也可能被上传，但会在上传过程中转换为PNG格式。图像处理使用GD库，因此支持的格式取决于该库version的版本（Zabbix要求2.0.28或更高版本）。 |
上传file的最大尺寸受ZBX_MAX_IMAGE_SIZE限制，该值为1024x1024字节（即1MB）。
若图像大小接近1MB且MySQL配置参数max_allowed_packet保持默认值1MB时，可能导致上传失败。此时需增大max_allowed_packet参数值。
6 图标映射
本部分允许为特定主机创建图标映射。系统将使用主机资产字段信息来create映射关系。
这些映射可用于network map configuration来自动为匹配的主机分配对应图标。
要create新图标映射，请点击Top右上角的创建图标映射。
配置参数：
| 参数 | 说明 |
|---|---|
| Name | 图标映射的唯一名称。 |
| Mappings | 映射关系列表。映射的排列顺序决定优先级，可通过拖拽调整顺序。 |
| Inventory field | 用于匹配查询的主机资产字段。 |
| Expression | 描述匹配规则的正则表达式。 |
| Icon | 匹配成功时使用的图标。 |
| Default | 默认使用的图标。 |
7 正则表达式
本部分允许创建自定义正则表达式，这些表达式可在前端多个位置使用。详情请参阅Regular expressions章节。
8 宏
本部分允许定义系统级的user macros作为键值对。请注意宏值可以保存为纯文本、加密文本或Vault机密。同时支持添加描述信息。
9 触发器显示选项
本部分允许自定义前端中触发器状态的显示方式以及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页面。 |
10 地理地图
本部分允许选择地理地图瓦片服务提供商，并为地理地图dashboard widget配置服务提供商设置。 为了提供地理地图可视化功能，Zabbix使用了开源JavaScript交互式地图库Leaflet。请注意， Zabbix无法控制第三方瓦片提供商（包括预定义的瓦片提供商）提供的图像质量。
| 参数 | 描述 |
|---|---|
| Tile provider | 从可用的瓦片服务提供商中选择一个，或选择其他以添加其他瓦片提供商或自托管瓦片（参见使用自定义瓦片服务提供商）。 |
| Tile URL | 用于在地理地图上加载和显示瓦片层的URL模板。仅当瓦片提供商设置为其他时，此字段可编辑。 支持以下占位符： {s} 表示可用的子域名之一； {z} 表示URL中的缩放级别参数； {x} 和 {y} 表示瓦片坐标； {r} 可用于在URL中添加"@2x"以加载视网膜瓦片。 示例： https://{s}.example.com/{z}/{x}/{y}{r}.png |
| Attribution text | 在地图上的小文本框中显示的瓦片提供商归属文本。仅当瓦片提供商设置为其他时，此字段可见。 |
| Max zoom level | 地图的最大缩放级别。仅当瓦片提供商设置为其他时，此字段可编辑。 |
使用自定义瓦片服务提供商
地理地图部件能够从自定义自托管或第三方瓦片提供商服务加载栅格瓦片图像。要使用自定义第三方瓦片提供商服务或自托管瓦片文件夹/服务器，请在瓦片提供商字段中选择其他，并在瓦片URL字段中使用正确的占位符指定自定义URL。
11 模块
本部分用于管理自定义frontend modules.
点击扫描目录来注册/注销任何自定义模块. 已注册模块将显示在列表中,并附带其详细信息. 未注册模块将从列表中移除.
您可以按名称或状态(启用/禁用)筛选模块.点击 列表中的模块状态可启用/禁用模块.您也可以 通过选择列表中的模块,然后点击列表下方的 启用/禁用按钮来批量启用/禁用模块.
12 API 令牌
本部分允许create和管理API令牌.
您可以通过名称、令牌分配的用户、过期日期、创建令牌的用户或状态（启用/禁用）来筛选API令牌。点击列表中的令牌状态可快速启用/禁用令牌。您也可以通过选择列表中的令牌，然后点击列表下方的启用/禁用按钮来批量启用/禁用令牌。
要create新令牌，请点击Top右上角的创建API令牌按钮，然后在令牌配置界面填写必填字段：
| 参数 | 描述 |
|---|---|
| Name | 令牌的可见名称. |
| User | 令牌应分配的用户。要快速选择用户，开始输入用户名、名字或姓氏，然后从自动完成列表中选择所需用户。或者，您可以点击选择按钮从完整用户列表中选择用户。一个令牌只能分配给一个用户。 |
| Description | 可选的令牌描述. |
| Set expiration date and time | 如果令牌不应有过期日期，请取消勾选此复选框. |
| Expiry date | 点击日历图标选择令牌过期日期，或以YYYY-MM-DD hh:mm:ss格式手动输入日期. |
| Enabled | 如果需要create处于禁用状态的令牌，请取消勾选此复选框. |
点击添加以create令牌。在下一个界面，copy并在安全的地方保存认证令牌值在关闭页面之前，然后点击关闭。令牌将出现在列表中。
认证令牌值之后无法再次查看。它仅在创建令牌后立即可用。如果您丢失了保存的令牌，您将需要重新生成它，这将create一个新的授权string。
点击令牌名称可编辑名称、描述、过期日期设置或令牌状态。请注意，无法更改令牌分配的用户。点击更新按钮保存更改。如果令牌丢失或泄露，您可以点击重新生成按钮generate新的令牌值。将出现确认对话框，要求您确认此操作，因为操作后先前生成的令牌将失效。
无法访问管理菜单部分的用户只能在用户资料→API令牌api-令牌中查看和修改分配给他们的令牌详情，前提是他们的user role权限中允许管理API令牌。
13 其他参数
本部分允许配置其他前端杂项参数。
| 参数 | 描述 |
|---|---|
| Frontend URL | Zabbix网页界面的URL。该参数被Zabbix网络服务用于与前端通信，需指定以启用定时报告功能。 |
| Group for discovered hosts | 通过network discovery和agent autoregistration发现的主机将自动归入此处选择的主机组。 |
| Default host inventory mode | 主机清单的默认mode。当服务器或前端创建新的主机或主机原型时，将遵循此模式，除非在主机发现/自动注册期间通过设置主机清单模式操作进行覆盖。 |
| User group for database down message | 用于发送告警消息的用户组或'无'。 Zabbix server功能依赖于后端数据库的可用性。没有数据库时该功能无法工作。若数据库宕机，Zabbix可通知选定用户。通知将通过所有配置的用户媒介条目发送至此处设置的用户组。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 | 当超过登录尝试限制时，禁止登录的时间段。 |
安全
| 参数 | 描述 |
|---|---|
| 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属性的描述。 |
与 Zabbix server 的通信
| 参数 | 描述 |
|---|---|
| Network timeout | 关闭空闲套接字前的等待秒数（若之前已建立与Zabbix server的连接，但前端在此时间内无法完成读/发送数据操作，连接将被丢弃）。允许范围：1-300秒（默认：3秒）。 |
| Connection timeout | 停止尝试连接Zabbix server前的等待秒数。允许范围：1-30秒（默认：3秒）。 |
| Network timeout for media type test | 测试媒体类型时等待响应的秒数。允许范围：1-300秒（默认：65秒）。 |
| Network timeout for script execution | 执行脚本时等待响应的秒数。允许范围：1-300秒（默认：60秒）。 |
| Network timeout for item test | 测试监控项时等待返回数据的秒数。允许范围：1-300秒（默认：60秒）。 |
| Network timeout for scheduled report test | 测试计划报告时等待返回数据的秒数。允许范围：1-300秒（默认：60秒）。 |