3 Odkrywanie niskiego poziomu

Omówienie

Low-level discovery (LLD) automatycznie wykrywa encje (np. systemy plików, interfejsy sieciowe) na host i tworzy odpowiadające im pozycje, wyzwalacze i wykresy bez ręcznej konfiguracji dla każdej z nich.

Aby używać LLD, tworzysz regułę wykrywania, która zbiera dane JSON opisujące encje, oraz prototypy (pozycja, wyzwalacz i wykres) dla każdej encji.

JSON zwracany przez regułę musi być tablicą obiektów, gdzie każdy obiekt reprezentuje jedną wykrytą encję za pomocą par klucz-wartość. Na przykład reguła wykrywania z net.if.discovery może zwrócić:

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

Odpowiedni zestaw pozycji, wyzwalaczy i wykresów jest następnie tworzony na podstawie prototypów — po jednym dla każdego interfejsu (lo i eth0).

Jeśli obiekty zawierają klucze w formacie {#MACRO}, te makra są używane bezpośrednio w prototypach. Jeśli nie, lub jeśli wymagane są dodatkowe/własne makra, można je zdefiniować ręcznie i mapować do pól JSON za pomocą JSONPath.

LLD może również tworzyć hosty (np. dla maszyn wirtualnych wykrytych na hypervisorze) oraz obsługuje zagnieżdżone reguły wykrywania dla wielopoziomowego wykrywania.

Encje, które nie są już wykrywane, mogą być automatycznie wyłączane lub usuwane.

Konfigurowanie niskopoziomowego wykrywania

Pokażemy niskopoziomowe wykrywanie na przykładzie wykrywania systemu plików.

Aby skonfigurować wykrywanie, wykonaj następujące czynności:

1. Przejdź do Data collection > Templates lub Hosts.
2. Kliknij Discovery w wierszu odpowiedniego szablonu/hosta.

3. Kliknij Create discovery rule w prawym górnym rogu ekranu.
4. Wypełnij formularz reguły wykrywania, podając wymagane szczegóły.

Reguła wykrywania

Formularz reguły wykrywania zawiera pięć kart przedstawiających, od lewej do prawej, przepływ danych podczas wykrywania:

• Reguła wykrywania - określa, której wbudowanej pozycji lub niestandardowego skryptu należy użyć do pobierania danych wykrywania.
• Przetwarzanie wstępne - umożliwia zastosowanie przetwarzania wstępnego do wykrytych danych.
• Makra LLD - umożliwiają wyodrębnianie wartości makr do użycia w wykrytych pozycjach, wyzwalaczach itd.
• Filtry - umożliwiają filtrowanie wykrytych wartości.
• Zastąpienia - umożliwiają modyfikowanie pozycji, wyzwalaczy, wykresów lub prototypów hostów po zastosowaniu do określonych wykrytych obiektów.

Karta Reguła wykrywania zawiera klucz pozycji używany do wykrywania (a także niektóre ogólne atrybuty reguły wykrywania):

Wszystkie wymagane pola wejściowe są oznaczone czerwoną gwiazdką.

Wstępne przetwarzanie

Karta Wstępne przetwarzanie umożliwia zdefiniowanie reguł transformacji stosowanych do wyniku wykrywania. W tym kroku można zastosować jedną lub kilka transformacji. Transformacje są wykonywane w kolejności, w której zostały zdefiniowane. Całe wstępne przetwarzanie jest wykonywane przez serwer Zabbix.

Zobacz także:

• Szczegóły wstępnego przetwarzania
• Testowanie wstępnego przetwarzania

Należy pamiętać, że jeśli reguła wykrywania została zastosowana do host za pośrednictwem szablonu, zawartość tej karty jest tylko do odczytu.

Niestandardowe makra

Karta Makra LLD umożliwia określenie niestandardowych makr wykrywania niskopoziomowego.

Niestandardowe makra są przydatne w sytuacjach, gdy zwracany kod JSON nie zawiera jeszcze wymaganych makr. Na przykład:

• Natywny klucz vfs.fs.discovery służący do wykrywania systemów plików zwraca kod JSON z pewnymi wstępnie zdefiniowanymi makrami LLD, takimi jak {#FSNAME}, {#FSTYPE}. Makra te mogą być bezpośrednio używane w prototypach pozycji i wyzwalaczy (zobacz kolejne sekcje tej strony); definiowanie niestandardowych makr nie jest wymagane;
• pozycja agenta vfs.fs.get również zwraca kod JSON z danymi systemu plików, ale bez wstępnie zdefiniowanych makr LLD. W takim przypadku można samodzielnie zdefiniować makra i zmapować je na wartości w kodzie JSON za pomocą JSONPath:

Wyodrębnione wartości mogą być używane w wykrytych pozycjach, wyzwalaczach itd. Należy pamiętać, że wartości będą wyodrębniane z wyniku wykrywania oraz z dotychczas wykonanych kroków przetwarzania wstępnego.

Filtr

Filtru można użyć do generowania rzeczywistych pozycji, wyzwalaczy i wykresów tylko dla encji spełniających określone kryteria. Karta Filtry zawiera definicje filtrów reguł wykrywania, które umożliwiają filtrowanie wartości wykrywania:

Na przykład, jeśli interesują Cię tylko systemy plików C:, D: i E:, możesz umieścić {#FSNAME} w polu Makro, a ^C|^D|^E w polu Wyrażenie regularne.
Filtrowanie jest również możliwe według typów systemów plików za pomocą makra {#FSTYPE} (np. ^ext|^reiserfs) oraz według typów dysków (obsługiwanych tylko przez Windows agent) za pomocą makra {#FSDRIVETYPE} (np. fixed).

Aby przetestować wyrażenie regularne, można użyć polecenia grep -E, na przykład:

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

Nadpisywanie

Karta Nadpisywania umożliwia skonfigurowanie reguł modyfikowania listy prototypów pozycji, wyzwalaczy, wykresów, hostów i reguł wykrywania lub ich atrybutów dla wykrytych obiektów spełniających określone kryteria.

Nadpisywania (jeśli istnieją) są wyświetlane na liście, której kolejność można zmieniać metodą przeciągania i upuszczania, oraz wykonywane w kolejności, w której zostały zdefiniowane. Aby skonfigurować szczegóły nowego nadpisywania, kliknij w bloku Nadpisywania. Aby edytować istniejące nadpisywanie, kliknij jego nazwę. Otworzy się wyskakujące okno umożliwiające edycję szczegółów reguły nadpisywania.

Wszystkie wymagane parametry są oznaczone czerwonymi gwiazdkami.

Konfigurowanie operacji

Aby skonfigurować szczegóły nowej operacji, kliknij w bloku Operacje. Aby edytować istniejącą operację, kliknij obok operacji. Otworzy się wyskakujące okno umożliwiające edycję szczegółów operacji.

Parametr			Opis
Obiekt			Dostępnych jest pięć typów obiektów: Prototyp pozycji Prototyp wyzwalacza Prototyp wykresu Prototyp hosta Prototyp reguły wykrywania
Warunek			Umożliwia filtrowanie encji, do których należy zastosować operację.
	Operator		Obsługiwane operatory: równa się - zastosuj do tego prototypu nie równa się - zastosuj do wszystkich prototypów oprócz tego zawiera - zastosuj, jeśli nazwa prototypu zawiera ten ciąg nie zawiera - zastosuj, jeśli nazwa prototypu nie zawiera tego ciągu pasuje - zastosuj, jeśli nazwa prototypu pasuje do wyrażenia regularnego nie pasuje - zastosuj, jeśli nazwa prototypu nie pasuje do wyrażenia regularnego
	Wzorzec		Wyrażenie regularne lub ciąg znaków do wyszukania.
	Obiekt: Prototyp pozycji
		Utwórz jako włączoną	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu pozycji: Tak - pozycja zostanie dodana w stanie włączonym. Nie - pozycja zostanie dodana do wykrytej encji, ale w stanie wyłączonym.
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu pozycji: Tak - pozycja zostanie dodana. Nie - pozycja nie zostanie dodana.
		Interwał aktualizacji	Po zaznaczeniu pola wyboru pojawią się dwie opcje umożliwiające ustawienie innego interwału dla pozycji: Opóźnienie - interwał aktualizacji pozycji. Obsługiwane są makra użytkownika, makra LLD oraz przyrostki czasu (np. 30s, 1m, 2h, 1d) (obsługa makr LLD przywrócona w Zabbix 7.4.11). Należy ustawić wartość 0, jeśli używany jest Interwał niestandardowy. Interwał niestandardowy - kliknij , aby określić elastyczne interwały lub harmonogramy. Szczegółowe informacje zawiera sekcja Interwały niestandardowe.
		Historia	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające ustawienie innego okresu przechowywania historii dla pozycji: Nie przechowuj - po wybraniu historia nie będzie przechowywana. Przechowuj przez - po wybraniu po prawej stronie pojawi się pole do określenia okresu przechowywania. Obsługiwane są makra użytkownika i makra LLD (obsługa makr LLD przywrócona w Zabbix 7.4.11).
		Trendy	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające ustawienie innego okresu przechowywania trendów dla pozycji: Nie przechowuj - po wybraniu trendy nie będą przechowywane. Przechowuj przez - po wybraniu po prawej stronie pojawi się pole do określenia okresu przechowywania. Obsługiwane są makra użytkownika i makra LLD (obsługa makr LLD przywrócona w Zabbix 7.4.11).
		Znaczniki	Po zaznaczeniu pola wyboru pojawi się nowy blok umożliwiający określenie par znacznik-wartość. Obsługiwane są makra użytkownika i makra LLD. Te znaczniki zostaną dodane do znaczników określonych w prototypie pozycji, nawet jeśli nazwy znaczników są takie same.
	Obiekt: Prototyp wyzwalacza
		Utwórz jako włączony	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu wyzwalacza: Tak - wyzwalacz zostanie dodany w stanie włączonym. Nie - wyzwalacz zostanie dodany do wykrytej encji, ale w stanie wyłączonym.
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu wyzwalacza: Tak - wyzwalacz zostanie dodany. Nie - wyzwalacz nie zostanie dodany.
		Ważność	Po zaznaczeniu pola wyboru pojawią się przyciski ważności wyzwalacza umożliwiające zmianę jego ważności.
		Znaczniki	Po zaznaczeniu pola wyboru pojawi się nowy blok umożliwiający określenie par znacznik-wartość. Obsługiwane są makra użytkownika i makra LLD. Te znaczniki zostaną dodane do znaczników określonych w prototypie wyzwalacza, nawet jeśli nazwy znaczników są takie same.
	Obiekt: Prototyp wykresu
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu wykresu: Tak - wykres zostanie dodany. Nie - wykres nie zostanie dodany.
	Obiekt: Prototyp hosta
		Utwórz jako włączony	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu hosta: Tak - host zostanie utworzony w stanie włączonym. Nie - host zostanie utworzony w stanie wyłączonym.
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu hosta: Tak - host zostanie wykryty. Nie - host nie zostanie wykryty.
		Połącz szablony	Po zaznaczeniu pola wyboru pojawi się pole umożliwiające określenie szablonów. Zacznij wpisywać nazwę szablonu lub kliknij Wybierz obok pola i wybierz szablony z listy w wyskakującym oknie. Szablony z tego nadpisywania zostaną dodane do wszystkich szablonów już połączonych z prototypem hosta.
		Znaczniki	Po zaznaczeniu pola wyboru pojawi się nowy blok umożliwiający określenie par znacznik-wartość. Obsługiwane są makra użytkownika i makra LLD. Te znaczniki zostaną dodane do znaczników określonych w prototypie hosta, nawet jeśli nazwy znaczników są takie same.
		Inwentaryzacja hosta	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające wybranie innego trybu inwentaryzacji dla prototypu hosta: Wyłączona - nie wypełniaj inwentaryzacji hosta Ręczna - wprowadź szczegóły ręcznie Automatyczna - automatycznie wypełniaj dane inwentaryzacji hosta na podstawie zebranych metryk.
	Obiekt: Prototyp reguły wykrywania
		Utwórz jako włączoną	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu reguły wykrywania: Tak - reguła wykrywania zostanie dodana w stanie włączonym. Nie - reguła wykrywania zostanie dodana w stanie wyłączonym.
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające zastąpienie oryginalnych ustawień prototypu reguły wykrywania: Tak - reguła wykrywania zostanie dodana. Nie - reguła wykrywania nie zostanie dodana.
		Interwał aktualizacji	Po zaznaczeniu pola wyboru pojawią się dwie opcje umożliwiające ustawienie innego interwału dla reguły wykrywania: Opóźnienie - interwał aktualizacji reguły. Obsługiwane są makra użytkownika, makra LLD oraz przyrostki czasu (np. 30s, 1m, 2h, 1d). Należy ustawić wartość 0, jeśli używany jest Interwał niestandardowy. Interwał niestandardowy - kliknij , aby określić elastyczne interwały lub harmonogramy. Szczegółowe informacje zawiera sekcja Interwały niestandardowe.

Przyciski formularza

Przyciski znajdujące się u dołu formularza umożliwiają wykonanie kilku operacji.

	Dodaj regułę wykrywania. Ten przycisk jest dostępny tylko dla nowych reguł wykrywania.
	Zaktualizuj właściwości reguły wykrywania. Ten przycisk jest dostępny tylko dla istniejących reguł wykrywania.
	Utwórz inną regułę wykrywania na podstawie właściwości bieżącej reguły wykrywania.
	Wykonaj natychmiast wykrywanie na podstawie reguły wykrywania. Reguła wykrywania musi już istnieć. Zobacz więcej szczegółów. Uwaga: podczas natychmiastowego wykonywania wykrywania pamięć podręczna konfiguracji nie jest aktualizowana, dlatego wynik nie będzie uwzględniał najnowszych zmian w konfiguracji reguły wykrywania.
	Przetestuj konfigurację reguły wykrywania. Użyj tego przycisku, aby zweryfikować ustawienia konfiguracji (takie jak łączność i poprawność parametrów) bez trwałego stosowania jakichkolwiek zmian.
	Usuń regułę wykrywania.
	Anuluj edycję właściwości reguły wykrywania.

Odkryte encje

Poniższe zrzuty ekranu ilustrują, jak odkryte pozycje, wyzwalacze i wykresy wyglądają w konfiguracji hosta. Odkryte encje są poprzedzone pomarańczowym odnośnikiem do reguły wykrywania, z której pochodzą.

Należy pamiętać, że odkryte encje nie zostaną utworzone, jeśli istnieją już encje o tych samych kryteriach unikalności, na przykład pozycja z takim samym kluczem lub wykres o tej samej nazwie. W takim przypadku w frontend jest wyświetlany komunikat o błędzie informujący, że reguła wykrywania niskiego poziomu nie mogła utworzyć niektórych encji. Sama reguła wykrywania nie stanie się jednak nieobsługiwana tylko dlatego, że nie udało się utworzyć jakiejś encji i trzeba było ją pominąć. Reguła wykrywania będzie nadal tworzyć/aktualizować inne encje.

Jeśli odkryta encja (host, system plików, interfejs itp.) przestanie być wykrywana (lub nie przejdzie już filtra), encje utworzone na jej podstawie mogą zostać automatycznie wyłączone, a ostatecznie usunięte.

Utracone zasoby mogą być automatycznie wyłączane na podstawie wartości parametru Disable lost resources. Dotyczy to utraconych hostów, pozycji i wyzwalaczy.

Utracone zasoby mogą być automatycznie usuwane na podstawie wartości parametru Delete lost resources. Dotyczy to utraconych hostów, grup hostów, pozycji, wyzwalaczy i wykresów.

Gdy odkryte encje przechodzą do stanu „Not discovered anymore”, na liście encji wyświetlany jest wskaźnik czasu życia. Po najechaniu na niego kursorem myszy zostanie wyświetlony komunikat zawierający szczegóły statusu.

Jeśli encje zostały oznaczone do usunięcia, ale nie zostały usunięte w oczekiwanym czasie (wyłączona reguła wykrywania lub host pozycji), zostaną usunięte przy następnym przetwarzaniu reguły wykrywania.

Encje zawierające inne encje oznaczone do usunięcia nie będą aktualizowane, jeśli zostaną zmienione na poziomie reguły wykrywania. Na przykład wyzwalacze oparte na LLD nie będą aktualizowane, jeśli zawierają pozycje oznaczone do usunięcia.

Inne typy wykrywania

Więcej szczegółów oraz instrukcje dotyczące innych gotowych typów wykrywania są dostępne w następujących sekcjach:

• wykrywanie interfejsów sieciowych
• wykrywanie procesorów i rdzeni CPU
• wykrywanie OID-ów SNMP
• wykrywanie obiektów JMX;
• wykrywanie przy użyciu zapytań SQL ODBC
• wykrywanie usług Windows
• wykrywanie interfejsów hosta w Zabbix

Więcej szczegółów na temat formatu JSON dla pozycji wykrywania oraz przykład implementacji własnego mechanizmu wykrywania systemu plików jako skryptu Perl można znaleźć w sekcji tworzenie niestandardowych reguł LLD.