3 Low-level-Discovery

Übersicht

Low-Level-Discovery (LLD) erkennt automatisch Entitäten (z. B. Dateisysteme, Netzwerkschnittstellen) auf einem Host und erstellt die entsprechenden Datenpunkte, Auslöser und Diagramme ohne manuelle Einrichtung für jede einzelne Entität.

Um LLD zu verwenden, erstellen Sie eine Discovery-Regel, die JSON-Daten mit einer Beschreibung der Entitäten sammelt, sowie Prototypen (Datenpunkt, Auslöser und Diagramm) für jede Entität.

Das von der Regel zurückgegebene JSON muss ein Array von Objekten sein, wobei jedes Objekt eine erkannte Entität mithilfe von Schlüssel-Wert-Paaren darstellt. Eine Discovery-Regel mit net.if.discovery könnte beispielsweise Folgendes zurückgeben:

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

Ein entsprechender Satz von Datenpunkten, Auslösern und Diagrammen wird dann aus den Prototypen erstellt - jeweils einer pro Schnittstelle (lo und eth0).

Wenn Objekte Schlüssel im Format {#MACRO} enthalten, werden diese Makros direkt in Prototypen verwendet. Wenn nicht oder wenn zusätzliche/benutzerdefinierte Makros erforderlich sind, können Makros manuell definiert und mithilfe von JSONPath JSON-Feldern zugeordnet werden.

LLD kann auch Hosts erstellen (z. B. für auf einem Hypervisor erkannte virtuelle Maschinen) und unterstützt verschachtelte Discovery-Regeln für mehrstufiges Discovery.

Entitäten, die nicht mehr erkannt werden, können automatisch deaktiviert oder gelöscht werden.

Konfigurieren der Low-Level-Discovery

Wir veranschaulichen die Low-Level-Discovery anhand eines Beispiels für die Erkennung von Dateisystemen.

Gehen Sie zur Konfiguration der Discovery wie folgt vor:

1. Gehen Sie zu Datenerfassung > Vorlagen oder Hosts.
2. Klicken Sie in der Zeile der entsprechenden Vorlage/des entsprechenden Hosts auf Discovery.

3. Klicken Sie oben rechts auf dem Bildschirm auf Discovery-Regel erstellen.
4. Füllen Sie das Formular für die Discovery-Regel mit den erforderlichen Details aus.

Discovery-Regel

Das Formular der Discovery-Regel enthält fünf Registerkarten, die von links nach rechts den Datenfluss während der Discovery darstellen:

• Discovery-Regel – Geben Sie an, welchen integrierten Datenpunkt oder welches benutzerdefinierte Skript Sie zum Abrufen der Discovery-Daten verwenden möchten.
• Vorverarbeitung – Wenden Sie eine Vorverarbeitung auf die ermittelten Daten an.
• LLD-Makros – Ermöglichen Sie das Extrahieren von Makrowerten zur Verwendung in ermittelten Datenpunkten, Auslösern usw.
• Filter – Ermöglichen Sie das Filtern ermittelter Werte.
• Überschreibungen – Ermöglichen Sie die Änderung von Datenpunkten, Auslösern, Diagrammen oder Host-Prototypen, wenn diese auf bestimmte ermittelte Objekte angewendet werden.

Die Registerkarte Discovery-Regel enthält den für die Discovery zu verwendenden Datenpunktschlüssel sowie einige allgemeine Attribute der Discovery-Regel:

Alle Pflichtfelder sind mit einem roten Sternchen gekennzeichnet.

Vorverarbeitung

Auf der Registerkarte Vorverarbeitung können Sie Transformationsregeln definieren, die auf das Ergebnis der Erkennung angewendet werden sollen. In diesem Schritt sind eine oder mehrere Transformationen möglich. Transformationen werden in der Reihenfolge ausgeführt, in der sie definiert wurden. Die gesamte Vorverarbeitung wird vom Zabbix-Server durchgeführt.

Siehe auch:

• Details zur Vorverarbeitung
• Testen der Vorverarbeitung

Beachten Sie, dass der Inhalt dieser Registerkarte schreibgeschützt ist, wenn die Discovery-Regel über eine Vorlage auf den Host angewendet wurde.

Benutzerdefinierte Makros

Auf der Registerkarte LLD-Makros können Sie benutzerdefinierte Makros für die Low-Level-Discovery angeben.

Benutzerdefinierte Makros sind nützlich, wenn das zurückgegebene JSON nicht bereits die erforderlichen Makros enthält. Zum Beispiel:

• Der native Schlüssel vfs.fs.discovery für die Dateisystemerkennung gibt ein JSON mit einigen vordefinierten LLD-Makros wie {#FSNAME} und {#FSTYPE} zurück. Diese Makros können direkt in Datenpunkt- und Auslöser-Prototypen verwendet werden (siehe die folgenden Abschnitte dieser Seite); die Definition benutzerdefinierter Makros ist nicht erforderlich;
• Der Agent-Datenpunkt vfs.fs.get gibt ebenfalls ein JSON mit Dateisystemdaten zurück, jedoch ohne vordefinierte LLD-Makros. In diesem Fall können Sie die Makros selbst definieren und sie mithilfe von JSONPath den Werten im JSON zuordnen:

Die extrahierten Werte können in erkannten Datenpunkten, Auslösern usw. verwendet werden. Beachten Sie, dass Werte aus dem Ergebnis der Discovery und allen bisher durchgeführten Vorverarbeitungsschritten extrahiert werden.

Filter

Ein Filter kann verwendet werden, um reale Datenpunkte, Auslöser und Graphen nur für Entitäten zu generieren, die den Kriterien entsprechen.
Die Registerkarte Filter enthält Filterdefinitionen für Erkennungsregeln, mit denen Sie Erkennungswerte filtern können:

Wenn Sie beispielsweise nur an den Dateisystemen C:, D: und E: interessiert sind, können Sie {#FSNAME} in das Feld Makro und ^C|^D|^E in das Feld Regulärer Ausdruck eingeben.
Eine Filterung ist auch nach Dateisystemtypen mit dem Makro {#FSTYPE} (z. B. ^ext|^reiserfs) und nach Laufwerkstypen (nur vom Windows Agent unterstützt) mit dem Makro {#FSDRIVETYPE} (z. B. fixed) möglich.

Um einen regulären Ausdruck zu testen, können Sie beispielsweise grep -E verwenden:

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

Überschreibungen

Auf der Registerkarte Überschreibungen können Regeln festgelegt werden, um die Liste der Datenpunkt-, Auslöser-, Graph-, Host- und Discovery-Prototypen oder deren Attribute für erkannte Objekte zu ändern, die bestimmte Kriterien erfüllen.

Überschreibungen (falls vorhanden) werden in einer per Drag-and-drop neu anordenbaren Liste angezeigt und in der Reihenfolge ausgeführt, in der sie definiert sind. Um die Details einer neuen Überschreibung zu konfigurieren, klicken Sie im Block Überschreibungen auf . Um eine vorhandene Überschreibung zu bearbeiten, klicken Sie auf den Namen der Überschreibung. Daraufhin wird ein Popup-Fenster geöffnet, in dem Sie die Details der Überschreibungsregel bearbeiten können.

Alle Pflichtparameter sind mit roten Sternchen gekennzeichnet.

Konfigurieren eines Vorgangs

Um die Details eines neuen Vorgangs zu konfigurieren, klicken Sie im Block „Vorgänge“ auf . Um einen vorhandenen Vorgang zu bearbeiten, klicken Sie neben dem Vorgang auf . Daraufhin wird ein Popup-Fenster geöffnet, in dem Sie die Details des Vorgangs bearbeiten können.

Parameter			Beschreibung
Object			Es stehen fünf Objekttypen zur Verfügung: Datenpunkt-Prototyp Auslöser-Prototyp Graph-Prototyp Host-Prototyp Discovery-Prototyp
Condition			Ermöglicht das Filtern der Entitäten, auf die der Vorgang angewendet werden soll.
	Operator		Unterstützte Operatoren: equals – auf diesen Prototyp anwenden does not equal – auf alle Prototypen außer diesen anwenden contains – anwenden, wenn der Prototypname diese Zeichenfolge enthält does not contain – anwenden, wenn der Prototypname diese Zeichenfolge nicht enthält matches – anwenden, wenn der Prototypname dem regulären Ausdruck entspricht does not match – anwenden, wenn der Prototypname nicht dem regulären Ausdruck entspricht
	Pattern		Ein regulärer Ausdruck oder eine zu suchende Zeichenfolge.
	Object: Item prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Datenpunkt-Prototyps überschreiben können: Yes – Der Datenpunkt wird in aktiviertem Zustand hinzugefügt. No – Der Datenpunkt wird der erkannten Entität hinzugefügt, jedoch in deaktiviertem Zustand.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Datenpunkt-Prototyps überschreiben können: Yes – Der Datenpunkt wird hinzugefügt. No – Der Datenpunkt wird nicht hinzugefügt.
		Update interval	Wenn das Kontrollkästchen aktiviert ist, werden zwei Optionen angezeigt, mit denen Sie ein anderes Intervall für den Datenpunkt festlegen können: Delay – Aktualisierungsintervall des Datenpunkts. Benutzermakros, LLD-Makros und Zeitsuffixe (z. B. 30s, 1m, 2h, 1d) werden unterstützt (Unterstützung für LLD-Makros in Zabbix 7.4.11 wiederhergestellt). Muss auf 0 gesetzt werden, wenn Custom interval verwendet wird. Custom interval – Klicken Sie auf , um flexible/geplante Intervalle festzulegen. Weitere Informationen finden Sie unter Benutzerdefinierte Intervalle.
		History	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie eine andere Aufbewahrungsdauer für den Datenpunkt festlegen können: Do not store – Wenn ausgewählt, wird der Verlauf nicht gespeichert. Store up to – Wenn ausgewählt, wird rechts ein Eingabefeld zur Angabe der Aufbewahrungsdauer angezeigt. Benutzermakros und LLD-Makros werden unterstützt (Unterstützung für LLD-Makros in Zabbix 7.4.11 wiederhergestellt).
		Trends	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie eine andere Aufbewahrungsdauer für Trends festlegen können: Do not store – Wenn ausgewählt, werden Trends nicht gespeichert. Store up to – Wenn ausgewählt, wird rechts ein Eingabefeld zur Angabe der Aufbewahrungsdauer angezeigt. Benutzermakros und LLD-Makros werden unterstützt (Unterstützung für LLD-Makros in Zabbix 7.4.11 wiederhergestellt).
		Tags	Wenn das Kontrollkästchen aktiviert ist, wird ein neuer Block angezeigt, in dem Sie Tag-Wert-Paare angeben können. Benutzermakros und LLD-Makros werden unterstützt. Diese Tags werden an die im Datenpunkt-Prototyp angegebenen Tags angehängt, auch wenn die Tagnamen übereinstimmen.
	Object: Trigger prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Auslöser-Prototyps überschreiben können: Yes – Der Auslöser wird in aktiviertem Zustand hinzugefügt. No – Der Auslöser wird der erkannten Entität hinzugefügt, jedoch in deaktiviertem Zustand.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Auslöser-Prototyps überschreiben können: Yes – Der Auslöser wird hinzugefügt. No – Der Auslöser wird nicht hinzugefügt.
		Severity	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen für den Schweregrad des Auslösers angezeigt, mit denen Sie den Schweregrad ändern können.
		Tags	Wenn das Kontrollkästchen aktiviert ist, wird ein neuer Block angezeigt, in dem Sie Tag-Wert-Paare angeben können. Benutzermakros und LLD-Makros werden unterstützt. Diese Tags werden an die im Auslöser-Prototyp angegebenen Tags angehängt, auch wenn die Tagnamen übereinstimmen.
	Object: Graph prototype
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Graph-Prototyps überschreiben können: Yes – Der Graph wird hinzugefügt. No – Der Graph wird nicht hinzugefügt.
	Object: Host prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Host-Prototyps überschreiben können: Yes – Der Host wird in aktiviertem Zustand erstellt. No – Der Host wird in deaktiviertem Zustand erstellt.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Host-Prototyps überschreiben können: Yes – Der Host wird erkannt. No – Der Host wird nicht erkannt.
		Link templates	Wenn das Kontrollkästchen aktiviert ist, wird ein Eingabefeld zur Angabe von Vorlagen angezeigt. Beginnen Sie mit der Eingabe des Vorlagennamens oder klicken Sie neben dem Feld auf Select und wählen Sie Vorlagen aus der Liste im Popup-Fenster aus. Vorlagen aus dieser Überschreibung werden zu allen Vorlagen hinzugefügt, die bereits mit dem Host-Prototyp verknüpft sind.
		Tags	Wenn das Kontrollkästchen aktiviert ist, wird ein neuer Block angezeigt, in dem Sie Tag-Wert-Paare angeben können. Benutzermakros und LLD-Makros werden unterstützt. Diese Tags werden an die im Host-Prototyp angegebenen Tags angehängt, auch wenn die Tagnamen übereinstimmen.
		Host inventory	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie einen anderen Inventar-Modus für den Host-Prototyp auswählen können: Disabled – Hostinventar nicht ausfüllen Manual – Details manuell angeben Automated – Hostinventardaten automatisch anhand der erfassten Metriken ausfüllen.
	Object: Discovery prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Discovery-Prototyps überschreiben können: Yes – Die Discovery-Regel wird in aktiviertem Zustand hinzugefügt. No – Die Discovery-Regel wird in deaktiviertem Zustand hinzugefügt.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Discovery-Prototyps überschreiben können: Yes – Die Discovery-Regel wird hinzugefügt. No – Die Discovery-Regel wird nicht hinzugefügt.
		Update interval	Wenn das Kontrollkästchen aktiviert ist, werden zwei Optionen angezeigt, mit denen Sie ein anderes Intervall für die Discovery-Regel festlegen können: Delay – Aktualisierungsintervall der Regel. Benutzermakros, LLD-Makros und Zeitsuffixe (z. B. 30s, 1m, 2h, 1d) werden unterstützt. Muss auf 0 gesetzt werden, wenn Custom interval verwendet wird. Custom interval – Klicken Sie auf , um flexible/geplante Intervalle festzulegen. Weitere Informationen finden Sie unter Benutzerdefinierte Intervalle.

Schaltflächen des Formulars

Mit den Schaltflächen am unteren Rand des Formulars können Sie mehrere Vorgänge ausführen.

	Eine Erkennungsregel hinzufügen. Diese Schaltfläche ist nur für neue Erkennungsregeln verfügbar.
	Die Eigenschaften einer Erkennungsregel aktualisieren. Diese Schaltfläche ist nur für vorhandene Erkennungsregeln verfügbar.
	Eine weitere Erkennungsregel auf Grundlage der Eigenschaften der aktuellen Erkennungsregel erstellen.
	Die Erkennung sofort auf Grundlage der Erkennungsregel durchführen. Die Erkennungsregel muss bereits vorhanden sein. Weitere Informationen finden Sie hier. Hinweis: Bei einer sofortigen Erkennung wird der Konfigurations-Cache nicht aktualisiert. Daher berücksichtigt das Ergebnis möglicherweise sehr aktuelle Änderungen an der Konfiguration der Erkennungsregel nicht.
	Die Konfiguration der Erkennungsregel testen. Verwenden Sie diese Schaltfläche, um die Konfigurationseinstellungen (z. B. Konnektivität und die Korrektheit der Parameter) zu überprüfen, ohne Änderungen dauerhaft anzuwenden.
	Die Erkennungsregel löschen.
	Die Bearbeitung der Eigenschaften der Erkennungsregel abbrechen.

Erkannte Entitäten

Die folgenden Screenshots veranschaulichen, wie erkannte Datenpunkte, Auslöser und Diagramme in der Konfiguration des Hosts aussehen. Erkannte Entitäten sind mit einem orangefarbenen Link zu der Discovery-Regel versehen, aus der sie stammen.

Beachten Sie, dass erkannte Entitäten nicht erstellt werden, wenn bereits vorhandene Entitäten mit denselben Eindeutigkeitskriterien existieren, zum Beispiel ein Datenpunkt mit demselben Schlüssel oder ein Diagramm mit demselben Namen. In diesem Fall wird im Frontend eine Fehlermeldung angezeigt, dass die Low-Level-Discovery-Regel bestimmte Entitäten nicht erstellen konnte. Die Discovery-Regel selbst wird jedoch nicht auf „nicht unterstützt“ gesetzt, nur weil eine Entität nicht erstellt werden konnte und übersprungen werden musste. Die Discovery-Regel fährt mit dem Erstellen/Aktualisieren anderer Entitäten fort.

Wenn eine erkannte Entität (Host, Dateisystem, Schnittstelle usw.) nicht mehr erkannt wird (oder den Filter nicht mehr erfüllt), können die auf ihrer Grundlage erstellten Entitäten automatisch deaktiviert und schließlich gelöscht werden.

Verlorene Ressourcen können basierend auf dem Wert des Parameters Disable lost resources automatisch deaktiviert werden. Dies betrifft verlorene Hosts, Datenpunkte und Auslöser.

Verlorene Ressourcen können basierend auf dem Wert des Parameters Delete lost resources automatisch gelöscht werden. Dies betrifft verlorene Hosts, Hostgruppen, Datenpunkte, Auslöser und Diagramme.

Wenn erkannte Entitäten den Status „Nicht mehr erkannt“ erhalten, wird in der Entitätenliste ein Lebensdauerindikator angezeigt. Bewegen Sie den Mauszeiger darüber, und es wird eine Meldung mit Details zu ihrem Status angezeigt.

Wenn Entitäten zum Löschen markiert wurden, aber nicht zum erwarteten Zeitpunkt gelöscht wurden (deaktivierte Discovery-Regel oder Datenpunkt-Host), werden sie beim nächsten Verarbeiten der Discovery-Regel gelöscht.

Entitäten, die andere Entitäten enthalten und zum Löschen markiert sind, werden nicht aktualisiert, wenn sie auf Ebene der Discovery-Regel geändert werden. Zum Beispiel werden LLD-basierte Auslöser nicht aktualisiert, wenn sie Datenpunkte enthalten, die zum Löschen markiert sind.

Andere Arten der Discovery

Weitere Details und Anleitungen zu anderen Arten der sofort einsatzbereiten Discovery finden Sie in den folgenden Abschnitten:

• Discovery von Netzwerkschnittstellen
• Discovery von CPUs und CPU-Kernen
• Discovery von SNMP-OIDs
• Discovery von JMX-Objekten;
• Discovery mit ODBC-SQL-Abfragen
• Discovery von Windows-Diensten
• Discovery von Host-Schnittstellen in Zabbix

Weitere Details zum JSON-Format für Discovery-Datenpunkte sowie ein Beispiel dafür, wie Sie Ihren eigenen Dateisystem-Discoverer als Perl-Skript implementieren, finden Sie unter Erstellen benutzerdefinierter LLD-Regeln.