- LLD-Regelobjekt
- LLD-Regel
- LLD-Regelfilter
- LLD-Makropfad
- Vorverarbeitung der LLD-Regel
- LLD-Regel-Overrides
- LLD-Regel-Override-Filter
- LLD-Regel-Override-Operation
- Status der Überschreibungsoperation der LLD-Regel
- LLD-Regel-Überschreibungsoperation discover
- Zeitraum der LLD-Regelüberschreibungsoperation
- LLD-Regel-Override-Operation-Historie
- Trends der LLD-Regel-Override-Operation
- LLD-Regel-Override-Operation Schweregrad
- LLD-Regel-Override-Operation-Tag
- Vorlage für die Überschreibungsoperation der LLD-Regel
- LLD-Regel-Override-Operation Inventar
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 Zeitsuffix (z. B. 30s, 1m, 2h, 1d) oder optional ein oder mehrere benutzerdefinierte Intervalle, die jeweils durch Semikolons getrennt sind. Benutzerdefinierte Intervalle können eine Mischung 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 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) 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 | Herkunft 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 ist (von der angenommen wird, dass sie bei der Discovery mit einem Host-Prototyp verknüpft wird) oder ein entdeckter Host (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 | Ermöglicht das Befüllen des Werts wie bei einem 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 bei 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 Zeitsuffix (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 Lebensdauerschwellenwerts; 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 Zeitsuffix (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 Lebensdauerschwellenwerts; 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 Datenbankmonitor; - Formel für berechnete LLD-Regeln; - Skript für LLD-Regeln des Typs Skript 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 ist und username festgelegt 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 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)-Anforderungskö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 bei 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 Anforderungsmethode. 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) oder einen Wert mit einem Zeitsuffix (z. B. 30s, 1m). Akzeptiert außerdem Benutzermakros.Möglicher Wertebereich: 1-600 s. 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.“ 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) gesetzt ist und snmp_oid mit „walk[“ oder „get[“ beginnt, „Script“ (21) oder „Browser“ (22) gesetzt ist- 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 |
| 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 festgelegt 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 für die 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 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 |
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 dem regulären 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 konvertieren; 24 - CSV in JSON konvertieren; 25 - Ersetzen; 27 - XML in JSON konvertieren; 28 - SNMP-Walk-Wert; 29 - SNMP-Walk in JSON konvertieren; 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 dem regulären 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 konvertieren“ (23), „CSV in JSON konvertieren“ (24), „Ersetzen“ (25), „SNMP-Walk-Wert“ (28), „SNMP-Walk in JSON konvertieren“ (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 dem regulären Ausdruck“ (15), „Auf Fehler in JSON prüfen“ (16), „Auf Fehler in XML prüfen“ (17), „Prometheus in JSON konvertieren“ (23), „CSV in JSON konvertieren“ (24), „XML in JSON konvertieren“ (27), „SNMP-Walk-Wert“ (28), „SNMP-Walk in JSON konvertieren“ (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 | 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 dem regulären 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änderte Werte mit Heartbeat verwerfen | seconds4, 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | Prometheus in JSON konvertieren | pattern5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV in JSON konvertieren | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | Ersetzen | search string2 | replacement2 | ||
| 27 | XML in JSON konvertieren | 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 in JSON konvertieren7 | 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-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 Zeichenkette
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 Datensätze im Format „Field name,OID prefix,Format“, die durch ein Zeilenumbruchzeichen getrennt sind.
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 der LLD-Regelüberschreibungsoperation
Der Zeitraum der LLD-Regelüberschreibungsoperation ist ein Wert für das Aktualisierungsintervall, 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 Intervallen und Zeitplanintervallen sein.Akzeptiert Benutzermakros oder LLD-Makros (Unterstützung für LLD-Makros in Zabbix 7.4.11 wiederhergestellt). 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 |
LLD-Regel-Override-Operation-Historie
LLD-Regel-Override-Operation-Historie-Wert, der auf das erkannte Datenpunkt gesetzt wird. Er hat die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| history | string | Überschreibt die Historie des Datenpunkt-Prototyps, wobei eine Zeiteinheit angegeben wird, wie lange die Historiedaten gespeichert werden sollen. Akzeptiert außerdem User-Makro und LLD-Makro (LLD-Makro-Unterstützung in Zabbix 7.4.11 wiederhergestellt). Property behavior: - required |
Trends der LLD-Regel-Override-Operation
Wert für Trends der LLD-Regel-Override-Operation, der für den erkannten Datenpunkt festgelegt wird. Er hat die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| trends | string | Überschreibt die Trends der Datenpunktvorlage, also die Zeiteinheit, wie lange die Trends-Daten gespeichert werden sollen. Akzeptiert außerdem User-Makros und LLD-Makros (LLD-Makro-Unterstützung wurde in Zabbix 7.4.11 wiederhergestellt). 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 Objekt des LLD-Regel-Override-Operation-Tags 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 Benutzer-Makro und LLD-Makro. Property behavior: - required |
| value | string | Neuer Tag-Wert. Akzeptiert auch Benutzer-Makro und LLD-Makro. |
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 |