Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

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

Обзор

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

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

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

Установка

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

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

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

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

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

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

Проблема Решение
Модуль не появился в списке Если ваш модуль не появился в списке, убедитесь, что файл manifest.json существует в папке modules/ваш-модуль/ веб-интерфейса Zabbix. Если его нет, возможно, вы распаковали модуль не в тот каталог. Если он есть, модуль может быть несовместим с вашей версией Zabbix. Также убедитесь, что пользователь, от имени которого работает веб-сервер, имеет права как минимум на чтение-запись (+rx) на папку модуля и все подпапки, и права на чтение (+r) на все файлы внутри.
Веб-интерфейс не запускается Код модуля несовместим с текущей версией Zabbix или конфигурацией сервера. Пожалуйста, удалите файлы модуля и перезагрузите веб-интерфейс. Вы увидите уведомление об отсутствии некоторых модулей. Перейдите к Администрированию модулей и снова нажмите Сканировать директорию (Scan directory), чтобы удалить несуществующие модули из базы данных.
Появляется сообщение ошибки об идентичном пространстве имён, идентификаторе или действиях Новый модуль попытался зарегистрировать пространство имён, идентификатор или действия, которые уже зарегистрированы другим активированным модулем. Деактивируйте конфликтующий модуль (упомянутый в сообщении об ошибке) перед активацией нового.
Появляются технические сообщения об ошибке Сообщить об ошибках разработчику модуля.

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

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