3 前端模块
概述
通过添加第三方模块或在不修改 Zabbix 源代码的情况下开发自己的模块,可以增强 Zabbix 前端的功能。
请注意,模块代码将run与 Zabbix 源代码相同的权限。这意味着:
- 第三方模块可能是有害的。您必须信任所安装的模块;
- 第三方模块代码中的错误可能会导致前端崩溃。如果发生这种情况,请立即将模块代码从前端移除。当您重新加载 Zabbix 前端时,您会看到一条提示,指出某些模块缺失。请转到模块(位于 Administration → General → Modules)并再次点击 Scan directory,以从数据库中移除不存在的模块。
安装
请务必阅读特定模块的安装手册。建议逐个安装新模块,以便更容易发现失败。
在安装模块之前:
- 确保您是从可信来源下载该模块。安装有害代码可能会导致数据丢失等后果
- 同一模块的不同版本(相同 ID)可以并行安装,但一次只能启用一个版本
安装模块的步骤:
- 将模块解压到 Zabbix 前端安装目录中
modules目录下的独立文件夹中(例如,zabbix/ui/modules)。 - 确保您的模块文件夹至少包含
manifest.json文件。 - 转到 模块管理,然后单击 扫描目录 按钮。
- 新模块将出现在列表中,并显示其版本、作者、描述和状态。
- 单击其状态以启用模块。
故障排除:
| 问题 | 解决方案 |
|---|---|
| 模块未出现在列表中 | 如果您的模块没有出现在列表中,请确保 manifest.json 存在于 modules/your-module/ 中。如果不存在,可能是您将模块解压到了错误的目录。如果存在,则该模块可能与您的 Zabbix 版本不兼容。另外,请检查 web 服务器用户对模块文件夹及其所有子目录至少具有读取和搜索权限(r-x),并对其中所有文件具有读取权限(r--)。 |
| 前端崩溃 | 该模块代码与当前 Zabbix 版本或服务器配置不兼容。请删除模块文件并重新加载前端。您会看到某些模块缺失的提示。转到 模块管理,然后再次单击 扫描目录,以从数据库中移除不存在的模块。 |
| 出现关于相同命名空间、ID 或 actions 的错误消息 | 新模块尝试注册一个命名空间、ID 或 actions,而这些内容已被其他已启用的模块注册。请先禁用冲突的模块(错误消息中提到的模块),然后再启用新模块。 |
| 出现技术性错误消息 | 请将错误报告给该模块的开发者。 |
开发模块
有关开发自定义模块的信息,请参阅 Developer center。