LLD-Regelobjekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der discoveryrule API.

LLD-Regel

Das LLD-Regelobjekt verfügt über die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
itemid ID ID der LLD-Regel.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
delay string Aktualisierungsintervall der LLD-Regel.

Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300), einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m, 2h, 1d) oder optional ein oder mehrere benutzerdefinierte Intervalle, jeweils durch Semikolons getrennt. Benutzerdefinierte Intervalle können eine Kombination aus flexiblen Intervallen und Zeitplanintervallen sein.

Akzeptiert Benutzermakros. Bei Verwendung muss der Wert aus einem einzelnen Makro bestehen. Mehrere Makros oder Makros in Kombination mit Text werden nicht unterstützt. Flexible Intervalle können als zwei durch einen Schrägstrich getrennte Makros angegeben werden (z. B. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Beispiel:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „Zabbix agent“ (0), „Simple check“ (3), „Zabbix internal“ (5), „External check“ (10), „Database monitor“ (11), „IPMI agent“ (12), „SSH agent“ (13), „TELNET agent“ (14), „JMX agent“ (16), „HTTP agent“ (19), „SNMP agent“ (20), „Script“ (21) oder „Browser“ (22) gesetzt ist oder wenn type auf „Zabbix agent (active)“ (7) gesetzt ist und key_ nicht „mqtt.get“ enthält
hostid ID ID des Hosts, zu dem die LLD-Regel gehört.

Verhalten der Eigenschaft:
- konstant
- erforderlich für Erstellungsvorgänge
flags integer Ursprung der Discovery-Regel.

Mögliche Werte:
1 - eine LLD-Regel;
5 - eine aus einem Prototyp konvertierte LLD-Regel.

Verhalten der Eigenschaft:
- schreibgeschützt
interfaceid ID ID der Host-Schnittstelle der LLD-Regel.

Verhalten der Eigenschaft:
- erforderlich, wenn die LLD-Regel zu einem Host gehört und type auf „Zabbix agent“, „IPMI agent“, „JMX agent“ oder „SNMP agent“ gesetzt ist
- unterstützt, wenn die LLD-Regel zu einem Host gehört und type auf „Simple check“, „External check“, „SSH agent“, „TELNET agent“ oder „HTTP agent“ gesetzt ist
key_ string Schlüssel der LLD-Regel.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte Objekte
name string Name der LLD-Regel.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte Objekte
type integer Typ der LLD-Regel.

Mögliche Werte:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - Simple check;
5 - Zabbix internal;
7 - Zabbix agent (active);
10 - External check;
11 - Database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
16 - JMX agent;
18 - Dependent item;
19 - HTTP agent;
20 - SNMP agent;
21 - Script;
22 - Browser;
23 - Nested. Dieser Typ ist nur zulässig, wenn das übergeordnete Element der Regel eine Vorlage (die bei der Discovery mit einem Host-Prototyp verknüpft sein soll) oder ein entdeckter Host ist (der eine LLD-Regel an seiner Wurzel besitzt).

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte Objekte
url string URL-Zeichenfolge.
Unterstützt Benutzermakros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
allow_traps integer Erlaubt das Befüllen des Werts ähnlich wie beim Trapper-Datenpunkt.

Mögliche Werte:
0 - (Standard) Empfang eingehender Daten nicht zulassen;
1 - Empfang eingehender Daten zulassen.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
authtype integer Authentifizierungsmethode.

Mögliche Werte, wenn type auf „SSH agent“ gesetzt ist:
0 - (Standard) Passwort;
1 - öffentlicher Schlüssel.

Mögliche Werte, wenn type auf „HTTP agent“ gesetzt ist:
0 - (Standard) keine;
1 - Basic;
2 - NTLM;
3 - Kerberos;
4 - Digest.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „SSH agent“ oder „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte (wenn type auf „HTTP agent“ gesetzt ist)
description string Beschreibung der LLD-Regel.
error string Fehlertext, wenn beim Aktualisieren des Werts der LLD-Regel Probleme auftreten.

Verhalten der Eigenschaft:
- schreibgeschützt
follow_redirects integer Antwortweiterleitungen beim Abrufen von Daten verfolgen.

Mögliche Werte:
0 - Weiterleitungen nicht verfolgen;
1 - (Standard) Weiterleitungen verfolgen.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
headers array Array von Headern, die beim Ausführen einer HTTP-Anfrage gesendet werden.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
http_proxy string HTTP(S)-Proxy-Verbindungszeichenfolge.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
ipmi_sensor string IPMI-Sensor.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „IPMI agent“ gesetzt ist und key_ nicht auf „ipmi.get“ gesetzt ist
- unterstützt, wenn type auf „IPMI agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
jmx_endpoint string Benutzerdefinierte Verbindungszeichenfolge des JMX agent.

Standard: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „JMX agent“ gesetzt ist
lifetime string Zeitraum, nach dem Datenpunkte gelöscht werden, die nicht mehr entdeckt werden. Akzeptiert eine Anzahl von Sekunden (z. B. 3600), einen Wert mit einem Zeit-Suffix (z. B. 3600s, 180m, 24h, 1d) oder ein Benutzermakro.

Standard: 7d.
lifetime_type integer Szenario zum Löschen verlorener LLD-Ressourcen.

Mögliche Werte:
0 - (Standard) Löschen nach Erreichen des Lifetime-Schwellenwerts;
1 - Nicht löschen;
2 - Sofort löschen.
enabled_lifetime string Zeitraum, nach dem Datenpunkte deaktiviert werden, die nicht mehr entdeckt werden. Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300), einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m, 2h, 1d) oder ein Benutzermakro.

