3 Модули веб-интерфейса

Обзор

Можно улучшить функциональность веб-интерфейса Zabbix, добавив сторонние модули или разработав собственные модули без необходимости изменения исходного кода Zabbix.

Обратите внимание, что код модуля будет работать с теми же привилегиями, что и исходный код Zabbix. Это означает, что:

  • сторонние модули могут быть вредоносными. Вы должны доверять модулям, которые вы устанавливаете;
  • ошибки в коде стороннего модуля могут привести к сбою веб-интерфейса. Если это произойдёт, просто удалите код модуля из веб-интерфейса. Как только вы перезагрузите веб-интерфейс Zabbix, вы увидите уведомление о том, что некоторые модули отсутствуют. Перейдите к администрированию модулей (в разделе Администрирование → Общие → Модули) и нажмите Сканировать директорию, чтобы удалить несуществующие модули из базы данных.

Установка

Пожалуйста, всегда читайте руководство по установке для конкретного модуля. Рекомендуется устанавливать новые модули по одному, чтобы легко выявлять сбои.

Непосредственно перед установкой модуля:

  • Убедитесь, что вы загрузили модуль из доверенного источника. Установка вредоносного кода может привести к таким последствиям, как потеря данных
  • Разные версии одного и того же модуля (с одинаковым ID) могут быть установлены параллельно, но одновременно может быть включена только одна версия

Шаги по установке модуля:

  • Распакуйте модуль в отдельную папку внутри папки modules в веб-интерфейсе Zabbix
  • Убедитесь, что папка модуля содержит как минимум файл manifest.json
  • Перейдите в раздел Управление модулями и нажмите кнопку Сканировать каталог
  • Новый модуль появится в списке вместе со своей версией, автором, описанием и статусом
  • Включите модуль, нажав на его статус

Устранение неполадок:

Проблема Решение
Модуль не появился в списке Если модуль не появился в списке, убедитесь, что файл manifest.json существует в modules/your-module/. Если его нет, возможно, вы распаковали модуль не в тот каталог. Если файл есть, модуль может быть несовместим с вашей версией Zabbix. Также проверьте, что пользователь веб-сервера имеет как минимум права на чтение и поиск (r-x) для папки модуля и всех вложенных каталогов, а также права на чтение (r--) для всех файлов внутри.
Веб-интерфейс перестал работать Код модуля несовместим с текущей версией Zabbix или конфигурацией сервера. Удалите файлы модуля и перезагрузите веб-интерфейс. Вы увидите уведомление о том, что некоторые модули отсутствуют. Перейдите в раздел Управление модулями и снова нажмите Сканировать каталог, чтобы удалить из базы данных несуществующие модули.
Появляется сообщение об ошибке об одинаковом namespace, ID или actions Новый модуль попытался зарегистрировать namespace, ID или actions, которые уже зарегистрированы другими включенными модулями. Отключите конфликтующий модуль (указанный в сообщении об ошибке) перед включением нового.
Появляются технические сообщения об ошибках Сообщите об ошибках разработчику модуля.

Разработка модулей

Информацию о разработке пользовательских модулей см. в Центре разработчиков.