Low-level-Erkennung

Ü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 Erkennungsregel, 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. Beispielsweise kann eine Erkennungsregel mit net.if.discovery 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 Erkennungsregeln für mehrstufige Erkennung.

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 wie folgt vor, um die Discovery zu konfigurieren:

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 für Discovery-Regeln enthält fünf Registerkarten, die von links nach rechts den Datenfluss während der Discovery darstellen:

• Discovery-Regel – Geben Sie hier vor allem den integrierten Datenpunkt oder das benutzerdefinierte Skript an, mit dem die Discovery-Daten abgerufen werden.
• 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, Graphen oder Host-Prototypen bei der Anwendung auf bestimmte ermittelte Objekte.

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 Erkennungsregel über eine Vorlage auf den Host angewendet wurde.

Benutzerdefinierte Makros

Auf der Registerkarte LLD-Makros können Sie benutzerdefinierte LLD-Makros angeben, wenn das zurückgegebene JSON noch keine Schlüssel im Format {#MACRO} enthält.

Beispielsweise gibt der Agent-Datenpunkt-Schlüssel vfs.fs.get JSON-Dateisystemdaten ohne vordefinierte LLD-Makros zurück.
Hier definieren Sie die Makros manuell und ordnen sie mithilfe von JSONPath-Ausdrücken Werten im JSON zu:

Die Erkennungsregel muss ein JSON-Array auf der Wurzelebene ($.) zurückgeben.
Aus Gründen der Abwärtskompatibilität wird auch ein JSON-Objekt akzeptiert, das ein einzelnes "data"-Array enthält. In diesem Fall wird das "data"-Array automatisch entpackt:

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

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 Discovery-Regeln, mit denen Sie Discovery-Werte 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 nach Dateisystemtypen ist ebenfalls 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 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 sortierbaren 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 einer Operation

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

Parameter			Beschreibung
Objekt			Fünf Objekttypen sind verfügbar: Datenpunkt-Prototyp Auslöser-Prototyp Graph-Prototyp Host-Prototyp Discovery-Prototyp
Bedingung			Ermöglicht das Filtern der Entitäten, auf die die Operation angewendet werden soll.
	Operator		Unterstützte Operatoren: ist gleich – auf diesen Prototyp anwenden ist nicht gleich – auf alle Prototypen außer diesen anwenden enthält – anwenden, wenn der Prototypname diese Zeichenfolge enthält enthält nicht – anwenden, wenn der Prototypname diese Zeichenfolge nicht enthält entspricht – anwenden, wenn der Prototypname dem regulären Ausdruck entspricht entspricht nicht – anwenden, wenn der Prototypname nicht dem regulären Ausdruck entspricht
	Muster		Ein regulärer Ausdruck oder eine zu suchende Zeichenfolge.
	Objekt: Datenpunkt-Prototyp
		Aktiviert erstellen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Datenpunkt-Prototyps überschreiben können: Ja – der Datenpunkt wird in aktiviertem Zustand hinzugefügt. Nein – der Datenpunkt wird einer erkannten Entität hinzugefügt, jedoch in deaktiviertem Zustand.
		Erkennen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Datenpunkt-Prototyps überschreiben können: Ja – der Datenpunkt wird hinzugefügt. Nein – der Datenpunkt wird nicht hinzugefügt.
		Aktualisierungsintervall	Wenn das Kontrollkästchen aktiviert ist, werden zwei Optionen angezeigt, mit denen Sie ein anderes Intervall für den Datenpunkt festlegen können: Verzögerung – Aktualisierungsintervall des Datenpunkts. Benutzermakros, LLD-Makros und Zeitsuffixe (z. B. 30s, 1m, 2h, 1d) werden unterstützt. Muss auf 0 gesetzt werden, wenn Benutzerdefiniertes Intervall verwendet wird. Benutzerdefiniertes Intervall – klicken Sie auf , um flexible/geplante Intervalle festzulegen. Weitere Informationen finden Sie unter Benutzerdefinierte Intervalle.
		Historie	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie unterschiedliche Speicherzeiträume für die Historie des Datenpunkts festlegen können: Nicht speichern – wenn ausgewählt, wird die Historie nicht gespeichert. Speichern bis – wenn ausgewählt, wird rechts ein Eingabefeld zur Angabe des Speicherzeitraums angezeigt. Benutzermakros und LLD-Makros werden unterstützt.
		Trends	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie unterschiedliche Speicherzeiträume für die Trends des Datenpunkts festlegen können: Nicht speichern – wenn ausgewählt, werden die Trends nicht gespeichert. Speichern bis – wenn ausgewählt, wird rechts ein Eingabefeld zur Angabe des Speicherzeitraums angezeigt. Benutzermakros und LLD-Makros werden unterstützt.
		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.
	Objekt: Auslöser-Prototyp
		Aktiviert erstellen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Auslöser-Prototyps überschreiben können: Ja – der Auslöser wird in aktiviertem Zustand hinzugefügt. Nein – der Auslöser wird einer erkannten Entität hinzugefügt, jedoch in deaktiviertem Zustand.
		Erkennen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Auslöser-Prototyps überschreiben können: Ja – der Auslöser wird hinzugefügt. Nein – der Auslöser wird nicht hinzugefügt.
		Schweregrad	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen für den Schweregrad des Auslösers angezeigt, mit denen Sie den Schweregrad des Auslösers ä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.
	Objekt: Graph-Prototyp
		Erkennen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Graph-Prototyps überschreiben können: Ja – der Graph wird hinzugefügt. Nein – der Graph wird nicht hinzugefügt.
	Objekt: Host-Prototyp
		Aktiviert erstellen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Host-Prototyps überschreiben können: Ja – der Host wird in aktiviertem Zustand erstellt. Nein – der Host wird in deaktiviertem Zustand erstellt.
		Erkennen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Host-Prototyps überschreiben können: Ja – der Host wird erkannt. Nein – der Host wird nicht erkannt.
		Vorlagen verknüpfen	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 Auswählen und wählen Sie Vorlagen aus der Liste in einem Popup-Fenster aus. Vorlagen aus dieser Überschreibung werden zu allen bereits mit dem Host-Prototyp verknüpften Vorlagen hinzugefügt.
		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.
		Hostinventar	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie einen anderen Modus für das Hostinventar des Host-Prototyps auswählen können: Deaktiviert – Hostinventar nicht ausfüllen Manuell – Details manuell angeben Automatisiert – Hostinventardaten automatisch anhand der erfassten Metriken ausfüllen.
	Objekt: Discovery-Prototyp
		Aktiviert erstellen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Discovery-Prototyps überschreiben können: Ja – die Discovery-Regel wird in aktiviertem Zustand hinzugefügt. Nein – die Discovery-Regel wird in deaktiviertem Zustand hinzugefügt.
		Erkennen	Wenn das Kontrollkästchen aktiviert ist, werden Schaltflächen angezeigt, mit denen Sie die ursprünglichen Einstellungen des Discovery-Prototyps überschreiben können: Ja – die Discovery-Regel wird hinzugefügt. Nein – die Discovery-Regel wird nicht hinzugefügt.
		Aktualisierungsintervall	Wenn das Kontrollkästchen aktiviert ist, werden zwei Optionen angezeigt, mit denen Sie ein anderes Intervall für die Discovery-Regel festlegen können: Verzögerung – Aktualisierungsintervall der Regel. Benutzermakros, LLD-Makros und Zeitsuffixe (z. B. 30s, 1m, 2h, 1d) werden unterstützt. Muss auf 0 gesetzt werden, wenn Benutzerdefiniertes Intervall verwendet wird. Benutzerdefiniertes Intervall – klicken Sie auf , um flexible/geplante Intervalle festzulegen. Weitere Informationen finden Sie unter Benutzerdefinierte Intervalle.

Formularschaltflächen

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

	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 basierend auf den Eigenschaften der aktuellen Discovery-Regel erstellen.
	Die Discovery basierend auf der Discovery-Regel sofort durchführen. Die Discovery-Regel muss bereits vorhanden sein. Weitere Informationen finden Sie hier. Hinweis: Bei einer sofortigen Discovery wird der Konfigurations-Cache nicht aktualisiert. Daher spiegelt das Ergebnis sehr aktuelle Änderungen an der Konfiguration der Discovery-Regel möglicherweise nicht 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.