LLD-Regelobjekt

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

LLD-Regel

Das Objekt der Low-Level-Discovery-Regel hat 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 Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional ein oder mehrere benutzerdefinierte Intervalle, alle durch Semikolons getrennt. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und Planungsintervallen sein.

Akzeptiert Benutzermakros. Falls verwendet, muss der Wert aus genau einem einzelnen Makro bestehen. Mehrere Makros oder mit Text gemischte Makros 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:
- 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), "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 Herkunft der Discovery-Regel.

Mögliche Werte:
1 - eine Low-Level-Discovery-Regel;
5 - eine aus einem Prototyp konvertierte Low-Level-Discovery-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 vererbte Objekte
name string Name der LLD-Regel.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für vererbte 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 - Abhängiger Datenpunkt;
19 - HTTP agent;
20 - SNMP agent;
21 - Script;
22 - Browser;
23 - Verschachtelt. Dieser Typ ist nur zulässig, wenn das übergeordnete Element der Regel eine Vorlage ist (von der angenommen wird, dass sie bei der Discovery mit einem Host-Prototyp verknüpft ist) oder ein entdeckter Host (der eine LLD-Regel an seiner Wurzel hat).

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für vererbte 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 vererbte Objekte
allow_traps integer Erlaubt das Befüllen des Werts ähnlich wie beim Trapper-Datenpunkt.

Mögliche Werte:
0 - (Standard) Das Annehmen eingehender Daten nicht erlauben;
1 - Das Annehmen eingehender Daten erlauben.

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 vererbte Objekte (wenn type auf "HTTP agent" gesetzt ist)
description string Beschreibung der LLD-Regel.
error string Fehlertext, wenn es Probleme beim Aktualisieren des Werts der LLD-Regel gibt.

Verhalten der Eigenschaft:
- schreibgeschützt
follow_redirects integer Antwort-Weiterleitungen beim Abrufen von Daten folgen.

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

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für vererbte 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 vererbte Objekte
http_proxy string HTTP(S)-Proxy-Verbindungszeichenfolge.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für vererbte 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 vererbte 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, die nicht mehr entdeckt werden, gelöscht werden. Akzeptiert Sekunden, Zeiteinheiten mit Suffix oder ein Benutzermakro.

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

Mögliche Werte:
0 - (Standard) Löschen, nachdem der Schwellenwert für die Lebensdauer erreicht wurde;
1 - Nicht löschen;
2 - Sofort löschen.
enabled_lifetime string Zeitraum, nach dem Datenpunkte, die nicht mehr entdeckt werden, deaktiviert werden. Akzeptiert Sekunden, Zeiteinheiten mit Suffix oder ein Benutzermakro.

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

Mögliche Werte:
0 - Deaktivieren, nachdem der Schwellenwert für die Lebensdauer erreicht wurde;
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 vererbte Objekte
output_format integer Gibt an, ob die Antwort in JSON konvertiert werden soll.

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

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für vererbte 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 vom Typ Datenbankmonitor;
- Formel für berechnete LLD-Regeln;
- das Skript für LLD-Regeln vom Typ 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 vererbte 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 vererbte Objekte
password string Passwort für die Authentifizierung.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "JMX agent" gesetzt ist und username gesetzt ist
- unterstützt, wenn type auf "Simple check", "Database monitor", "SSH agent", "TELNET agent" oder "HTTP agent" gesetzt ist
- schreibgeschützt für vererbte 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 vererbte Objekte
posts string HTTP(S)-Anfrage-Body-Daten.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "HTTP agent" gesetzt ist und post_type auf "JSON data" oder "XML data" gesetzt ist
- unterstützt, wenn type auf "HTTP agent" gesetzt ist und post_type auf "Raw data" gesetzt ist
- schreibgeschützt für vererbte Objekte
privatekey string Name der privaten Schlüsseldatei.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SSH agent" gesetzt ist und authtype auf "public key" gesetzt ist
publickey string Name der öffentlichen Schlüsseldatei.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SSH agent" gesetzt ist 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 vererbte 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 vererbte Objekte
retrieve_mode integer 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 - Sowohl Body als auch 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 vererbte Objekte
snmp_oid string SNMP-OID.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SNMP agent" gesetzt ist
- schreibgeschützt für vererbte 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 vererbte 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 vererbte 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 vererbte 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 Bereiche erforderlicher HTTP-Statuscodes, durch Kommas getrennt. Unterstützt auch Benutzermakros als Teil einer kommagetrennten Liste.

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

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für vererbte Objekte
templateid ID ID der übergeordneten Vorlagen-LLD-Regel.

