3 Moduły frontend

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ć ewentualne błędy.

Tuż przed instalacją modułu:

  • Upewnij się, że pobrałeś moduł z zaufanego źródła. Instalacja złośliwego 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 jednocześnie można włączyć tylko jedną wersję

Kroki instalacji modułu:

  • Rozpakuj moduł do własnego folderu w folderze modules frontend Zabbixa
  • 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/twój-moduł/. Jeśli go nie ma, moduł mógł zostać rozpakowany do niewłaściwego katalogu. Jeśli plik istnieje, moduł może nie być zgodny z Twoją wersją Zabbixa. Sprawdź też, czy użytkownik serwera WWW ma co najmniej dostęp do odczytu i przeszukiwania (r-x) do folderu modułu i wszystkich podkatalogów oraz dostęp do odczytu (r--) do wszystkich plików wewnątrz.
frontend uległ awarii Kod modułu nie jest zgodny z bieżącą wersją Zabbixa lub konfiguracją serwera. Usuń pliki modułu i odśwież 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ący 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.