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

Обзор

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

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

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

Установка

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

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

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

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

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

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

Problem Solution
Module did not appear in the list Если ваш модуль не появился в списке, убедитесь, что manifest.json существует в modules/your-module/. Если его нет, возможно, вы распаковали модуль не в тот каталог. Если файл есть, модуль может быть несовместим с вашей версией Zabbix. Также проверьте, что пользователь веб-сервера имеет как минимум права на чтение и поиск (r-x) для папки модуля и всех подкаталогов, а также права на чтение (r--) для всех файлов внутри.
Frontend crashed Код модуля несовместим с текущей версией Zabbix или конфигурацией сервера. Удалите файлы модуля и перезагрузите веб-интерфейс. Вы увидите уведомление о том, что некоторые модули отсутствуют. Перейдите в Администрирование модулей и снова нажмите Сканировать каталог, чтобы удалить несуществующие модули из базы данных.
Error message about identical namespace, ID or actions appears Новый модуль попытался зарегистрировать namespace, ID или actions, которые уже зарегистрированы другими включенными модулями. Перед включением нового модуля отключите конфликтующий модуль (указанный в сообщении об ошибке).
Technical error messages appear Сообщите об ошибках разработчику модуля.

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

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