5 Makros für Low-Level-Discovery

Übersicht

Es gibt einen Typ von Makro, der innerhalb der Funktion Low-Level-Discovery (LLD) verwendet wird:

{#MACRO}

Es handelt sich um ein Makro, das in einer LLD-Regel verwendet wird und reale Werte des Dateisystemnamens, der Netzwerkschnittstelle, der SNMP-OID usw. zurückgibt.

Diese Makros können verwendet werden, um Entitätsvorlagen zu erstellen (Datenpunkt-, Auslöser-, Diagramm-, Host- und Hostgruppen-Vorlagen). Während der Erkennung realer Dateisysteme, Netzwerkschnittstellen, virtueller Maschinen usw. werden diese Makros durch reale Werte ersetzt und bilden die Grundlage für die Erstellung realer Entitäten.

Einige Low-Level-Discovery-Makros werden in Zabbix mit der LLD-Funktion "vorgepackt" mitgeliefert - {#FSNAME}, {#FSTYPE}, {#IFNAME}, {#SNMPINDEX}, {#SNMPVALUE}. Es ist jedoch nicht zwingend erforderlich, diese Namen zu verwenden, wenn Sie eine benutzerdefinierte Low-Level-Discovery-Regel erstellen. Dann können Sie jeden anderen LLD-Makronamen verwenden und auf diesen Namen verweisen.

Unterstützte Datentypen

Beim Definieren benutzerdefinierter Discovery-Regeln müssen Eigenschaftswerte, die in JSON-Objekten für LLD-Makros zurückgegeben werden, einer der folgenden primitiven Typen sein:

  • string
  • number
  • boolean

Arrays, Objekte und null-Werte werden nicht unterstützt. Jedes LLD-Makro, das auf einen solchen Wert verweist, bleibt unausgewertet und wird bei der Vorverarbeitung und Erstellung von Datenpunkten wörtlich angezeigt (z. B. '{#MY_MACRO}').

Unterstützte Orte

LLD-Makros können verwendet werden:

  • im Filter der Low-Level-Discovery-Regel
  • für Vorlagen von Datenpunkten in
    • Name
    • Schlüsselparameter
    • Einheit
    • Aktualisierungsintervall1
    • Timeout1
    • Speicherzeitraum für Historie1
    • Speicherzeitraum für Trends1
    • Verarbeitungsschritte für die Vorverarbeitung von Datenpunktwerten
    • SNMP OID
    • IPMI-Sensorfeld
    • Ausdruck für berechnete/aggregierte Datenpunkte, in:
      • Ausdruckskonstanten und Funktionsparametern
      • Datenpunkt-Schlüsselparametern
    • Filterbedingungen für aggregierte Datenpunkte (Hostgruppenname und Tag-Name)
    • SSH-Skript und Telnet-Skript
    • SQL-Abfrage für die Datenbanküberwachung
    • Endpunktfeld des JMX-Datenpunkts
    • Beschreibung
    • URL-Feld des HTTP-Agent
    • Feld für HTTP-Abfragefelder des HTTP-Agent
    • Feld für den Anforderungstext des HTTP-Agent
    • Feld für erforderliche Statuscodes des HTTP-Agent
    • Schlüssel und Wert der HTTP-Agent-Headerfelder
    • Feld für den HTTP-Authentifizierungs-Benutzernamen des HTTP-Agent
    • Feld für das HTTP-Authentifizierungs-Passwort des HTTP-Agent
    • Feld für den HTTP-Proxy des HTTP-Agent
    • Feld für die HTTP-SSL-Zertifikatsdatei des HTTP-Agent
    • Feld für die HTTP-SSL-Schlüsseldatei des HTTP-Agent
    • Feld für das HTTP-SSL-Schlüsselpasswort des HTTP-Agent
    • Tags
  • für Vorlagen von Auslösern in
    • Name
    • Betriebsdaten
    • Ausdruck (nur in Konstanten und Funktionsparametern)
    • URL
    • Beschreibung
    • Tags
  • für Vorlagen von Diagrammen in
    • Name
  • für Hostvorlagen in
    • Name
    • sichtbarer Name
    • benutzerdefinierte Schnittstellenfelder: IP, DNS, Port, SNMP-v1/v2-Community, SNMP-v3-Kontextname, SNMP-v3-Sicherheitsname, SNMP-v3-Authentifizierungs-Passphrase, SNMP-v3-Privatsphäre-Passphrase
    • Name der Hostgruppen-Vorlage
    • Wert des Host-Tags
    • Wert des Host-Makros
    • (siehe die vollständige Liste)

An all diesen Stellen, außer im Filter der Low-Level-Discovery-Regel, können LLD-Makros innerhalb eines statischen Benutzer-Makrokontexts verwendet werden.

Verwenden von Makrofunktionen

Makrofunktionen werden mit Low-Level-Discovery-Makros unterstützt (außer im Filter der Low-Level-Discovery-Regel) und ermöglichen es, mithilfe eines regulären Ausdrucks einen bestimmten Teil des Makrowerts zu extrahieren.

Beispielsweise möchten Sie möglicherweise für das Event-Tagging den Kundennamen und die Schnittstellennummer aus dem folgenden LLD-Makro extrahieren:

{#IFALIAS}=customername_1

Dazu kann die Makrofunktion regsub mit dem Makro im Feld für den Event-Tag-Wert eines Auslöserprototyps verwendet werden:

Beachten Sie, dass Kommas in nicht in Anführungszeichen gesetzten Schlüsselparametern von Datenpunkten nicht zulässig sind, daher muss der Parameter, der eine Makrofunktion enthält, in Anführungszeichen gesetzt werden. Das Backslash-Zeichen (\) sollte verwendet werden, um doppelte Anführungszeichen innerhalb des Parameters zu maskieren. Beispiel:

net.if.in["{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}",bytes]

Weitere Informationen zur Syntax von Makrofunktionen finden Sie unter: Makrofunktionen

Makrofunktionen werden in Low-Level-Discovery-Makros seit Zabbix 4.0 unterstützt.

Datenpunkt-Prototypen ohne Schlüsselparameter

Wenn keine Schlüsselparameter für den Datenpunkt-Schlüssel verwendet werden, platzieren Sie das LLD-Makro innerhalb der Parameterklammern [...] des Datenpunkt-Schlüssels, damit es als Parameter behandelt und während der Erkennung ersetzt wird:

v_[{#MACRO}]
Fußnoten

1 In den mit 1 markierten Feldern muss ein einzelnes Makro das gesamte Feld ausfüllen. Mehrere Makros in einem Feld oder mit Text gemischte Makros werden nicht unterstützt.