- LLD-Regelobjekt
- LLD-Regel
- LLD-Regelfilter
- LLD-Makropfad
- Vorverarbeitung von LLD-Regeln
- LLD-Regelüberschreibungen
- Überschreibungsfilter für LLD-Regeln
- LLD-Regel-Override-Operation
- Status der LLD-Regel-Override-Operation
- LLD-Regel-Override-Operation „Discover“
- Zeitraum für die Überschreibungsoperation einer LLD-Regel
- Verlauf der Überschreibungsoperation der LLD-Regel
- Trends von LLD-Regel-Override-Operationen
- Schweregrad der Überschreibungsoperation einer LLD-Regel
- LLD-Regel-Override-Operation-Tag
- Vorlage für die Überschreibungsoperation einer LLD-Regel
- Inventar des LLD-Regel-Override-Vorgangs
LLD-Regelobjekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der discoveryrule API.
LLD-Regel
Das Objekt der Low-Level-Discovery-Regel verfügt über die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| itemid | ID | ID der LLD-Regel. Property behavior: - schreibgeschützt - erforderlich für Aktualisierungsvorgänge |
| delay | string | Aktualisierungsintervall der LLD-Regel. Akzeptiert Sekunden oder eine Zeiteinheit mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional einen oder mehrere benutzerdefinierte Intervalle, jeweils durch Semikolons getrennt. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und Zeitplan-Intervallen sein. Akzeptiert Benutzermakros. Wenn verwendet, muss der Wert ein einzelnes Makro sein. 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}Property behavior: - 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. Property behavior: - konstant - erforderlich für Erstellungsoperationen |
| flags | integer | Ursprung der Discovery-Regel. Mögliche Werte: 1 - eine Low-Level-Discovery-Regel; 5 - eine aus einem Prototyp konvertierte Low-Level-Discovery-Regel. Property behavior: - schreibgeschützt |
| interfaceid | ID | ID der Host-Schnittstelle der LLD-Regel. Property behavior: - 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 | LLD-Regel-Schlüssel. Property behavior: - erforderlich für Erstellungsoperationen - schreibgeschützt für geerbte Objekte |
| name | string | Name der LLD-Regel. Property behavior: - erforderlich für Erstellungsoperationen - 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 - Verschachtelt. Dieser Typ ist nur zulässig, wenn der übergeordnete Eintrag der Regel eine Vorlage ist (die bei der Discovery als mit einem Host-Prototyp verknüpft angenommen wird) oder ein entdeckter Host (der eine LLD-Regel an seiner Wurzel hat). Property behavior: - erforderlich für Erstellungsoperationen - 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}. Property behavior: - 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) Den Empfang eingehender Daten nicht zulassen; 1 - Den Empfang eingehender Daten zulassen. Property behavior: - 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. Property behavior: - 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 Probleme beim Aktualisieren des Werts der LLD-Regel auftreten. Property behavior: - schreibgeschützt |
| follow_redirects | integer | Antwort-Weiterleitungen beim Abrufen der Daten folgen. Mögliche Werte: 0 - Weiterleitungen nicht folgen; 1 - (Standard) Weiterleitungen folgen. Property behavior: - 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. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| http_proxy | string | Verbindungszeichenfolge für HTTP(S)-Proxy. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| ipmi_sensor | string | IPMI-Sensor. Property behavior: - 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 gateway. Standard: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Property behavior: - unterstützt wenn type auf "JMX agent" gesetzt ist |
| lifetime | string | Zeitraum, nach dem nicht mehr entdeckte Datenpunkte gelöscht werden. Akzeptiert Sekunden, eine Zeiteinheit mit Suffix oder ein Benutzermakro. Standard: 7d. |
| lifetime_type | integer | Szenario zum Löschen verlorener LLD-Ressourcen. Mögliche Werte: 0 - (Standard) Nach Erreichen des Lebensdauer-Schwellenwerts löschen; 1 - Nicht löschen; 2 - Sofort löschen. |
| enabled_lifetime | string | Zeitraum, nach dem nicht mehr entdeckte Datenpunkte deaktiviert werden. Akzeptiert Sekunden, eine Zeiteinheit mit Suffix oder ein Benutzermakro. Standard: 0. |
| enabled_lifetime_type | integer | Szenario zum Deaktivieren verlorener LLD-Ressourcen. Mögliche Werte: 0 - Nach Erreichen des Lebensdauer-Schwellenwerts deaktivieren; 1 - Nicht deaktivieren; 2 - (Standard) Sofort deaktivieren. |
| master_itemid | ID | ID des Master-Datenpunkts. Die Discovery-Regel kann nicht Master-Datenpunkt einer anderen Discovery-Regel sein. Property behavior: - erforderlich wenn type auf "Dependent item" gesetzt ist- schreibgeschützt für geerbte Objekte |
| output_format | integer | Soll die Antwort in JSON konvertiert werden. Mögliche Werte: 0 - (Standard) Rohdaten speichern; 1 - In JSON konvertieren. Property behavior: - 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 Datenbankmonitors; - Formel für berechnete LLD-Regeln; - das Skript für Skript- und Browser-LLD-Regeln. Property behavior: - 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.Property behavior: - unterstützt wenn type auf "Script" oder "Browser" gesetzt ist- schreibgeschützt für geerbte Objekte |
| password | string | Passwort für die Authentifizierung. Property behavior: - 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 geerbte Objekte (wenn type auf "HTTP agent" gesetzt ist) |
| post_type | integer | Typ des in der Eigenschaft posts gespeicherten HTTP-Request-Body.Mögliche Werte: 0 - (Standard) Rohdaten; 2 - JSON-Daten; 3 - XML-Daten. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| posts | string | HTTP(S)-Anfragedaten des Request-Bodys. Property behavior: - 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 geerbte Objekte |
| privatekey | string | Name der Datei des privaten Schlüssels. Property behavior: - erforderlich wenn type auf "SSH agent" gesetzt ist und authtype auf "public key" gesetzt ist |
| publickey | string | Name der Datei des öffentlichen Schlüssels. Property behavior: - 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. Property behavior: - 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. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte 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. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| snmp_oid | string | SNMP-OID. Property behavior: - erforderlich wenn type auf "SNMP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| ssl_cert_file | string | Pfad zur öffentlichen SSL-Schlüsseldatei. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| ssl_key_file | string | Pfad zur privaten SSL-Schlüsseldatei. Property behavior: - 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. Property behavior: - 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. Property behavior: - 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 der erforderlichen HTTP-Statuscodes. Unterstützt auch Benutzermakros als Teil einer durch Kommas getrennten Liste. Beispiel: 200,200-{$M},{$M},200-400 Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| templateid | ID | ID der übergeordneten Vorlage-LLD-Regel. Property behavior: - schreibgeschützt |
| timeout | string | Zeitüberschreitung für die Abfrage des Datenpunkt-Datenabrufs. Akzeptiert Sekunden oder eine Zeiteinheit mit Suffix (z. B. 30s, 1m). Akzeptiert auch Benutzermakros. Möglicher Wertebereich: 1-600s. Standard: "" - Proxy-/Globaleinstellungen verwenden. Property behavior: - unterstützt wenn type auf "Zabbix agent" (0), "Simple check" (3) und key_ nicht mit "vmware." oder "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) gesetzt ist- schreibgeschützt für geerbte Objekte |
| trapper_hosts | string | Zulässige Hosts. Property behavior: - unterstützt wenn type auf "Zabbix trapper" gesetzt ist oder wenn type auf "HTTP agent" gesetzt ist und allow_traps auf "Den Empfang eingehender Daten zulassen" gesetzt ist.Wenn die Eigenschaft weggelassen wird, wird sie automatisch auf das Benutzermakro {$TRAPPER.ALLOWED_HOSTS} gesetzt (Standardwert). Standardmäßig ist {$TRAPPER.ALLOWED_HOSTS} 127.0.0.1,::1.Wenn die Eigenschaft auf eine leere Zeichenfolge gesetzt wird, werden eingehende Verbindungen von allen Hosts abgelehnt. |
| username | string | Benutzername für die Authentifizierung. Property behavior: - 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 geerbte 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 nicht angegeben. Property behavior: - unterstützt wenn die LLD-Regel zu einer Vorlage gehört |
| verify_host | integer | Ob geprüft werden soll, dass der Hostname der Verbindung mit dem im Zertifikat des Hosts übereinstimmt. Mögliche Werte: 0 - (Standard) Nicht prüfen; 1 - Prüfen. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| verify_peer | integer | Ob geprüft werden soll, dass das Zertifikat des Hosts authentisch ist. Mögliche Werte: 0 - (Standard) Nicht prüfen; 1 - Prüfen. Property behavior: - 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 von LLD-Regeln
Das Objekt für die Vorverarbeitung von LLD-Regeln hat 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 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. Verhalten der Eigenschaft: - erforderlich |
| params | string | Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden. Mehrere Parameter werden durch das Zeilenumbruchzeichen (\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 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 bei einem Fehler im Vorverarbeitungsschritt verwendet wird. Mögliche Werte: 0 - Fehlermeldung wird vom Zabbix Server gesetzt; 1 - Wert verwerfen; 2 - Benutzerdefinierten Wert setzen; 3 - Benutzerdefinierte Fehlermeldung setzen. 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 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 für den Fehler-Handler. Verhalten der Eigenschaft: - erforderlich, wenn error_handler auf "Benutzerdefinierten Wert setzen" oder "Benutzerdefinierte Fehlermeldung setzen" gesetzt ist |
Die folgenden Parameter und Fehler-Handler werden für jeden Vorverarbeitungstyp unterstützt.
| Vorverarbeitungstyp | Name | Parameter 1 | Parameter 2 | Parameter 3 | Unterstützte Fehler-Handler |
|---|---|---|---|---|---|
| 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 zu JSON | Muster5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV zu JSON | Zeichen2 | Zeichen2 | 0,1 | 0, 1, 2, 3 |
| 25 | Ersetzen | Suchzeichenfolge2 | Ersetzung2 | ||
| 27 | XML zu 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 - Integer aus BITS |
0, 1, 2, 3 | |
| 29 | SNMP-Walk zu JSON7 | Feldname2 | OID-Präfix2 | 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-Wert | 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 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, Label-Name, Label-Wert und Metrikwert) kann ein Benutzermakro sein.
7 Unterstützt mehrere Datensätze vom Typ "Feldname,OID-Präfix,Format", die durch ein Zeilenumbruchzeichen getrennt sind.
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 |
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 |
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 |
Trends von LLD-Regel-Override-Operationen
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 |