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 Vorlagen (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 Vorlagen erstellt - jeweils einer pro Schnittstelle (lo und eth0).

Wenn Objekte Schlüssel im Format {#MACRO} enthalten, werden diese Makros direkt in Vorlagen verwendet. Falls 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).

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 rule

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

• Discovery rule - legt vor allem den integrierten Datenpunkt oder ein benutzerdefiniertes Skript fest, um Discovery-Daten abzurufen.
• Preprocessing - wendet eine Vorverarbeitung auf die erkannten Daten an.
• LLD macros - ermöglicht das Extrahieren von Makrowerten zur Verwendung in erkannten Datenpunkten, Auslösern usw.
• Filters - ermöglicht das Filtern der erkannten Werte.
• Overrides - ermöglicht das Ändern von Datenpunkten, Auslösern, Diagrammen oder Host-Prototypen beim Anwenden auf bestimmte erkannte Objekte.

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

Alle obligatorischen Eingabefelder sind mit einem roten Sternchen markiert.

Vorverarbeitung

Auf der Registerkarte Vorverarbeitung können Transformationsregeln definiert werden, die auf das Ergebnis der Erkennung angewendet werden. 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 Erkennungsregel über eine Vorlage auf den Host angewendet wurde.

Benutzerdefinierte Makros

Die Registerkarte LLD-Makros ermöglicht es, benutzerdefinierte Low-Level-Discovery-Makros anzugeben.

Benutzerdefinierte Makros sind in Fällen nützlich, in denen das zurückgegebene JSON die erforderlichen Makros noch nicht definiert 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}, {#FSTYPE} zurück.
  Diese Makros können direkt in Datenpunkt-, Auslöser-Prototypen (siehe die folgenden Abschnitte der Seite) verwendet werden; das Definieren benutzerdefinierter Makros ist nicht erforderlich;
• Der vfs.fs.get Agent-Datenpunkt 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 Erkennung und aus allen bisherigen Vorverarbeitungsschritten extrahiert werden.

Filter

Ein Filter kann verwendet werden, um echte Datenpunkte, Auslöser und Diagramme nur für Entitäten zu erzeugen, die die Kriterien erfüllen. Die Registerkarte Filter enthält Definitionen von Erkennungsregel-Filtern, mit denen sich Erkennungswerte filtern lassen:

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 eintragen.
Eine Filterung ist auch nach Dateisystemtypen mithilfe des Makros {#FSTYPE} möglich (z. B. ^ext|^reiserfs) sowie nach Laufwerkstypen (nur vom Windows-Agent unterstützt) mithilfe des Makros {#FSDRIVETYPE} (z. B. fixed).

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

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

Override

Die Registerkarte Overrides ermöglicht das Festlegen von Regeln, um die Liste der Vorlagen für Datenpunkte, Auslöser, Diagramme und Hosts oder deren Attribute für erkannte Objekte zu ändern, die bestimmte Kriterien erfüllen.

Overrides werden, sofern vorhanden, in einer per Drag-and-drop neu anordenbaren Liste angezeigt und in der Reihenfolge ausgeführt, in der sie definiert sind. Um Details eines neuen Overrides zu konfigurieren, klicken Sie im Block Overrides auf . Um einen vorhandenen Override zu bearbeiten, klicken Sie auf den Namen des Overrides. Es wird ein Popup-Fenster geöffnet, in dem Sie die Details der Override-Regel bearbeiten können.

Alle obligatorischen Parameter sind mit roten Sternchen markiert.

Konfigurieren einer Operation

Um Details einer neuen Operation zu konfigurieren, klicken Sie im Block Operations auf . Um eine vorhandene Operation zu bearbeiten, klicken Sie auf neben der Operation. Es wird ein Popup-Fenster geöffnet, in dem Sie die Details der Operation bearbeiten können.

Parameter			Beschreibung
Object			Es stehen vier Objekttypen zur Verfügung: Item prototype Trigger prototype Graph prototype Host prototype
Condition			Ermöglicht das Filtern von Entitäten, auf die die Operation angewendet werden soll.
	Operator		Unterstützte Operatoren: equals - auf diese Vorlage anwenden does not equal - auf alle Vorlagen außer dieser anwenden contains - anwenden, wenn der Vorlagenname diesen String enthält does not contain - anwenden, wenn der Vorlagenname diesen String nicht enthält matches - anwenden, wenn der Vorlagenname dem regulären Ausdruck entspricht does not match - anwenden, wenn der Vorlagenname dem regulären Ausdruck nicht entspricht
	Pattern		Ein regulärer Ausdruck oder ein zu suchender String.
	Object: Item prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Datenpunktvorlage überschrieben werden können: Yes - der Datenpunkt wird im aktivierten Zustand hinzugefügt. No - der Datenpunkt wird einer erkannten Entität hinzugefügt, jedoch im deaktivierten Zustand.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Datenpunktvorlage überschrieben werden 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 ein anderes Intervall für den Datenpunkt festgelegt werden kann: Delay - Aktualisierungsintervall des Datenpunkts. Benutzermakros, LLD-Makros und Zeitsuffixe (z. B. 30s, 1m, 2h, 1d) werden unterstützt (LLD-Makro-Unterstützung in Zabbix 7.0.27 wiederhergestellt). Sollte auf 0 gesetzt werden, wenn Custom interval verwendet wird. Custom interval - klicken Sie auf , um flexible/geplante Intervalle anzugeben. Weitere Informationen finden Sie unter Custom intervals.
		History	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen ein anderer Aufbewahrungszeitraum für die Historie des Datenpunkts festgelegt werden kann: Do not store - wenn ausgewählt, wird die Historie nicht gespeichert. Store up to - wenn ausgewählt, wird rechts ein Eingabefeld zur Angabe des Aufbewahrungszeitraums angezeigt. Benutzermakros und LLD-Makros werden unterstützt (LLD-Makro-Unterstützung in Zabbix 7.0.27 wiederhergestellt).
		Trends	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen ein anderer Aufbewahrungszeitraum für Trends des Datenpunkts festgelegt werden kann: Do not store - wenn ausgewählt, werden die Trends nicht gespeichert. Store up to - wenn ausgewählt, wird rechts ein Eingabefeld zur Angabe des Aufbewahrungszeitraums angezeigt. Benutzermakros und LLD-Makros werden unterstützt (LLD-Makro-Unterstützung in Zabbix 7.0.27 wiederhergestellt).
		Tags	Wenn das Kontrollkästchen aktiviert ist, wird ein neuer Block angezeigt, in dem Tag-Wert-Paare angegeben werden können. Benutzermakros und LLD-Makros werden unterstützt. Diese Tags werden den in der Datenpunktvorlage angegebenen Tags angehängt, auch wenn die Tag-Namen übereinstimmen.
	Object: Trigger prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Auslöservorlage überschrieben werden können: Yes - der Auslöser wird im aktivierten Zustand hinzugefügt. No - der Auslöser wird einer erkannten Entität hinzugefügt, jedoch im deaktivierten Zustand.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Auslöservorlage überschrieben werden 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 die Auslöser-Schweregrade angezeigt, mit denen der Schweregrad des Auslösers geändert werden kann.
		Tags	Wenn das Kontrollkästchen aktiviert ist, wird ein neuer Block angezeigt, in dem Tag-Wert-Paare angegeben werden können. Benutzermakros und LLD-Makros werden unterstützt. Diese Tags werden den in der Auslöservorlage angegebenen Tags angehängt, auch wenn die Tag-Namen übereinstimmen.
	Object: Graph prototype
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Diagrammvorlage überschrieben werden können: Yes - das Diagramm wird hinzugefügt. No - das Diagramm wird nicht hinzugefügt.
	Object: Host prototype
		Create enabled	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Hostvorlage überschrieben werden können: Yes - der Host wird im aktivierten Zustand erstellt. No - der Host wird im deaktivierten Zustand erstellt.
		Discover	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen die ursprünglichen Einstellungen der Hostvorlage überschrieben werden 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 auf Select neben dem Feld und wählen Sie Vorlagen aus der Liste im Popup-Fenster aus. Vorlagen aus diesem Override werden allen bereits mit der Hostvorlage verknüpften Vorlagen hinzugefügt.
		Tags	Wenn das Kontrollkästchen aktiviert ist, wird ein neuer Block angezeigt, in dem Tag-Wert-Paare angegeben werden können. Benutzermakros und LLD-Makros werden unterstützt. Diese Tags werden den in der Hostvorlage angegebenen Tags angehängt, auch wenn die Tag-Namen übereinstimmen.
		Host inventory	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen ein anderer Modus für das Host-Inventar der Hostvorlage ausgewählt werden kann: Disabled - Host-Inventar nicht befüllen Manual - Details manuell angeben Automated - Host-Inventardaten basierend auf den erfassten Metriken automatisch ausfüllen.

Formularschaltflächen

Mit den Schaltflächen am unteren Rand des Formulars können mehrere Operationen ausgeführt werden.

	Eine Discovery-Regel hinzufügen. Diese Schaltfläche ist nur für neue Discovery-Regeln verfügbar.
	Die Eigenschaften einer Discovery-Regel aktualisieren. Diese Schaltfläche ist nur für vorhandene Discovery-Regeln verfügbar.
	Eine weitere Discovery-Regel auf Grundlage der Eigenschaften der aktuellen Discovery-Regel erstellen.
	Die Discovery sofort auf Grundlage der Discovery-Regel ausführen. Die Discovery-Regel muss bereits vorhanden sein. Siehe weitere Details. Hinweis: Wenn die Discovery sofort ausgeführt wird, wird der Konfigurations-Cache nicht aktualisiert; daher spiegelt das Ergebnis keine sehr aktuellen Änderungen an der Konfiguration der Discovery-Regel wider.
	Die Konfiguration der Discovery-Regel testen. Verwenden Sie diese Schaltfläche, um die Konfigurationseinstellungen (z. B. Konnektivität und Korrektheit der Parameter) zu überprüfen, ohne Änderungen dauerhaft anzuwenden.
	Die Discovery-Regel löschen.
	Die Bearbeitung der Eigenschaften der Discovery-Regel 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.