2 前端模块
概述
可以通过添加第三方模块或开发自己的模块来增强 Zabbix 前端功能,而无需更改 Zabbix 的源代码。
请注意,模块代码将以与 Zabbix 源代码相同的权限运行。这意味着:
- 第三方模块可能会造成危害。您必须信任您正在安装的模块;
- 第三方模块代码中的错误可能会导致前端崩溃。如果发生这种情况,只需从前端删除模块代码即可。重新加载 Zabbix 前端后,您会看到一条提示,提示某些模块缺失。转到模块管理(在Administration → General → Modules),然后再次单击扫描目录以从数据库中删除不存在的模块。
安装
请始终阅读特定模块的安装手册。建议逐个安装新模块,以便轻松发现故障。
在安装模块之前:
- 确保您已从可信来源下载该模块。安装有害代码可能会导致数据丢失等后果
- 同一模块的不同版本(相同 ID)可以并行安装,但一次只能启用一个版本
安装模块的步骤:
- 将模块解压到 Zabbix 前端的
modules文件夹中的其专用文件夹内 - 确保模块文件夹至少包含 manifest.json 文件
- 导航到 模块管理,然后单击 Scan directory 按钮
- 新模块将连同其版本、作者、描述和状态一起显示在列表中
- 通过单击其状态来启用模块
故障排除:
| Problem | Solution |
|---|---|
| Module did not appear in the list | 如果您的模块没有出现在列表中,请确保 manifest.json 存在于 modules/your-module/ 中。如果不存在,您可能将模块解压到了错误的目录中。如果存在,则该模块可能与您的 Zabbix 版本不兼容。另外,请检查 web 服务器用户对模块文件夹及其所有子目录至少具有读取和搜索访问权限(r-x),并对其中所有文件具有读取权限(r--)。 |
| Frontend crashed | 模块代码与当前 Zabbix 版本或服务器配置不兼容。请删除模块文件并重新加载前端。您会看到一条提示,说明某些模块缺失。转到 模块管理,然后再次单击 Scan directory,以从数据库中删除不存在的模块。 |
| Error message about identical namespace, ID or actions appears | 新模块尝试注册一个已被其他已启用模块注册的命名空间、ID 或 actions。请在启用新模块之前,先禁用冲突的模块(错误消息中提到的模块)。 |
| Technical error messages appear | 请将错误报告给该模块的开发者。 |
开发模块
有关开发自定义模块的信息,请参阅开发者中心。