3 前端模块

概述

通过添加第三方模块或在不修改 Zabbix 源代码的情况下开发自己的模块,可以增强 Zabbix 前端的功能。

请注意,模块代码将run与 Zabbix 源代码相同的权限。这意味着:

  • 第三方模块可能是有害的。您必须信任所安装的模块;
  • 第三方模块代码中的错误可能会导致前端崩溃。如果发生这种情况,请立即将模块代码从前端移除。当您重新加载 Zabbix 前端时,您会看到一条提示,指出某些模块缺失。请转到模块(位于 AdministrationGeneralModules)并再次点击 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