Verhalten der Eigenschaft:
- schreibgeschützt
timeout string Zeitüberschreitung für die Abfrageanforderung von Datenpunktdaten.
Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m). Akzeptiert auch 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 vererbte 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" gesetzt ist und allow_traps auf "Allow to accept incoming data" gesetzt ist
username string Benutzername für die Authentifizierung.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SSH agent", "TELNET agent" gesetzt ist oder wenn type auf "JMX agent" gesetzt ist und password gesetzt ist
- unterstützt, wenn type auf "Simple check", "Database monitor" oder "HTTP agent" gesetzt ist
- schreibgeschützt für vererbte Objekte (wenn type auf "HTTP agent" gesetzt ist)
uuid string Universell eindeutige Kennung, die verwendet wird, um importierte LLD-Regeln mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn sie 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 für die Verbindung mit dem 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 vererbte 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 vererbte 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 Objekt des LLD-Regelfilters definiert eine Reihe von Bedingungen, die zum Filtern erkannter Objekte verwendet werden können. Es hat die folgenden Eigenschaften:

Property Type Description
conditions object/array Menge von Filterbedingungen, die zum Filtern von Ergebnissen verwendet werden. Die Bedingungen werden in der Reihenfolge ihrer Platzierung in der Formel sortiert.

Property behavior:
- required
evaltype integer Auswertungsmethode der Filterbedingung.

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

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

Property behavior:
- read-only
formula string Vom Benutzer definierter Ausdruck, der zur Auswertung von Bedingungen von Filtern mit einem benutzerdefinierten Ausdruck verwendet wird. Der Ausdruck muss IDs enthalten, die auf bestimmte Filterbedingungen über ihre formulaid verweisen. Die im Ausdruck verwendeten IDs müssen exakt mit den in den Filterbedingungen definierten übereinstimmen: Keine Bedingung darf ungenutzt bleiben oder ausgelassen werden.

Property behavior:
- required if evaltype is set to "custom expression"

LLD-Regel-Filterbedingung

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

Property Type Description
macro string LLD-Makro, auf das die Prüfung angewendet 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 in einem benutzerdefinierten Ausdruck auf die Bedingung zu verweisen. Darf nur Großbuchstaben enthalten. Die ID muss vom Benutzer beim Ändern von Filterbedingungen definiert werden, wird jedoch bei späteren Abfragen neu generiert.

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

Possible values:
8 - (default) matches regular expression;
9 - does not match regular expression;
12 - exists;
13 - does not exist.

Um besser zu verstehen, wie Filter mit verschiedenen Arten von Ausdrücken verwendet werden, sehen Sie sich die Beispiele auf den Seiten der Methoden discoveryrule.get und discoveryrule.create an.

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

LLD-Regel-Vorverarbeitung

Das Objekt der LLD-Regel-Vorverarbeitung hat die folgenden Eigenschaften.

Property Type Description
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ändert verwerfen mit Heartbeat;
21 - JavaScript;
23 - Prometheus zu JSON;
24 - CSV zu JSON;
25 - Ersetzen;
27 - XML zu JSON;
28 - SNMP-Walk-Wert;
29 - SNMP-Walk zu JSON;
30 - SNMP-Get-Wert.

Property behavior:
- required
params string Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden. Mehrere Parameter werden durch das Zeilenumbruchzeichen (\n) getrennt.

Property behavior:
- required 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ändert verwerfen mit Heartbeat" (20), "JavaScript" (21), "Prometheus zu JSON" (23), "CSV zu JSON" (24), "Ersetzen" (25), "SNMP-Walk-Wert" (28), "SNMP-Walk zu JSON" (29) oder "SNMP-Get-Wert" (30) gesetzt ist
error_handler integer Aktionstyp, der im Falle eines Fehlers beim Vorverarbeitungsschritt verwendet wird.

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

Property behavior:
- required 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 zu JSON" (23), "CSV zu JSON" (24), "XML zu JSON" (27), "SNMP-Walk-Wert" (28), "SNMP-Walk zu JSON" (29) oder "SNMP-Get-Wert" (30) gesetzt ist
error_handler_params string Parameter des Fehlerbehandlers.

Property behavior:
- required wenn error_handler auf "Benutzerdefinierten Wert setzen" oder "Benutzerdefinierte Fehlermeldung setzen" gesetzt ist

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

