2 Moduły frontendu

Przegląd

Możliwe jest rozszerzenie funkcjonalności frontend Zabbix przez dodanie modułów firm trzecich lub tworzenie własnych modułów bez konieczności zmiany kodu źródłowego Zabbix.

Należy pamiętać, że kod modułu będzie uruchamiany z takimi samymi uprawnieniami jak kod źródłowy Zabbix. Oznacza to, że:

  • moduły firm trzecich mogą być szkodliwe. Musisz ufać modułom, które instalujesz;
  • błędy w kodzie modułu firmy trzeciej mogą spowodować awarię frontend. Jeśli tak się stanie, po prostu usuń kod modułu z frontend. Gdy tylko ponownie załadujesz frontend Zabbix, zobaczysz informację, że niektóre moduły są nieobecne. Przejdź do Administracja modułami (w Administracja → Ogólne → Moduły) i kliknij ponownie Skanuj katalog, aby usunąć nieistniejące moduły z bazy danych.

Instalacja

Zawsze czytaj instrukcję instalacji dla konkretnego modułu. Zaleca się instalowanie nowych modułów pojedynczo, aby łatwo wykrywać błędy.

Tuż przed instalacją modułu:

  • Upewnij się, że pobrałeś moduł z zaufanego źródła. Instalacja szkodliwego kodu może prowadzić do konsekwencji, takich jak utrata danych
  • Różne wersje tego samego modułu (to samo ID) mogą być instalowane równolegle, ale tylko jedna wersja może być włączona jednocześnie

Kroki instalacji modułu:

  • Rozpakuj moduł we własnym folderze w folderze modules frontend Zabbix
  • Upewnij się, że folder modułu zawiera co najmniej plik manifest.json
  • Przejdź do Administracja modułów i kliknij przycisk Skanuj katalog
  • Nowy moduł pojawi się na liście wraz z wersją, autorem, opisem i statusem
  • Włącz moduł, klikając jego status

Rozwiązywanie problemów:

Problem Rozwiązanie
Moduł nie pojawił się na liście Jeśli moduł nie pojawił się na liście, upewnij się, że plik manifest.json istnieje w modules/your-module/. Jeśli go nie ma, możliwe, że moduł został rozpakowany do niewłaściwego katalogu. Jeśli plik istnieje, moduł może nie być zgodny z Twoją wersją Zabbix. Sprawdź też, czy użytkownik serwera WWW ma co najmniej uprawnienia do odczytu i przeszukiwania (r-x) dla folderu modułu i wszystkich podkatalogów oraz uprawnienia do odczytu (r--) dla wszystkich plików wewnątrz.
frontend uległ awarii Kod modułu nie jest zgodny z bieżącą wersją Zabbix lub konfiguracją serwera. Usuń pliki modułu i ponownie załaduj frontend. Zobaczysz powiadomienie, że niektóre moduły są nieobecne. Przejdź do Administracja modułów i ponownie kliknij Skanuj katalog, aby usunąć nieistniejące moduły z bazy danych.
Pojawia się komunikat o błędzie dotyczącym identycznej przestrzeni nazw, ID lub akcji Nowy moduł próbował zarejestrować przestrzeń nazw, ID lub akcje, które są już zarejestrowane przez inne włączone moduły. Przed włączeniem nowego modułu wyłącz moduł powodujący konflikt (wymieniony w komunikacie o błędzie).
Pojawiają się techniczne komunikaty o błędach Zgłoś błędy twórcy modułu.

Tworzenie modułów

Aby uzyskać informacje o tworzeniu niestandardowych modułów, zobacz Developer center.