3 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 leicht erkennen zu können.

Unmittelbar bevor Sie ein Modul installieren:

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

Schritte zur Installation eines Moduls:

  • Entpacken Sie Ihr Modul in seinem eigenen Ordner im Ordner modules des Zabbix Frontends
  • Stellen Sie sicher, dass Ihr Modulordner mindestens die Datei manifest.json enthält
  • Navigieren Sie zu Modulverwaltung und klicken Sie auf die Schaltfläche Verzeichnis durchsuchen
  • Das neue Modul wird zusammen mit seiner Version, seinem Autor, seiner Beschreibung und seinem 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 in der Liste 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 Benutzer des Webservers mindestens Lese- und Suchzugriff (r-x) auf den Modulordner und alle Unterverzeichnisse sowie Lesezugriff (r--) auf alle darin enthaltenen Dateien hat.
Frontend ist abgestürzt Der Modulcode ist nicht mit der aktuellen Zabbix-Version oder der Server-Konfiguration kompatibel. Bitte löschen Sie die Moduldateien und laden Sie das Frontend neu. Sie sehen einen Hinweis, dass einige Module fehlen. Gehen Sie zu Modulverwaltung und klicken Sie erneut auf Verzeichnis durchsuchen, um nicht vorhandene Module aus der Datenbank zu entfernen.
Es erscheint eine Fehlermeldung über identischen Namespace, identische ID oder identische Aktionen Das neue Modul hat versucht, einen Namespace, eine ID oder Aktionen zu registrieren, die bereits von anderen aktivierten Modulen registriert wurden. Deaktivieren Sie das in der Fehlermeldung genannte konfliktverursachende Modul, bevor Sie das neue aktivieren.
Technische Fehlermeldungen werden angezeigt Melden Sie Fehler dem Entwickler des Moduls.

Entwicklung von Modulen

Informationen zur Entwicklung benutzerdefinierter Module finden Sie im Developer center.