Standard: 0.
enabled_lifetime_type integer Szenario zum Deaktivieren verlorener LLD-Ressourcen.

Mögliche Werte:
0 - Deaktivieren nach Erreichen des Lifetime-Schwellenwerts;
1 - Nicht deaktivieren;
2 - (Standard) Sofort deaktivieren.
master_itemid ID ID des Master-Datenpunkts.
Eine Discovery-Regel kann kein Master-Datenpunkt für eine andere Discovery-Regel sein.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „Dependent item“ gesetzt ist
- schreibgeschützt für geerbte Objekte
output_format integer Gibt an, ob die Antwort in JSON konvertiert werden soll.

Mögliche Werte:
0 - (Standard) Rohdaten speichern;
1 - In JSON konvertieren.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
params string Zusätzliche Parameter abhängig vom Typ der LLD-Regel:
- ausgeführtes Skript für SSH- und Telnet-LLD-Regeln;
- SQL-Abfrage für LLD-Regeln des Typs „Database monitor“;
- Formel für berechnete LLD-Regeln;
- Skript für LLD-Regeln des Typs „Script“ und „Browser“.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „Database monitor“, „SSH agent“, „TELNET agent“, „Script“ oder „Browser“ gesetzt ist
- schreibgeschützt für geerbte Objekte (wenn type auf „Script“ oder „Browser“ gesetzt ist)
parameters object/array Zusätzliche Parameter, wenn type auf „Script“ oder „Browser“ gesetzt ist.
Array von Objekten mit den Eigenschaften name und value, wobei name eindeutig sein muss.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „Script“ oder „Browser“ gesetzt ist
- schreibgeschützt für geerbte Objekte
password string Passwort für die Authentifizierung.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „JMX agent“ gesetzt und username angegeben ist
- unterstützt, wenn type auf „Simple check“, „Database monitor“, „SSH agent“, „TELNET agent“ oder „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte (wenn type auf „HTTP agent“ gesetzt ist)
post_type integer Typ des im Attribut posts gespeicherten POST-Datenkörpers.

