2 Frontend-Module

Überblick

Es ist möglich, die Funktionalität des Zabbix Frontend zu erweitern, indem Module von Drittanbietern hinzugefügt oder eigene Module entwickelt werden, ohne dass der Quellcode von Zabbix geändert werden muss.

Beachten Sie, dass der Modulcode mit denselben Berechtigungen ausgeführt wird wie der Quellcode von Zabbix. Das bedeutet:

  • Module von Drittanbietern können schädlich sein. Sie müssen den Modulen vertrauen, die Sie installieren;
  • Fehler im Code eines Drittanbieter-Moduls können das Frontend zum Absturz bringen. Falls dies geschieht, entfernen Sie einfach den Modulcode aus dem Frontend. Sobald Sie das Zabbix Frontend neu laden, sehen Sie einen Hinweis, dass einige Module fehlen. Gehen Sie zu Modulverwaltung (unter Administration → Allgemein → Module) und klicken Sie erneut auf Verzeichnis durchsuchen, um nicht vorhandene Module aus der Datenbank zu entfernen.

Installation

Bitte lesen Sie immer das Installationshandbuch für ein bestimmtes Modul. Es wird empfohlen, neue Module nacheinander zu installieren, um Fehler leichter zu erkennen.

Unmittelbar bevor Sie ein Modul installieren:

  • Stellen Sie sicher, dass Sie das Modul aus einer vertrauenswürdigen Quelle heruntergeladen haben. Die Installation schädlichen Codes kann zu Folgen wie Datenverlust führen
  • Verschiedene Versionen desselben Moduls (gleiche ID) können parallel installiert werden, aber jeweils nur eine Version kann gleichzeitig aktiviert sein

Schritte zur Installation eines Moduls:

  • Entpacken Sie Ihr Modul in einem eigenen Ordner im modules-Ordner des Zabbix Frontend
  • Stellen Sie sicher, dass Ihr Modulverzeichnis mindestens die Datei manifest.json enthält
  • Navigieren Sie zu Modulverwaltung und klicken Sie auf die Schaltfläche Verzeichnis scannen
  • Das neue Modul wird zusammen mit seiner Version, dem Autor, der Beschreibung und dem Status in der Liste angezeigt
  • Aktivieren Sie das Modul, indem Sie auf seinen Status klicken

Fehlerbehebung:

Problem Lösung
Modul wurde nicht in der Liste angezeigt Wenn Ihr Modul nicht angezeigt wurde, stellen Sie sicher, dass manifest.json in modules/your-module/ vorhanden ist. Falls nicht, haben Sie das Modul möglicherweise in das falsche Verzeichnis entpackt. Falls doch, ist das Modul möglicherweise nicht mit Ihrer Zabbix-Version kompatibel. Prüfen Sie außerdem, dass der Webserver-Benutzer mindestens Lese- und Suchzugriff (r-x) auf den Modulordner und alle Unterverzeichnisse sowie Lesezugriff (r--) auf alle darin enthaltenen Dateien hat.
Frontend abgestürzt Der Modulcode ist nicht mit der aktuellen Zabbix-Version oder der Serverkonfiguration kompatibel. Bitte löschen Sie die Moduldateien und laden Sie das Frontend neu. Sie werden eine Meldung sehen, dass einige Module fehlen. Gehen Sie zu Modulverwaltung und klicken Sie erneut auf Verzeichnis scannen, um nicht vorhandene Module aus der Datenbank zu entfernen.
Fehlermeldung über identischen Namespace, ID oder Aktionen erscheint Das neue Modul hat versucht, einen Namespace, eine ID oder Aktionen zu registrieren, die bereits von anderen aktivierten Modulen registriert sind. Deaktivieren Sie das konfliktverursachende Modul (in der Fehlermeldung genannt), bevor Sie das neue aktivieren.
Technische Fehlermeldungen erscheinen Melden Sie Fehler dem Entwickler des Moduls.

Entwicklung von Modulen

Informationen zur Entwicklung benutzerdefinierter Module finden Sie im Developer center.