Preprocessing type Name Parameter 1 Parameter 2 Parameter 3 Supported error handlers
5 Regulärer Ausdruck pattern1 output2 0, 1, 2, 3
11 XML XPath path3 0, 1, 2, 3
12 JSONPath path3 0, 1, 2, 3
14 Entspricht regulärem Ausdruck pattern1 0, 1, 2, 3
15 Entspricht nicht regulärem Ausdruck pattern1 0, 1, 2, 3
16 Auf Fehler in JSON prüfen path3 0, 1, 2, 3
17 Auf Fehler in XML prüfen path3 0, 1, 2, 3
20 Unverändert verwerfen mit Heartbeat seconds4, 5
21 JavaScript script2
23 Prometheus zu JSON pattern5, 6 0, 1, 2, 3
24 CSV zu JSON character2 character2 0,1 0, 1, 2, 3
25 Ersetzen search string2 replacement2
27 XML zu JSON 0, 1, 2, 3
28 SNMP walk value OID2 Format:
0 - Unverändert
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Integer aus BITS
0, 1, 2, 3
29 SNMP walk to JSON7 Field name2 OID prefix2 Format:
0 - Unverändert
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Integer aus BITS
0, 1, 2, 3
30 SNMP get value Format:
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Integer aus BITS
0, 1, 2, 3

1 regulärer Ausdruck
2 Zeichenkette
3 JSONPath oder XML XPath
4 positive ganze Zahl (mit Unterstützung von Zeitsuffixen, z. B. 30s, 1m, 2h, 1d)
5 Benutzermakro
6 Prometheus-Muster nach 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 Datensätze "Field name,OID prefix,Format records", getrennt durch ein Zeilenumbruchzeichen.

LLD-Regel-Overrides

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

Property Type Description
name string Eindeutiger Override-Name.

Property behavior:
- required
step integer Eindeutige Ordnungsnummer des Overrides.

Property behavior:
- required
stop integer Die Verarbeitung der nächsten Overrides beenden, wenn eine Übereinstimmung vorliegt.

Mögliche Werte:
0 - (default) die Verarbeitung von Overrides nicht beenden;
1 - die Verarbeitung von Overrides beenden, wenn der Filter übereinstimmt.
filter object Override-Filter.
operations object/array Override-Operationen.

LLD-Regel-Override-Filter

Das Objekt des LLD-Regel-Override-Filters definiert eine Reihe von Bedingungen, die, wenn sie mit dem erkannten Objekt übereinstimmen, die Override-Anwendung auslösen. Es hat die folgenden Eigenschaften:

Property Type Description
conditions object/array Menge von Override-Filterbedingungen, die zum Abgleich der erkannten Objekte verwendet werden. Die Bedingungen werden in der Reihenfolge ihrer Platzierung in der Formel sortiert.

Property behavior:
- required
evaltype integer Auswertungsmethode der Override-Filterbedingung.

Mögliche Werte:
0 - And/Or;
1 - And;
2 - Or;
3 - Benutzerdefinierter Ausdruck.

Property behavior:
- required
eval_formula string Generierter Ausdruck, der zur Auswertung der Override-Filterbedingungen verwendet wird. Der Ausdruck enthält IDs, die über ihre formulaid auf bestimmte Override-Filterbedingungen verweisen. Der Wert von eval_formula entspricht dem Wert von formula für Filter mit benutzerdefiniertem Ausdruck.

Property behavior:
- read-only
formula string Vom Benutzer definierter Ausdruck zur Auswertung von Bedingungen von Override-Filtern mit benutzerdefiniertem Ausdruck. Der Ausdruck muss IDs enthalten, die über ihre formulaid auf bestimmte Override-Filterbedingungen verweisen. Die im Ausdruck verwendeten IDs müssen exakt mit den in den Override-Filterbedingungen definierten übereinstimmen: Keine Bedingung darf ungenutzt bleiben oder ausgelassen werden.

Property behavior:
- required if evaltype is set to "custom expression"
LLD-Regel-Override-Filterbedingung

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

Property Type Description
macro string LLD-Makro, auf das die Prüfung angewendet 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 in einem benutzerdefinierten Ausdruck auf die Bedingung zu verweisen. Darf nur Großbuchstaben enthalten. Die ID muss vom Benutzer beim Ändern von Filterbedingungen definiert werden, wird jedoch bei einer späteren Abfrage neu generiert.

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

Possible values:
8 - (default) matches regular expression;
9 - does not match regular expression;
12 - exists;
13 - does not exist.

LLD-Regel-Override-Operation

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

Eigenschaft Typ 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 - Diagramm-Prototyp;
3 - Host-Prototyp;
4 - Discovery-Prototyp.

Verhalten der Eigenschaft:
- erforderlich
operator integer Override-Bedingungs-Operator.