Mögliche Werte:
0 - (Standard) Rohdaten;
2 - JSON-Daten;
3 - XML-Daten.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
posts string Daten des HTTP(S)-Anfragekörpers.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „HTTP agent“ und post_type auf „JSON data“ oder „XML data“ gesetzt ist
- unterstützt, wenn type auf „HTTP agent“ und post_type auf „Raw data“ gesetzt ist
- schreibgeschützt für geerbte Objekte
privatekey string Name der Datei mit dem privaten Schlüssel.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „SSH agent“ und authtype auf „public key“ gesetzt ist
publickey string Name der Datei mit dem öffentlichen Schlüssel.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „SSH agent“ und authtype auf „public key“ gesetzt ist
query_fields array Array von Abfragefeldern, die beim Ausführen einer HTTP-Anfrage gesendet werden.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
request_method integer Typ der Anfragemethode.

Mögliche Werte:
0 - (Standard) GET;
1 - POST;
2 - PUT;
3 - HEAD.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
retrieve_mode integer Gibt an, welcher Teil der Antwort gespeichert werden soll.

Mögliche Werte, wenn request_method auf „GET“, „POST“ oder „PUT“ gesetzt ist:
0 - (Standard) Body;
1 - Header;
2 - Body und Header werden gespeichert.

Mögliche Werte, wenn request_method auf „HEAD“ gesetzt ist:
1 - Header.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
snmp_oid string SNMP-OID.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „SNMP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
ssl_cert_file string Dateipfad des öffentlichen SSL-Schlüssels.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
ssl_key_file string Dateipfad des privaten SSL-Schlüssels.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
ssl_key_password string Passwort für die SSL-Schlüsseldatei.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
state integer Status der LLD-Regel.

Mögliche Werte:
0 - (Standard) normal;
1 - nicht unterstützt.

Verhalten der Eigenschaft:
- schreibgeschützt
status integer Status der LLD-Regel.

Mögliche Werte:
0 - (Standard) aktivierte LLD-Regel;
1 - deaktivierte LLD-Regel.
status_codes string Durch Kommas getrennte Bereiche erforderlicher HTTP-Statuscodes. Unterstützt außerdem Benutzermakros als Teil einer durch Kommas getrennten Liste.

Beispiel: 200,200-{$M},{$M},200-400

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
templateid ID ID der übergeordneten LLD-Regel der Vorlage.

Verhalten der Eigenschaft:
- schreibgeschützt
timeout string Zeitüberschreitung für die Abfrage von Datenpunkten.
Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300) oder einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m). Akzeptiert außerdem Benutzermakros.

Möglicher Wertebereich: 1-600s.

