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

Обзор

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

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

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

Установка

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

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

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

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

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

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

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

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

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