- LLD-Regelprototyp-Objekt
- Prototyp eines LLD-Regel
- Filter für LLD-Regelprototypen
- LLD-Makropfad
- Vorverarbeitung des LLD-Regelprototyps
- Überschreibungen von LLD-Regelprototypen
- Filter für Überschreibungen von LLD-Regelprototypen
- Überschreibungsoperation für LLD-Regelprototypen
- Status der Überschreibungsoperation des LLD-Regelprototyps
- LLD-Regelprototyp-Override-Operation „discover“
- Betriebszeitraum der LLD-Regelprototypüberschreibung
- Verlauf der Überschreibungsoperation des LLD-Regelprototyps
- Trends der Überschreibungsoperation von LLD-Regelprototypen
- Schweregrad der Überschreibungsoperation für LLD-Regelprototypen
- Tag einer Überschreibungsoperation für LLD-Regelprototypen
- Vorlage für die Überschreibungsoperation des LLD-Regelprototyps
- Inventar des Überschreibungsvorgangs für LLD-Regelprototypen
LLD-Regelprototyp-Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der API discoveryruleprototype.
Prototyp eines LLD-Regel
Das Objekt des Prototyps einer Low-Level-Discovery-Regel verfügt über die folgenden Eigenschaften.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| itemid | ID | ID des Prototyps der LLD-Regel. Verhalten der Eigenschaft: - schreibgeschützt - erforderlich für Aktualisierungsvorgänge |
| ruleid | ID | ID der übergeordneten LLD-Regel/des übergeordneten LLD-Regelprototyps. Verhalten der Eigenschaft: - schreibgeschützt - erforderlich für Erstellungsvorgänge |
| delay | string | Aktualisierungsintervall des Prototyps der LLD-Regel. Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300), einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m, 2h, 1d) oder optional ein oder mehrere benutzerdefinierte Intervalle, die durch Semikolons getrennt sind. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und Zeitplanintervallen sein.Akzeptiert Benutzermakros. Bei Verwendung muss der Wert aus einem einzelnen Makro bestehen. Mehrere Makros oder Makros in Kombination mit Text werden nicht unterstützt. Flexible Intervalle können als zwei durch einen Schrägstrich getrennte Makros angegeben werden (z. B. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Beispiel: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Verhalten der Eigenschaft: - erforderlich, wenn type auf "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21) oder "Browser" (22) gesetzt ist oder wenn type auf "Zabbix agent (active)" (7) gesetzt ist und key_ nicht "mqtt.get" enthält |
| hostid | ID | ID des Hosts, zu dem der Prototyp der LLD-Regel gehört. Verhalten der Eigenschaft: - konstant - erforderlich für Erstellungsvorgänge |
| flags | integer | Herkunft des Prototyps der LLD-Regel. Mögliche Werte: 3 - ein Prototyp einer Low-Level-Discovery-Regel; 7 - ein entdeckter Prototyp einer Low-Level-Discovery-Regel. Verhalten der Eigenschaft: - schreibgeschützt |
| interfaceid | ID | ID der Host-Schnittstelle des Prototyps der LLD-Regel. Verhalten der Eigenschaft: - erforderlich, wenn der Prototyp der LLD-Regel zu einem Host gehört und type auf "Zabbix agent", "IPMI agent", "JMX agent" oder "SNMP agent" gesetzt ist- unterstützt, wenn der Prototyp der 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 des Prototyps der LLD-Regel. Mindestens ein LLD-Makro ist erforderlich. Verhalten der Eigenschaft: - erforderlich für Erstellungsvorgänge - schreibgeschützt für geerbte Objekte |
| name | string | Name des Prototyps der LLD-Regel. Verhalten der Eigenschaft: - erforderlich für Erstellungsvorgänge - schreibgeschützt für geerbte Objekte |
| type | integer | Typ des Prototyps 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. 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 ähnlich wie beim Trapper-Datenpunkt. Mögliche Werte: 0 - (Standard) Empfang eingehender Daten nicht zulassen; 1 - Empfang eingehender Daten zulassen. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist |
| authtype | integer | Authentifizierungsmethode. Mögliche Werte, wenn type auf "SSH agent" gesetzt ist:0 - (Standard) Passwort; 1 - öffentlicher Schlüssel. Mögliche Werte, wenn type auf "HTTP agent" gesetzt ist:0 - (Standard) keine; 1 - Basic; 2 - NTLM. 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 des Prototyps der LLD-Regel. |
| error | string | Fehlertext, wenn beim Aktualisieren des Werts des Prototyps 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. 1, 60, 300), einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m, 2h, 1d) oder ein Benutzermakro.Standard: 7d. |
| lifetime_type | integer | Szenario zum Löschen verlorener LLD-Ressourcen. Mögliche Werte: 0 - (Standard) Nach Erreichen des Lebensdauergrenzwerts löschen; 1 - Nicht löschen; 2 - Sofort löschen. |
| enabled_lifetime | string | Zeitraum, nach dem Datenpunkte deaktiviert werden, die nicht mehr entdeckt werden. Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300), einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m, 2h, 1d) oder ein Benutzermakro.Standard: 0. |
| enabled_lifetime_type | integer | Szenario zum Deaktivieren verlorener LLD-Ressourcen. Mögliche Werte: 0 - Nach Erreichen des Lebensdauergrenzwerts deaktivieren; 1 - Nicht deaktivieren; 2 - (Standard) Sofort deaktivieren. |
| master_itemid | ID | ID des Master-Datenpunkts. Eine Discovery-Regel kann nicht der Master-Datenpunkt einer anderen Discovery-Regel sein. Verhalten der Eigenschaft: - 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. 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 des Prototyps 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; - Skript für Skript- und Browser-LLD-Regeln. 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)-Anfragekörpers. Verhalten der Eigenschaft: - erforderlich, wenn type auf "HTTP agent" und post_type auf "JSON data" oder "XML data" gesetzt ist- unterstützt, wenn type auf "HTTP agent" und post_type auf "Raw data" gesetzt ist- schreibgeschützt für geerbte Objekte |
| privatekey | string | Name der Datei mit dem privaten Schlüssel. Verhalten der Eigenschaft: - erforderlich, wenn type auf "SSH agent" und authtype auf "public key" gesetzt ist |
| publickey | string | Name der Datei mit dem öffentlichen Schlüssel. Verhalten der Eigenschaft: - erforderlich, wenn type auf "SSH agent" und authtype auf "public key" gesetzt ist |
| query_fields | array | Array von Abfragefeldern, die 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 Anfragemethode. Mögliche Werte: 0 - (Standard) GET; 1 - POST; 2 - PUT; 3 - HEAD. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte |
| retrieve_mode | integer | 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 des Prototyps der LLD-Regel. Mögliche Werte: 0 - (Standard) normal; 1 - nicht unterstützt. Verhalten der Eigenschaft: - schreibgeschützt |
| status | integer | Status des Prototyps der LLD-Regel. Mögliche Werte: 0 - (Standard) aktivierter Prototyp der LLD-Regel; 1 - deaktivierter Prototyp der LLD-Regel. |
| status_codes | string | Durch Kommas getrennte Bereiche erforderlicher HTTP-Statuscodes. Unterstützt auch 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 des übergeordneten LLD-Regelprototyps der Vorlage. Verhalten der Eigenschaft: - schreibgeschützt |
| timeout | string | Zeitüberschreitung für die Abfrage von Datenpunkten. Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300) oder einen Wert mit einem Zeit-Suffix (z. B. 30s, 1m). Akzeptiert außerdem Benutzermakros.Möglicher Wertebereich: 1-600s. Standard: "" - Proxy-/globale Einstellungen verwenden. Verhalten der Eigenschaft: - unterstützt, wenn type auf "Zabbix agent" (0), "Simple check" (3) gesetzt ist und key_ nicht mit "vmware." und "icmpping" beginnt, "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) und snmp_oid mit "walk[" oder "get[" beginnt, "Script" (21) 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.Wenn die Eigenschaft nicht angegeben wird, wird sie automatisch auf das Benutzermakro {$TRAPPER.ALLOWED_HOSTS} (Standardwert) gesetzt. Standardmäßig ist {$TRAPPER.ALLOWED_HOSTS} 127.0.0.1,::1.Wenn die Eigenschaft auf eine leere Zeichenfolge gesetzt ist, werden eingehende Verbindungen von allen Hosts abgelehnt. |
| username | string | Benutzername für die Authentifizierung. Verhalten der Eigenschaft: - erforderlich, wenn type auf "SSH agent" oder "TELNET agent" gesetzt ist oder wenn type auf "JMX agent" und password 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 verwendet wird, um importierte Prototypen von LLD-Regeln mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn er nicht angegeben wird. Verhalten der Eigenschaft: - unterstützt, wenn der Prototyp der LLD-Regel zu einer Vorlage gehört |
| verify_host | integer | Gibt an, ob überprüft werden soll, dass der Hostname der 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 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. Verhalten der Eigenschaft: - erforderlich |
| value | string | Wert des Headers. Verhalten der Eigenschaft: - 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 |
Filter für LLD-Regelprototypen
Das Filterobjekt für LLD-Regelprototypen definiert eine Reihe von Bedingungen, die zum Filtern entdeckter Objekte verwendet werden können. Es hat die folgenden Eigenschaften:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| 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. Verhalten der Eigenschaft: - erforderlich |
| evaltype | integer | Auswertungsmethode der Filterbedingung. 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 von Filterbedingungen verwendet wird. Der Ausdruck enthält IDs, die bestimmte Filterbedingungen über ihre formulaid referenzieren. Der Wert von eval_formula entspricht dem Wert von formula für Filter mit einem benutzerdefinierten Ausdruck.Verhalten der Eigenschaft: - schreibgeschützt |
| formula | string | Benutzerdefinierter Ausdruck, der zur Auswertung von Bedingungen von Filtern mit einem benutzerdefinierten Ausdruck verwendet wird. Der Ausdruck muss IDs enthalten, die bestimmte Filterbedingungen über ihre formulaid referenzieren. Die im Ausdruck verwendeten IDs müssen exakt mit den in den Filterbedingungen 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-Regelprototypen
Das Objekt für die Filterbedingung eines LLD-Regelprototyps definiert eine separate Prüfung, die für den Wert eines LLD-Makros durchgeführt wird. Es hat die folgenden Eigenschaften:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| macro | string | LLD-Makro, für das die Prüfung durchgeführt wird. Verhalten der Eigenschaft: - erforderlich |
| value | string | Wert, mit dem verglichen wird. Verhalten der Eigenschaft: - erforderlich, wenn operator auf „entspricht regulärem Ausdruck“ oder „entspricht nicht regulärem Ausdruck“ gesetzt ist |
| formulaid | string | Beliebige eindeutige ID, die verwendet wird, um aus einem benutzerdefinierten Ausdruck auf die Bedingung zu verweisen. Sie 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. Verhalten der Eigenschaft: - erforderlich, wenn evaltype des Objekts Filter für LLD-Regelprototypen auf „benutzerdefinierter Ausdruck“ gesetzt ist |
| 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 Seiten der Methoden discoveryruleprototype.get und discoveryruleprototype.create.
LLD-Makropfad
Der LLD-Makropfad hat die folgenden Eigenschaften:
| Eigenschaft | Type | 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 des LLD-Regelprototyps
Das Vorverarbeitungsobjekt des LLD-Regelprototyps 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 keinem 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; 24 - CSV in JSON; 25 - Ersetzen; 27 - XML in JSON; 28 - SNMP-Walk-Wert; 29 - SNMP-Walk in JSON; 30 - SNMP-Get-Wert. Verhalten der Eigenschaft: - erforderlich |
| params | string | Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden. Mehrere Parameter werden durch das 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 keinem 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“ (23), „CSV in JSON“ (24), „Ersetzen“ (25), „SNMP-Walk-Wert“ (28), „SNMP-Walk in JSON“ (29) oder „SNMP-Get-Wert“ (30) gesetzt ist |
| error_handler | integer | Aktionstyp, der bei einem Fehler in einem Vorverarbeitungsschritt verwendet wird. Mögliche Werte: 0 - Fehlermeldung wird vom Zabbix Server festgelegt; 1 - Wert verwerfen; 2 - Benutzerdefinierten Wert festlegen; 3 - Benutzerdefinierte Fehlermeldung festlegen. Verhalten der Eigenschaft: - erforderlich, wenn type auf „Regulärer Ausdruck“ (5), „XML XPath“ (11), „JSONPath“ (12), „Entspricht regulärem Ausdruck“ (14), „Entspricht keinem regulären Ausdruck“ (15), „Auf Fehler in JSON prüfen“ (16), „Auf Fehler in XML prüfen“ (17), „Prometheus in JSON“ (23), „CSV in JSON“ (24), „XML in JSON“ (27), „SNMP-Walk-Wert“ (28), „SNMP-Walk in JSON“ (29) oder „SNMP-Get-Wert“ (30) gesetzt ist |
| error_handler_params | string | Parameter des Fehlerhandlers. Verhalten der Eigenschaft: - erforderlich, wenn error_handler auf „Benutzerdefinierten Wert festlegen“ oder „Benutzerdefinierte Fehlermeldung festlegen“ gesetzt ist |
Die folgenden Parameter und Fehlerhandler werden für jeden Vorverarbeitungstyp unterstützt.
| Vorverarbeitungstyp | Name | Parameter 1 | Parameter 2 | Parameter 3 | Unterstützte Fehlerhandler |
|---|---|---|---|---|---|
| 5 | Regulärer Ausdruck | 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 keinem 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 | pattern5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV in JSON | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | Ersetzen | search string2 | replacement2 | ||
| 27 | XML in JSON | 0, 1, 2, 3 | |||
| 28 | SNMP-Walk-Wert | OID2 | Format: 0 - Unverändert 1 - UTF-8 aus Hex-STRING 2 - MAC aus Hex-STRING 3 - Integer aus BITS |
0, 1, 2, 3 | |
| 29 | SNMP-Walk in 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-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, Labelname, Labelwert und Metrikwert)
kann ein Benutzermakro sein.
7 Unterstützt mehrere durch ein Zeilenumbruchzeichen getrennte Datensätze im Format „Field name,OID prefix,Format“.
Überschreibungen von LLD-Regelprototypen
Das Objekt für Überschreibungen von LLD-Regelprototypen 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 Name der Überschreibung. Property behavior: - required |
| step | integer | Eindeutige Reihenfolgenummer der Überschreibung. Property behavior: - required |
| 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. |
Filter für Überschreibungen von LLD-Regelprototypen
Das Filterobjekt für Überschreibungen von LLD-Regelprototypen definiert eine Reihe von Bedingungen, bei deren Übereinstimmung mit dem erkannten Objekt die Überschreibung angewendet wird. Es hat die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| 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. Property behavior: - required |
| evaltype | integer | Auswertungsmethode der Bedingungen des Überschreibungsfilters. Mögliche Werte: 0 - Und/Oder; 1 - Und; 2 - Oder; 3 - Benutzerdefinierter Ausdruck. Property behavior: - required |
| 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.Property behavior: - read-only |
| formula | string | Benutzerdefinierter Ausdruck zur Auswertung der Bedingungen von Überschreibungsfiltern mit einem benutzerdefinierten Ausdruck. 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.Property behavior: - required if evaltype is set to "custom expression" |
Filterbedingung für die Überschreibung von LLD-Regelprototypen
Das Objekt für die Filterbedingung der Überschreibung von LLD-Regelprototypen definiert eine separate Prüfung, die für den Wert eines LLD-Makros durchgeführt wird. Es hat die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| macro | string | LLD-Makro, für das die Prüfung durchgeführt wird. Property behavior: - required |
| value | string | Wert für den Vergleich. 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 prototype 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. |
Überschreibungsoperation für LLD-Regelprototypen
Die Überschreibungsoperation für LLD-Regelprototypen ist eine Kombination aus Bedingungen und Aktionen, die für das 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. Property behavior: - required |
| operator | integer | Operator der Überschreibungsbedingung. 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 Überschreibungsoperation für Datenpunkt-, Auslöser- und Host-Prototyp-Objekte. |
| opdiscover | object | Objekt für den Erkennungsstatus der Überschreibungsoperation (alle Objekttypen). |
| opperiod | object | Objekt für den Zeitraum (Aktualisierungsintervall) der Überschreibungsoperation für Datenpunkt-Prototyp-Objekte. |
| ophistory | object | Verlaufsobjekt der Überschreibungsoperation für Datenpunkt-Prototyp-Objekte. |
| optrends | object | Trendobjekt der Überschreibungsoperation für Datenpunkt-Prototyp-Objekte. |
| opseverity | object | Schweregradobjekt der Überschreibungsoperation für Auslöser-Prototyp-Objekte. |
| optag | object/array | Tag-Objekt der Überschreibungsoperation für Auslöser- und Host-Prototyp-Objekte. |
| optemplate | object/array | Vorlagenobjekt der Überschreibungsoperation für Host-Prototyp-Objekte. |
| opinventory | object | Inventarobjekt der Überschreibungsoperation für Host-Prototyp-Objekte. |
Status der Überschreibungsoperation des LLD-Regelprototyps
Status der Überschreibungsoperation des LLD-Regelprototyps, der für das entdeckte Objekt festgelegt wird. Er hat die folgenden Eigenschaften:
| Property | Type | Beschreibung |
|---|---|---|
| status | integer | Überschreibt den Status für das ausgewählte Objekt. Mögliche Werte: 0 - Aktiviert erstellen; 1 - Deaktiviert erstellen. Property behavior: - erforderlich |
LLD-Regelprototyp-Override-Operation „discover“
Der „discover“-Status der Override-Operation eines LLD-Regelprototyps wird für das als entdeckt gesetzte Objekt verwendet. Er hat die folgenden Eigenschaften:
| Eigenschaft | Type | Beschreibung |
|---|---|---|
| discover | integer | Überschreibt den „discover“-Status für das ausgewählte Objekt. Mögliche Werte: 0 - Ja, die Objekte weiterhin entdecken; 1 - Nein, neue Objekte werden nicht entdeckt und bestehende werden als verloren markiert. Property behavior: - erforderlich |
Betriebszeitraum der LLD-Regelprototypüberschreibung
Der Betriebszeitraum der LLD-Regelprototypüberschreibung 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 Datenpunktprototyps. 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 Kombination aus flexiblen Intervallen und Zeitplanintervallen sein.Akzeptiert Benutzermakros oder LLD-Makros. Bei Verwendung muss der Wert aus einem einzelnen Makro bestehen. Mehrere Makros oder Makros in Kombination mit Text werden nicht unterstützt. Flexible Intervalle können als zwei durch einen Schrägstrich getrennte Makros geschrieben werden (z. B. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Beispiel: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Verhalten der Eigenschaft: - required |
Verlauf der Überschreibungsoperation des LLD-Regelprototyps
Wert der Überschreibungsoperation des LLD-Regelprototyps, der für den erkannten Datenpunkt festgelegt wird. Er hat die folgenden Eigenschaften:
| Eigenschaft | Type | Beschreibung |
|---|---|---|
| history | string | Überschreibt den Verlauf des Datenpunktprototyps, also die Zeiteinheit dafür, wie lange die Verlaufsdaten gespeichert werden sollen. Akzeptiert auch Benutzermakro und LLD-Makro. Property behavior: - erforderlich |
Trends der Überschreibungsoperation von LLD-Regelprototypen
Der Wert der Trends der Überschreibungsoperation von LLD-Regelprototypen wird für den erkannten Datenpunkt festgelegt. Er hat die folgenden Eigenschaften:
| Eigenschaft | Type | Beschreibung |
|---|---|---|
| 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 für LLD-Regelprototypen
Wert des Schweregrads der Überschreibungsoperation für LLD-Regelprototypen, der für den erkannten Auslöser festgelegt wird. Er hat die folgenden Eigenschaften:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| severity | integer | Überschreibt den Schweregrad des Auslöserprototyps. Mögliche Werte: 0 - (Standard) nicht klassifiziert; 1 - Information; 2 - Warnung; 3 - durchschnittlich; 4 - hoch; 5 - Katastrophe. Verhalten der Eigenschaft: - erforderlich |
Tag einer Überschreibungsoperation für LLD-Regelprototypen
Das Tag-Objekt einer Überschreibungsoperation für LLD-Regelprototypen enthält den Tag-Namen und den Wert, die für das erkannte Objekt gesetzt 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 des LLD-Regelprototyps
Objekt der Vorlage für die Überschreibungsoperation des LLD-Regelprototyps, das mit dem erkannten Host verknüpft ist. Es hat die folgenden Eigenschaften:
| Eigenschaft | Type | Beschreibung |
|---|---|---|
| templateid | ID | Überschreibt die Vorlage der verknüpften Vorlagen des Host-Prototyps. Verhalten der Eigenschaft: - erforderlich |
Inventar des Überschreibungsvorgangs für LLD-Regelprototypen
Wert des Inventarmodus für den Überschreibungsvorgang eines LLD-Regelprototyps, der für den erkannten Host festgelegt wird. Er hat die folgenden Eigenschaften:
| Eigenschaft | Type | Beschreibung |
|---|---|---|
| inventory_mode | integer | Den Inventarmodus des Host-Prototyps überschreiben. Mögliche Werte: -1 - deaktiviert; 0 - (Standard) manuell; 1 - automatisch. Verhalten der Eigenschaft: - erforderlich |