Mögliche Werte:
0 - (Standard) gleich;
1 - ungleich;
2 - enthält;
3 - enthält nicht;
8 - stimmt überein;
9 - stimmt nicht überein.
value string Muster, das je nach ausgewähltem Objekt mit dem Namen des Datenpunkts, Auslösers, Diagramms oder Host-Prototyps abgeglichen werden soll.
opstatus object Override-Operationsstatus-Objekt für Datenpunkt-, Auslöser- und Host-Prototyp-Objekte.
opdiscover object Override-Operation-Discovery-Status-Objekt (alle Objekttypen).
opperiod object Override-Operationszeitraum-Objekt (Aktualisierungsintervall) für das Datenpunkt-Prototyp-Objekt.
ophistory object Override-Operationsverlaufs-Objekt für das Datenpunkt-Prototyp-Objekt.
optrends object Override-Operationstrends-Objekt für das Datenpunkt-Prototyp-Objekt.
opseverity object Override-Operationsschweregrad-Objekt für das Auslöser-Prototyp-Objekt.
optag object/array Override-Operations-Tag-Objekt für Auslöser- und Host-Prototyp-Objekte.
optemplate object/array Override-Operations-Vorlage-Objekt für das Host-Prototyp-Objekt.
opinventory object Override-Operations-Inventar-Objekt für das Host-Prototyp-Objekt.
Status der Überschreibungsoperation der LLD-Regel

Status der Überschreibungsoperation der LLD-Regel, der für das erkannte Objekt festgelegt ist. Er hat die folgenden Eigenschaften:

Property Type Description
status integer Den Status für das ausgewählte Objekt überschreiben.

Mögliche Werte:
0 - Erstellen aktiviert;
1 - Erstellen deaktiviert.

Property behavior:
- required
LLD-Regel-Überschreibungsoperation discover

LLD-Regel-Überschreibungsoperation discover-Status, der auf entdeckt gesetzt ist Objekt. Sie hat die folgenden Eigenschaften:

Property Type Description
discover integer Den discover-Status für das ausgewählte Objekt überschreiben.

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

Property behavior:
- required
Zeitraum für die Überschreibungsoperation einer LLD-Regel

Der Zeitraum für die Überschreibungsoperation einer LLD-Regel ist ein Aktualisierungsintervallwert, der für einen erkannten Datenpunkt festgelegt wird. Er hat die folgenden Eigenschaften:

Eigenschaft Type Beschreibung
delay string Überschreibt das Aktualisierungsintervall des Datenpunktprototyps.

Akzeptiert Sekunden oder eine Zeiteinheit mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional ein oder mehrere benutzerdefinierte Intervalle, jeweils durch Semikolons getrennt. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und Planungsintervallen sein.

Akzeptiert Benutzermakros oder LLD-Makros. Falls verwendet, muss der Wert aus genau einem einzelnen Makro bestehen. Mehrere Makros oder mit Text gemischte Makros 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}

Property behavior:
- required
LLD-Regel-Override-Operationsverlauf

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

Property Type Description
history string Überschreibt den Verlauf des Datenpunkt-Prototyps, wobei es sich um eine Zeiteinheit handelt, die angibt, wie lange die Verlaufsdaten gespeichert werden sollen. Akzeptiert außerdem Benutzer-Makro 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
LLD-Regel-Override-Operation Schweregrad

Schweregradwert der LLD-Regel-Override-Operation, der für den erkannten Auslöser festgelegt wird. Er hat die folgenden Eigenschaften:

Property Type Description
severity integer Schweregrad des Auslöser-Prototyps überschreiben.

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

Property behavior:
- required
LLD-Regel-Override-Operation-Tag

Das LLD-Regel-Override-Operation-Tag-Objekt enthält den Tag-Namen und den Wert, die für das erkannte Objekt festgelegt werden. Es hat die folgenden Eigenschaften:

Property Type Description
tag string Neuer Tag-Name.

Property behavior:
- required
value string Neuer Tag-Wert.
Vorlage für die Überschreibungsoperation der LLD-Regel

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

Property Type Description
templateid ID Überschreibt die Vorlage der mit dem Host-Prototyp verknüpften Vorlagen.

Property behavior:
- required
LLD-Regel-Override-Operation Inventar

LLD-Regel-Override-Operation für den Inventar-Moduswert, der für den erkannten Host festgelegt wird. Sie hat die folgenden Eigenschaften:

Property Type Description
inventory_mode integer Überschreibt den Inventar-Modus der Host-Vorlage.

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

Property behavior:
- erforderlich