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 wykrywania niskiego poziomu

Przedstawimy wykrywanie niskiego poziomu 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śl przede wszystkim wbudowaną pozycję lub niestandardowy skrypt używany do pobierania danych wykrywania.
• Przetwarzanie wstępne - zastosuj przetwarzanie wstępne 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 prototypów pozycji, wyzwalaczy, wykresów lub hostów podczas stosowania ich 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 hosta za pośrednictwem szablonu, zawartość tej karty jest tylko do odczytu.

Niestandardowe makra

Karta LLD macros umożliwia określenie niestandardowych makr LLD, gdy zwrócony JSON nie zawiera jeszcze kluczy w formacie {#MACRO}.

Na przykład klucz pozycji agenta vfs.fs.get zwraca dane JSON systemu plików bez żadnych predefiniowanych makr LLD.
Tutaj definiujesz makra ręcznie i mapujesz je na wartości w JSON za pomocą wyrażeń JSONPath:

Reguła wykrywania musi zwracać tablicę JSON w korzeniu ($.).
Ze względu na zgodność wsteczną akceptowany jest również obiekt JSON zawierający pojedynczą tablicę "data". W takim przypadku tablica "data" jest automatycznie rozwijana:

{"data":[{"foo":"bar"}, {"foo":"baz"}]}

Filtr

Filtr może sł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ły 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 za pomocą makra {#FSDRIVETYPE} (np. fixed) (obsługiwane tylko przez Windows agent).

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 jednostek, do których należy zastosować operację.
	Operator		Obsługiwane operatory: jest równy - zastosuj do tego prototypu nie jest równy - zastosuj do wszystkich prototypów oprócz tego zawiera - zastosuj, jeśli nazwa prototypu zawiera ten ciąg znaków nie zawiera - zastosuj, jeśli nazwa prototypu nie zawiera tego ciągu znaków 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 nadpisanie oryginalnych ustawień prototypu pozycji: Tak - pozycja zostanie dodana w stanie włączonym. Nie - pozycja zostanie dodana do wykrytej jednostki, ale w stanie wyłączonym.
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające nadpisanie 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). Należy ustawić wartość 0, jeśli używany jest Interwał niestandardowy. Interwał niestandardowy - kliknij , aby określić elastyczne/harmonogramowe interwały. Szczegółowe informacje zawiera sekcja Interwały niestandardowe.
		Historia	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające ustawienie innych okresów 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.
		Trendy	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające ustawienie innych okresów 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.
		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 nadpisanie oryginalnych ustawień prototypu wyzwalacza: Tak - wyzwalacz zostanie dodany w stanie włączonym. Nie - wyzwalacz zostanie dodany do wykrytej jednostki, ale w stanie wyłączonym.
		Wykrywaj	Po zaznaczeniu pola wyboru pojawią się przyciski umożliwiające nadpisanie 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 nadpisanie 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 nadpisanie 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 nadpisanie 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 nadpisanie 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 nadpisanie 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/harmonogramowe interwały. Szczegółowe informacje zawiera sekcja Interwały niestandardowe.

Przyciski formularza

Przyciski 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 kolejną 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ł bardzo niedawnych 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 zastosowania zmian.
	Usuń regułę wykrywania.
	Anuluj edytowanie 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.