Standard: "" - Proxy-/globale Einstellungen verwenden.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „Zabbix agent“ (0), „Simple check“ (3) gesetzt ist und key_ nicht mit „vmware.“ und „icmpping“ beginnt, „Zabbix agent (active)“ (7), „External check“ (10), „Database monitor“ (11), „SSH agent“ (13), „TELNET agent“ (14), „HTTP agent“ (19), „SNMP agent“ (20) und snmp_oid mit „walk[“ oder „get[“ beginnt, „Script“ (21), „Browser“ (22)
- schreibgeschützt für geerbte Objekte
trapper_hosts string Zulässige Hosts.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „Zabbix trapper“ gesetzt ist oder wenn type auf „HTTP agent“ und allow_traps auf „Allow to accept incoming data“ gesetzt ist.
Wenn die Eigenschaft nicht angegeben wird, wird sie automatisch auf das Benutzermakro {$TRAPPER.ALLOWED_HOSTS} (Standardwert) gesetzt. Standardmäßig lautet {$TRAPPER.ALLOWED_HOSTS} 127.0.0.1,::1.
Wenn die Eigenschaft auf eine leere Zeichenfolge gesetzt ist, werden eingehende Verbindungen von allen Hosts abgelehnt.
username string Benutzername für die Authentifizierung.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „SSH agent“ oder „TELNET agent“ gesetzt ist oder wenn type auf „JMX agent“ und password gesetzt ist
- unterstützt, wenn type auf „Simple check“, „Database monitor“ oder „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte (wenn type auf „HTTP agent“ gesetzt ist)
uuid string Universell eindeutiger Bezeichner, der zum Verknüpfen importierter LLD-Regeln mit bereits vorhandenen Regeln verwendet wird. Wird automatisch generiert, wenn er nicht angegeben wird.

Verhalten der Eigenschaft:
- unterstützt, wenn die LLD-Regel zu einer Vorlage gehört
verify_host integer Gibt an, ob überprüft werden soll, dass der Hostname der Verbindung mit dem Hostnamen im Zertifikat des Hosts übereinstimmt.

Mögliche Werte:
0 - (Standard) Nicht überprüfen;
1 - Überprüfen.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte
verify_peer integer Gibt an, ob überprüft werden soll, dass das Zertifikat des Hosts authentisch ist.

Mögliche Werte:
0 - (Standard) Nicht überprüfen;
1 - Überprüfen.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf „HTTP agent“ gesetzt ist
- schreibgeschützt für geerbte Objekte

HTTP-Header

Das Header-Objekt hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
name string Name des HTTP-Headers.

Eigenschaftsverhalten:
- erforderlich
value string Wert des Headers.

Eigenschaftsverhalten:
- erforderlich

HTTP-Abfragefeld

Das Abfragefeldobjekt definiert einen Namen und einen Wert, die zur Angabe eines URL-Parameters verwendet werden. Es hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
name string Name des Parameters.

Eigenschaftsverhalten:
- erforderlich
value string Wert des Parameters.

Eigenschaftsverhalten:
- erforderlich

LLD-Regelfilter

Das LLD-Regelfilterobjekt definiert eine Reihe von Bedingungen, die zum Filtern erkannter Objekte verwendet werden können. Es hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
conditions object/array Menge von Filterbedingungen, die zum Filtern der Ergebnisse verwendet werden. Die Bedingungen werden in der Reihenfolge ihrer Platzierung in der Formel sortiert.

Eigenschaftsverhalten:
- erforderlich
evaltype integer Auswertungsmethode der Filterbedingung.

Mögliche Werte:
0 - Und/Oder;
1 - Und;
2 - Oder;
3 - Benutzerdefinierter Ausdruck.

Eigenschaftsverhalten:
- erforderlich
eval_formula string Generierter Ausdruck, der zur Auswertung von Filterbedingungen verwendet wird. Der Ausdruck enthält IDs, die über formulaid auf bestimmte Filterbedingungen verweisen. Der Wert von eval_formula entspricht dem Wert von formula bei Filtern mit einem benutzerdefinierten Ausdruck.

Eigenschaftsverhalten:
- schreibgeschützt
formula string Benutzerdefinierter Ausdruck zur Auswertung von Bedingungen von Filtern mit einem benutzerdefinierten Ausdruck. Der Ausdruck muss IDs enthalten, die über formulaid auf bestimmte Filterbedingungen verweisen. Die im Ausdruck verwendeten IDs müssen exakt mit den in den Filterbedingungen definierten IDs übereinstimmen: Keine Bedingung darf ungenutzt bleiben oder ausgelassen werden.

Eigenschaftsverhalten:
- erforderlich, wenn evaltype auf „custom expression“ gesetzt ist

Filterbedingung für LLD-Regeln

Das Objekt für die Filterbedingung einer LLD-Regel definiert eine separate Prüfung, die für den Wert eines LLD-Makros durchgeführt wird. Es hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
macro string LLD-Makro, für das die Prüfung durchgeführt wird.

Property behavior:
- required
value string Wert, mit dem verglichen werden soll.

Property behavior:
- required if operator is set to "matches regular expression" or "does not match regular expression"
formulaid string Beliebige eindeutige ID, die verwendet wird, um aus einem benutzerdefinierten Ausdruck auf die Bedingung zu verweisen. Darf nur Großbuchstaben enthalten. Die ID muss vom Benutzer definiert werden, wenn Filterbedingungen geändert werden, wird jedoch bei einer späteren Abfrage erneut generiert.

Property behavior:
- required if evaltype of LLD rule filter object is set to "custom expression"
operator integer Bedingungsoperator.

Mögliche Werte:
8 - (Standard) entspricht regulärem Ausdruck;
9 - entspricht nicht regulärem Ausdruck;
12 - existiert;
13 - existiert nicht.

Um besser zu verstehen, wie Filter mit verschiedenen Ausdruckstypen verwendet werden, siehe die Beispiele auf den Methodenseiten discoveryrule.get und discoveryrule.create.

LLD-Makropfad

Der LLD-Makropfad hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
lld_macro string LLD-Makro.

Verhalten der Eigenschaft:
- erforderlich
path string Selektor für den Wert, der dem entsprechenden Makro zugewiesen wird.

Verhalten der Eigenschaft:
- erforderlich

Vorverarbeitung der LLD-Regel

Das Vorverarbeitungsobjekt der LLD-Regel verfügt über die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
type integer Der Typ der Vorverarbeitungsoption.

Mögliche Werte:
5 - Regulärer Ausdruck;
11 - XML XPath;
12 - JSONPath;
14 - Entspricht regulärem Ausdruck;
15 - Entspricht nicht regulärem Ausdruck;
16 - Auf Fehler in JSON prüfen;
17 - Auf Fehler in XML prüfen;
20 - Unveränderte Werte mit Heartbeat verwerfen;
21 - JavaScript;
23 - Prometheus in JSON;
24 - CSV in JSON;
25 - Ersetzen;
27 - XML in JSON;
28 - SNMP-Walk-Wert;
29 - SNMP-Walk in JSON;
30 - SNMP-Get-Wert.

Verhalten der Eigenschaft:
- erforderlich
params string Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden. Mehrere Parameter werden durch das Newline-Zeichen (\n) getrennt.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „Regulärer Ausdruck“ (5), „XML XPath“ (11), „JSONPath“ (12), „Entspricht regulärem Ausdruck“ (14), „Entspricht nicht regulärem Ausdruck“ (15), „Auf Fehler in JSON prüfen“ (16), „Auf Fehler in XML prüfen“ (17), „Unveränderte Werte mit Heartbeat verwerfen“ (20), „JavaScript“ (21), „Prometheus in JSON“ (23), „CSV in JSON“ (24), „Ersetzen“ (25), „SNMP-Walk-Wert“ (28), „SNMP-Walk in JSON“ (29) oder „SNMP-Get-Wert“ (30) gesetzt ist
error_handler integer Aktionstyp, der bei einem Fehler in einem Vorverarbeitungsschritt verwendet wird.

Mögliche Werte:
0 - Fehlermeldung wird vom Zabbix Server festgelegt;
1 - Wert verwerfen;
2 - Benutzerdefinierten Wert festlegen;
3 - Benutzerdefinierte Fehlermeldung festlegen.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf „Regulärer Ausdruck“ (5), „XML XPath“ (11), „JSONPath“ (12), „Entspricht regulärem Ausdruck“ (14), „Entspricht nicht regulärem Ausdruck“ (15), „Auf Fehler in JSON prüfen“ (16), „Auf Fehler in XML prüfen“ (17), „Prometheus in JSON“ (23), „CSV in JSON“ (24), „XML in JSON“ (27), „SNMP-Walk-Wert“ (28), „SNMP-Walk in JSON“ (29) oder „SNMP-Get-Wert“ (30) gesetzt ist
error_handler_params string Parameter des Fehlerhandlers.

Verhalten der Eigenschaft:
- erforderlich, wenn error_handler auf „Benutzerdefinierten Wert festlegen“ oder „Benutzerdefinierte Fehlermeldung festlegen“ gesetzt ist

Die folgenden Parameter und Fehlerhandler werden für jeden Vorverarbeitungstyp unterstützt.

Vorverarbeitungstyp Name Parameter 1 Parameter 2 Parameter 3 Unterstützte Fehlerhandler
5 Regulärer Ausdruck Muster1 Ausgabe2 0, 1, 2, 3
11 XML XPath Pfad3 0, 1, 2, 3
12 JSONPath Pfad3 0, 1, 2, 3
14 Entspricht regulärem Ausdruck Muster1 0, 1, 2, 3
15 Entspricht nicht regulärem Ausdruck Muster1 0, 1, 2, 3
16 Auf Fehler in JSON prüfen Pfad3 0, 1, 2, 3
17 Auf Fehler in XML prüfen Pfad3 0, 1, 2, 3
20 Unveränderte Werte mit Heartbeat verwerfen Sekunden4, 5
21 JavaScript Skript2
23 Prometheus in JSON Muster5, 6 0, 1, 2, 3
24 CSV in JSON Zeichen2 Zeichen2 0,1 0, 1, 2, 3
25 Ersetzen Suchzeichenfolge2 Ersetzung2
27 XML in JSON 0, 1, 2, 3
28 SNMP-Walk-Wert OID2 Format:
0 - Unverändert
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Ganzzahl aus BITS		 0, 1, 2, 3
29 SNMP-Walk in JSON7 Feldname2 OID-Präfix2 Format:
0 - Unverändert
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Ganzzahl aus BITS		 0, 1, 2, 3
30 SNMP-Get-Wert Format:
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Ganzzahl aus BITS		 0, 1, 2, 3

1 regulärer Ausdruck
2 Zeichenfolge
3 JSONPath oder XML XPath
4 positive Ganzzahl (mit Unterstützung von Zeitsuffixen, z. B. 30s, 1m, 2h, 1d)
5 Benutzermakro
6 Prometheus-Muster gemäß der Syntax: <metric name>{<label name>="<label value>", ...} == <value>. Jede Komponente des Prometheus-Musters (Metrik, Labelname, Labelwert und Metrikwert) kann ein Benutzermakro sein.
7 Unterstützt mehrere durch ein Newline-Zeichen getrennte Datensätze im Format „Feldname,OID-Präfix,Format“.

LLD-Regelüberschreibungen

Das Objekt für LLD-Regelüberschreibungen definiert eine Reihe von Regeln (Filter, Bedingungen und Operationen), die verwendet werden, um Eigenschaften verschiedener Prototyp-Objekte zu überschreiben. Es hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
name string Eindeutiger Name der Überschreibung.

Verhalten der Eigenschaft:
- erforderlich
step integer Eindeutige Reihenfolgenummer der Überschreibung.

Verhalten der Eigenschaft:
- erforderlich
stop integer Verarbeitung der nächsten Überschreibungen stoppen, wenn eine Übereinstimmung vorliegt.

Mögliche Werte:
0 - (Standard) Verarbeitung der Überschreibungen nicht stoppen;
1 - Verarbeitung der Überschreibungen stoppen, wenn der Filter übereinstimmt.
filter object Überschreibungsfilter.
operations object/array Überschreibungsoperationen.

Überschreibungsfilter für LLD-Regeln

Das Objekt für den Überschreibungsfilter von LLD-Regeln definiert eine Reihe von Bedingungen, bei deren Übereinstimmung mit dem erkannten Objekt die Überschreibung angewendet wird. Es hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
conditions object/array Menge von Bedingungen für Überschreibungsfilter, die zum Abgleichen der erkannten Objekte verwendet werden. Die Bedingungen werden in der Reihenfolge ihrer Platzierung in der Formel sortiert.

Verhalten der Eigenschaft:
- erforderlich
evaltype integer Auswertungsmethode der Bedingungen des Überschreibungsfilters.

Mögliche Werte:
0 - Und/Oder;
1 - Und;
2 - Oder;
3 - Benutzerdefinierter Ausdruck.

Verhalten der Eigenschaft:
- erforderlich
eval_formula string Generierter Ausdruck, der zur Auswertung der Bedingungen des Überschreibungsfilters verwendet wird. Der Ausdruck enthält IDs, die über ihr formulaid auf bestimmte Bedingungen des Überschreibungsfilters verweisen. Der Wert von eval_formula entspricht dem Wert von formula bei Filtern mit einem benutzerdefinierten Ausdruck.

Verhalten der Eigenschaft:
- schreibgeschützt
formula string Benutzerdefinierter Ausdruck, der zur Auswertung der Bedingungen von Überschreibungsfiltern mit einem benutzerdefinierten Ausdruck verwendet wird. Der Ausdruck muss IDs enthalten, die über ihr formulaid auf bestimmte Bedingungen des Überschreibungsfilters verweisen. Die im Ausdruck verwendeten IDs müssen exakt mit den in den Bedingungen des Überschreibungsfilters definierten IDs übereinstimmen: Keine Bedingung darf ungenutzt bleiben oder ausgelassen werden.

Verhalten der Eigenschaft:
- erforderlich, wenn evaltype auf „custom expression“ gesetzt ist
Filterbedingung für LLD-Regel-Overrides

Das Objekt für die Filterbedingung von LLD-Regel-Overrides definiert eine separate Prüfung, die für den Wert eines LLD-Makros durchgeführt wird. Es hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
macro string LLD-Makro, für das die Prüfung durchgeführt werden soll.

Property behavior:
- required
value string Wert, mit dem verglichen werden soll.

Property behavior:
- required if operator is set to "matches regular expression" or "does not match regular expression"
formulaid string Beliebige eindeutige ID, die verwendet wird, um aus einem benutzerdefinierten Ausdruck auf die Bedingung zu verweisen. Darf nur Großbuchstaben enthalten. Die ID muss vom Benutzer definiert werden, wenn Filterbedingungen geändert werden, wird jedoch bei einer späteren Abfrage erneut generiert.

Property behavior:
- required if evaltype of LLD rule override filter object is set to "custom expression"
operator integer Bedingungsoperator.

Mögliche Werte:
8 - (Standard) entspricht regulärem Ausdruck;
9 - entspricht nicht regulärem Ausdruck;
12 - existiert;
13 - existiert nicht.

LLD-Regel-Override-Operation

Die LLD-Regel-Override-Operation ist eine Kombination aus Bedingungen und Aktionen, die auf dem Prototyp-Objekt ausgeführt werden. Sie hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
operationobject integer Typ des erkannten Objekts, für das die Aktion ausgeführt werden soll.

Mögliche Werte:
0 - Datenpunkt-Prototyp;
1 - Auslöser-Prototyp;
2 - Graph-Prototyp;
3 - Host-Prototyp;
4 - Discovery-Prototyp.

Property behavior:
- erforderlich
operator integer Override-Bedingungs-operator.

Mögliche Werte:
0 - (Standard) gleich;
1 - ungleich;
2 - enthält;
3 - enthält nicht;
8 - entspricht;
9 - entspricht nicht.
value string Muster zum Abgleich mit dem Namen des Datenpunkt-, Auslöser-, Graph- oder Host-Prototyps, abhängig vom ausgewählten Objekt.
opstatus object Statusobjekt der Override-Operation für Datenpunkt-, Auslöser- und Host-Prototyp-Objekte.
opdiscover object Objekt für den Discovery-Status der Override-Operation (alle Objekttypen).
opperiod object Objekt für den Zeitraum (Aktualisierungsintervall) der Override-Operation für das Datenpunkt-Prototyp-Objekt.
ophistory object Verlaufsobjekt der Override-Operation für das Datenpunkt-Prototyp-Objekt.
optrends object Trendobjekt der Override-Operation für das Datenpunkt-Prototyp-Objekt.
opseverity object Schweregradobjekt der Override-Operation für das Auslöser-Prototyp-Objekt.
optag object/array Tag-Objekt der Override-Operation für Auslöser- und Host-Prototyp-Objekte.
optemplate object/array Vorlagenobjekt der Override-Operation für das Host-Prototyp-Objekt.
opinventory object Inventarobjekt der Override-Operation für das Host-Prototyp-Objekt.
Status der LLD-Regel-Override-Operation

Status der LLD-Regel-Override-Operation, der für das erkannte Objekt festgelegt wird. Er hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
status integer Überschreibt den Status für das ausgewählte Objekt.

Mögliche Werte:
0 - Aktiviert erstellen;
1 - Deaktiviert erstellen.

Property behavior:
- required
LLD-Regel-Override-Operation „Discover“

Der Discover-Status der LLD-Regel-Override-Operation wird für das erkannte Objekt festgelegt. Sie hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
discover integer Überschreibt den Discover-Status für das ausgewählte Objekt.

Mögliche Werte:
0 - Ja, mit der Erkennung der Objekte fortfahren;
1 - Nein, neue Objekte werden nicht erkannt und vorhandene werden als verloren markiert.

Property behavior:
- required
Betriebszeitraum der LLD-Regelüberschreibung

Der Betriebszeitraum der LLD-Regelüberschreibung ist ein Aktualisierungsintervallwert, der für den ermittelten Datenpunkt festgelegt wird. Er verfügt über die folgenden Eigenschaften:

Property Type Description
delay string Überschreibt das Aktualisierungsintervall des Datenpunkt-Prototyps.

Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300), einen Wert mit einem Zeitsuffix (z. B. 30s, 1m, 2h, 1d) oder optional ein oder mehrere benutzerdefinierte Intervalle, die durch Semikolons getrennt sind. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und Zeitplanintervallen sein.

Akzeptiert Benutzermakros oder LLD-Makros. Bei Verwendung muss der Wert aus einem einzelnen Makro bestehen. Mehrere Makros oder Makros in Kombination mit Text werden nicht unterstützt. Flexible Intervalle können als zwei durch einen Schrägstrich getrennte Makros geschrieben werden (z. B. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Beispiel:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Verhalten der Eigenschaft:
- required
Verlauf der Überschreibungsoperation der LLD-Regel

Wert der Verlaufsüberschreibungsoperation der LLD-Regel, der für den erkannten Datenpunkt festgelegt wird. Er hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
history string Überschreibt den Verlauf des Datenpunktprototyps; dies ist eine Zeiteinheit dafür, wie lange die Verlaufsdaten gespeichert werden sollen. Akzeptiert auch Benutzermakro und LLD-Makro.

Property behavior:
- required

Der Wert der Trends von LLD-Regel-Override-Operationen wird für den erkannten Datenpunkt festgelegt. Er hat die folgenden Eigenschaften:

Property Type Description
trends string Überschreibt die Trends des Datenpunktprototyps; dies ist eine Zeiteinheit dafür, wie lange die Trenddaten gespeichert werden sollen. Akzeptiert auch Benutzermakro und LLD-Makro.

Property behavior:
- required
Schweregrad der Überschreibungsoperation einer LLD-Regel

Der Schweregradwert der Überschreibungsoperation einer LLD-Regel, der für den erkannten Auslöser festgelegt wird. Er hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
severity integer Überschreibt den Schweregrad des Auslöser-Prototyps.

Mögliche Werte:
0 - (Standard) nicht klassifiziert;
1 - Information;
2 - Warnung;
3 - Durchschnitt;
4 - Hoch;
5 - Katastrophe.

Verhalten der Eigenschaft:
- erforderlich
LLD-Regel-Override-Operation-Tag

Das Objekt LLD-Regel-Override-Operation-Tag enthält den Tag-Namen und den Wert, die dem erkannten Objekt zugewiesen werden. Es hat die folgenden Eigenschaften:

Property Type Description
tag string Neuer Tag-Name. Akzeptiert auch User-Makros und LLD-Makros.

Property behavior:
- required
value string Neuer Tag-Wert. Akzeptiert auch User-Makros und LLD-Makros.
Vorlage für die Überschreibungsoperation einer LLD-Regel

Objekt der Überschreibungsoperation einer LLD-Regel, das mit dem erkannten Host verknüpft ist.
Es hat die folgenden Eigenschaften:

Property Type Description
templateid ID Überschreibt die Vorlage der verknüpften Vorlagen des Host-Prototyps.

Property behavior:
- required
Inventar des LLD-Regel-Override-Vorgangs

Der Wert des Inventarmodus des LLD-Regel-Override-Vorgangs, der für den erkannten Host festgelegt wird. Er hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
inventory_mode integer Überschreibt den Inventarmodus des Host-Prototyps.

Mögliche Werte:
-1 - deaktiviert;
0 - (Standard) manuell;
1 - automatisch.

Property behavior:
- erforderlich