Item Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der item API.
Datenpunkt
Web-Datenpunkte können nicht direkt über die Zabbix-API erstellt, aktualisiert oder gelöscht werden.
Das Datenpunktobjekt verfügt über die folgenden Eigenschaften.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| itemid | ID | ID des Datenpunkts. Verhalten der Eigenschaft: - schreibgeschützt - erforderlich für Aktualisierungsvorgänge |
| delay | string | Aktualisierungsintervall des Datenpunkts. 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. 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), "Calculated" (15), "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 oder der Vorlage, zu dem bzw. der der Datenpunkt gehört. Verhalten der Eigenschaft: - konstant - erforderlich für Erstellungsvorgänge |
| interfaceid | ID | ID der Host-Schnittstelle des Datenpunkts. Verhalten der Eigenschaft: - erforderlich, wenn der Datenpunkt zu einem Host gehört und type auf "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap" oder "SNMP agent" gesetzt ist- unterstützt, wenn der Datenpunkt zu einem Host gehört und type auf "Simple check", "External check", "SSH agent", "TELNET agent" oder "HTTP agent" gesetzt ist- schreibgeschützt für ermittelte Objekte |
| key_ | string | Schlüssel des Datenpunkts. Verhalten der Eigenschaft: - erforderlich für Erstellungsvorgänge - schreibgeschützt für geerbte oder ermittelte Objekte |
| name | string | Name des Datenpunkts. Unterstützt Benutzermakros. Verhalten der Eigenschaft: - erforderlich für Erstellungsvorgänge - schreibgeschützt für geerbte oder ermittelte Objekte |
| name_resolved | string | Name des Datenpunkts mit aufgelösten Benutzermakros. Verhalten der Eigenschaft: - schreibgeschützt |
| type | integer | Typ des Datenpunkts. Mögliche Werte: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - Simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 9 - Web item; 10 - External check; 11 - Database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 15 - Calculated; 16 - JMX agent; 17 - SNMP trap; 18 - Dependent item; 19 - HTTP agent; 20 - SNMP agent; 21 - Script; 22 - Browser. Verhalten der Eigenschaft: - erforderlich für Erstellungsvorgänge - schreibgeschützt für geerbte oder ermittelte 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 oder ermittelte Objekte |
| value_type | integer | Informationstyp des Datenpunkts. Mögliche Werte: 0 - numerischer Gleitkommawert; 1 - Zeichen; 2 - Protokoll; 3 - numerischer Ganzzahlwert ohne Vorzeichen; 4 - Text; 5 - Binärdaten; 6 - JSON. Verhalten der Eigenschaft: - erforderlich für Erstellungsvorgänge - schreibgeschützt für geerbte oder ermittelte Objekte |
| allow_traps | integer | Erlaubt das Befüllen des Werts analog zum Trapper-Datenpunkt. 0 - (Standard) Keine Annahme eingehender Daten erlauben; 1 - Annahme eingehender Daten erlauben. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für ermittelte Objekte |
| 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) oder ermittelte Objekte |
| description | string | Beschreibung des Datenpunkts. Verhalten der Eigenschaft: - schreibgeschützt für ermittelte Objekte |
| error | string | Fehlertext, wenn beim Aktualisieren des Datenpunktwerts Probleme auftreten. Verhalten der Eigenschaft: - schreibgeschützt |
| flags | integer | Ursprung des Datenpunkts. Mögliche Werte: 0 - ein normaler Datenpunkt; 4 - ein aus einem Prototyp konvertierter Datenpunkt. 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 oder ermittelte Objekte |
| headers | array | Array von Headern, die beim Ausführen einer HTTP-Anfrage gesendet werden. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| history | string | Zeiteinheit für die Dauer der Speicherung von Verlaufsdaten. Akzeptiert auch ein Benutzermakro. Standard: 31d. Verhalten der Eigenschaft: - schreibgeschützt für ermittelte 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 oder ermittelte Objekte |
| inventory_link | integer | ID des Hostinventarfelds, das durch den Datenpunkt befüllt wird. Eine Liste der unterstützten Hostinventarfelder und ihrer IDs finden Sie auf der Hostinventarseite. Standard: 0. Verhalten der Eigenschaft: - unterstützt, wenn value_type auf "numeric float", "character", "numeric unsigned" oder "text" gesetzt ist- schreibgeschützt für ermittelte Objekte |
| ipmi_sensor | string | IPMI-Sensor. Verhalten der Eigenschaft: - erforderlich, wenn type auf "IPMI agent" gesetzt und key_ nicht auf "ipmi.get" gesetzt ist- unterstützt, wenn type auf "IPMI agent" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| jmx_endpoint | string | Benutzerdefinierte Verbindungszeichenfolge des JMX agent. Standardwert: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Verhalten der Eigenschaft: - unterstützt, wenn type auf "JMX agent" gesetzt ist- schreibgeschützt für ermittelte Objekte |
| lastclock | timestamp | Zeitpunkt der letzten Aktualisierung des Datenpunktwerts. Standardmäßig werden nur Werte angezeigt, die innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration > General ändern. Verhalten der Eigenschaft: - schreibgeschützt |
| lastns | integer | Nanosekunden der letzten Aktualisierung des Datenpunktwerts. Standardmäßig werden nur Werte angezeigt, die innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration > General ändern. Verhalten der Eigenschaft: - schreibgeschützt |
| lastvalue | string | Letzter Wert des Datenpunkts. Standardmäßig werden nur Werte angezeigt, die innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration > General ändern. Verhalten der Eigenschaft: - schreibgeschützt |
| logtimefmt | string | Zeitformat in Protokolleinträgen. Verhalten der Eigenschaft: - unterstützt, wenn value_type auf "log" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| master_itemid | ID | ID des Master-Datenpunkts. Verhalten der Eigenschaft: - erforderlich, wenn type auf "Dependent item" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| output_format | integer | Gibt an, ob die Antwort in JSON konvertiert werden soll. 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 oder ermittelte Objekte |
| params | string | Zusätzliche Parameter abhängig vom Typ des Datenpunkts: - ausgeführtes Skript für Datenpunkte vom Typ SSH agent und TELNET agent; - SQL-Abfrage für Datenpunkte vom Typ Database monitor; - Formel für berechnete Datenpunkte; - Skript für Datenpunkte vom Typ Script und Browser. Verhalten der Eigenschaft: - erforderlich, wenn type auf "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script" oder "Browser" gesetzt ist- schreibgeschützt für geerbte Objekte (wenn type auf "Script" oder "Browser" gesetzt ist) oder ermittelte Objekte |
| 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 oder ermittelte Objekte |
| password | string | Passwort für die Authentifizierung. Verhalten der Eigenschaft: - erforderlich, wenn type auf "JMX agent" gesetzt und username angegeben ist- unterstützt, wenn type auf "Simple check", "SSH agent", "TELNET agent", "Database monitor" oder "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte (wenn type auf "HTTP agent" gesetzt ist) oder ermittelte Objekte |
| post_type | integer | Typ des im Attribut posts gespeicherten Post-Datenkörpers.Mögliche Werte: 0 - (Standard) Rohdaten; 2 - JSON-Daten; 3 - XML-Daten. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| posts | string | HTTP(S)-Anfragedatenkörper. 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 oder ermittelte Objekte |
| prevvalue | string | Vorheriger Wert des Datenpunkts. Standardmäßig werden nur Werte angezeigt, die innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration > General ändern. Verhalten der Eigenschaft: - schreibgeschützt |
| 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- schreibgeschützt für ermittelte Objekte |
| 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- schreibgeschützt für ermittelte Objekte |
| query_fields | array | Array von Abfragefeldern, die beim Ausführen einer HTTP-Anfrage gesendet werden. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte oder ermittelte 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 oder ermittelte 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 oder ermittelte Objekte |
| snmp_oid | string | SNMP-OID. Verhalten der Eigenschaft: - erforderlich, wenn type auf "SNMP agent" gesetzt ist- schreibgeschützt für geerbte oder ermittelte 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 oder ermittelte 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 oder ermittelte 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 oder ermittelte Objekte |
| state | integer | Status des Datenpunkts. Mögliche Werte: 0 - (Standard) normal; 1 - nicht unterstützt. Verhalten der Eigenschaft: - schreibgeschützt |
| status | integer | Status des Datenpunkts. Mögliche Werte: 0 - (Standard) aktivierter Datenpunkt; 1 - deaktivierter Datenpunkt. |
| status_codes | string | Bereiche erforderlicher HTTP-Statuscodes, durch Kommas getrennt. 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 oder ermittelte Objekte |
| templateid | ID | ID des Datenpunkts der übergeordneten Vorlage. Hinweis: Verwenden Sie die Eigenschaft hostid, um die Vorlage anzugeben, zu der der Datenpunkt gehört.Verhalten der Eigenschaft: - schreibgeschützt |
| timeout | string | Zeitüberschreitung für die Datenabrufanfrage des Datenpunkts. Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300) oder einen Wert mit einem Zeitsuffix (z. B. 300s, 1m). Akzeptiert auch Benutzermakros.Möglicher Wertebereich: 1-600s. Standard: "" - Proxy-/globale Einstellungen verwenden. Verhalten der Eigenschaft: - unterstützt, wenn type auf "Zabbix agent" (0), "Simple check" (3) gesetzt ist und key_ nicht mit "vmware." 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, sowie bei "Script" (21) oder "Browser" (22)- schreibgeschützt für geerbte und ermittelte Objekte |
| trapper_hosts | string | Zulässige Hosts. Verhalten der Eigenschaft: - schreibgeschützt für ermittelte Objekte - unterstützt, wenn type auf "Zabbix trapper" gesetzt ist oder wenn type auf "HTTP agent" und allow_traps auf "Allow to accept incoming data" gesetzt ist.Wenn die Eigenschaft nicht angegeben wird, wird sie automatisch auf das Benutzermakro {$TRAPPER.ALLOWED_HOSTS} (Standardwert) gesetzt. Standardmäßig lautet {$TRAPPER.ALLOWED_HOSTS} 127.0.0.1,::1.Wenn die Eigenschaft auf eine leere Zeichenfolge gesetzt ist, werden eingehende Verbindungen von allen Hosts abgewiesen. |
| trends | string | Zeiteinheit für die Dauer der Speicherung von Trenddaten. Akzeptiert auch ein Benutzermakro. Standard: 365d. Verhalten der Eigenschaft: - unterstützt, wenn value_type auf "numeric float" oder "numeric unsigned" gesetzt ist- schreibgeschützt für ermittelte Objekte |
| units | string | Werteinheiten. Verhalten der Eigenschaft: - unterstützt, wenn value_type auf "numeric float" oder "numeric unsigned" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| 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 angegeben 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) oder ermittelte Objekte |
| uuid | string | Universell eindeutiger Bezeichner, der zum Verknüpfen eines importierten Datenpunkts mit bereits vorhandenen Datenpunkten verwendet wird. Wird automatisch generiert, wenn er nicht angegeben ist. Verhalten der Eigenschaft: - unterstützt, wenn der Datenpunkt zu einer Vorlage gehört |
| valuemapid | ID | ID der zugehörigen Wertzuordnung. Verhalten der Eigenschaft: - unterstützt, wenn value_type auf "numeric float", "character" oder "numeric unsigned" gesetzt ist- schreibgeschützt für geerbte oder ermittelte Objekte |
| verify_host | integer | Gibt an, ob überprüft werden soll, dass der Hostname der Verbindung mit dem Hostnamen im Zertifikat des Hosts übereinstimmt. Mögliche Werte: 0 - (Standard) Nicht überprüfen; 1 - Überprüfen. Verhalten der Eigenschaft: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte oder ermittelte 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 oder ermittelte 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 | Parameterwert. Eigenschaftsverhalten: - erforderlich |
Datenpunkt-Tag
Das Datenpunkt-Tag-Objekt hat die folgenden Eigenschaften.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| tag | string | Name des Datenpunkt-Tags. Verhalten der Eigenschaft: - erforderlich |
| value | string | Wert des Datenpunkt-Tags. Verhalten der Eigenschaft: - schreibgeschützt. |
| object | integer | Typ des Objekts, von dem das Tag geerbt wurde. Mögliche Werte: 0 - Vorlage; 1 - Host. Verhalten der Eigenschaft: - schreibgeschützt. |
| objectid | ID | ID des Objekts, von dem das Tag geerbt wurde. Verhalten der Eigenschaft: - schreibgeschützt. |
Datenpunkt-Vorverarbeitung
Das Objekt für die Datenpunkt-Vorverarbeitung verfügt über die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| type | integer | Der Typ der Vorverarbeitungsoption. Mögliche Werte: 1 - Benutzerdefinierter Multiplikator; 2 - Rechts trimmen; 3 - Links trimmen; 4 - Trimmen; 5 - Regulärer Ausdruck; 6 - Boolesch in Dezimalzahl; 7 - Oktal in Dezimalzahl; 8 - Hexadezimal in Dezimalzahl; 9 - Einfache Änderung; 10 - Änderung pro Sekunde; 11 - XML XPath; 12 - JSONPath; 13 - Im Bereich; 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; 18 - Mit regulärem Ausdruck auf Fehler prüfen; 19 - Unveränderte Werte verwerfen; 20 - Unveränderte Werte mit Heartbeat verwerfen; 21 - JavaScript; 22 - Prometheus-Muster; 23 - Prometheus in JSON; 24 - CSV in JSON; 25 - Ersetzen; 26 - Nicht unterstützt prüfen; 27 - XML in JSON; 28 - SNMP-Walk-Wert; 29 - SNMP-Walk in JSON; 30 - SNMP-Get-Wert. Property behavior: - required |
| params | string | Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden. Mehrere Parameter werden durch das Zeilenumbruchzeichen (\n) getrennt. Wenn type auf „Nicht unterstützt prüfen“ gesetzt ist, folgen die Parameter der Syntax <scope>[\n<pattern>], wobei pattern ein regulärer Ausdruck ist und scope einem der folgenden Werte entspricht:-1 - auf jeden Fehler zutreffen; \ 0 - prüfen, ob die Fehlermeldung mit pattern übereinstimmt; \ 1 - prüfen, ob die Fehlermeldung nicht mit pattern übereinstimmt. Property behavior: - required, wenn type auf „Benutzerdefinierter Multiplikator“ (1), „Rechts trimmen“ (2), „Links trimmen“ (3), „Trimmen“ (4), „Regulärer Ausdruck“ (5), „XML XPath“ (11), „JSONPath“ (12), „Im Bereich“ (13), „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), „Mit regulärem Ausdruck auf Fehler prüfen“ (18), „Unveränderte Werte mit Heartbeat verwerfen“ (20), „JavaScript“ (21), „Prometheus-Muster“ (22), „Prometheus in JSON“ (23), „CSV in JSON“ (24), „Ersetzen“ (25), Nicht unterstützt prüfen (26), „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. Mögliche Werte, wenn type auf „Nicht unterstützt prüfen“ gesetzt ist:1 - Wert verwerfen; 2 - Benutzerdefinierten Wert festlegen; 3 - Benutzerdefinierte Fehlermeldung festlegen. Property behavior: - required, wenn type auf „Benutzerdefinierter Multiplikator“ (1), „Regulärer Ausdruck“ (5), „Boolesch in Dezimalzahl“ (6), „Oktal in Dezimalzahl“ (7), „Hexadezimal in Dezimalzahl“ (8), „Einfache Änderung“ (9), „Änderung pro Sekunde“ (10), „XML XPath“ (11), „JSONPath“ (12), „Im Bereich“ (13), „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), „Mit regulärem Ausdruck auf Fehler prüfen“ (18), „Prometheus-Muster“ (22), „Prometheus in JSON“ (23), „CSV in JSON“ (24), „Nicht unterstützt prüfen“ (26), „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. Property behavior: - required, 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.
| Preprocessing type | Name | Parameter 1 | Parameter 2 | Parameter 3 | Supported error handlers |
|---|---|---|---|---|---|
| 1 | Benutzerdefinierter Multiplikator | number1, 6 | 0, 1, 2, 3 | ||
| 2 | Rechts trimmen | Liste von Zeichen2 | |||
| 3 | Links trimmen | Liste von Zeichen2 | |||
| 4 | Trimmen | Liste von Zeichen2 | |||
| 5 | Regulärer Ausdruck | pattern3 | output2 | 0, 1, 2, 3 | |
| 6 | Boolesch in Dezimalzahl | 0, 1, 2, 3 | |||
| 7 | Oktal in Dezimalzahl | 0, 1, 2, 3 | |||
| 8 | Hexadezimal in Dezimalzahl | 0, 1, 2, 3 | |||
| 9 | Einfache Änderung | 0, 1, 2, 3 | |||
| 10 | Änderung pro Sekunde | 0, 1, 2, 3 | |||
| 11 | XML XPath | path4 | 0, 1, 2, 3 | ||
| 12 | JSONPath | path4 | 0, 1, 2, 3 | ||
| 13 | Im Bereich | min1, 6 | max1, 6 | 0, 1, 2, 3 | |
| 14 | Entspricht regulärem Ausdruck | pattern3 | 0, 1, 2, 3 | ||
| 15 | Entspricht nicht regulärem Ausdruck | pattern3 | 0, 1, 2, 3 | ||
| 16 | Auf Fehler in JSON prüfen | path4 | 0, 1, 2, 3 | ||
| 17 | Auf Fehler in XML prüfen | path4 | 0, 1, 2, 3 | ||
| 18 | Mit regulärem Ausdruck auf Fehler prüfen | pattern3 | output2 | 0, 1, 2, 3 | |
| 19 | Unveränderte Werte verwerfen | ||||
| 20 | Unveränderte Werte mit Heartbeat verwerfen | seconds5, 6 | |||
| 21 | JavaScript | script2 | |||
| 22 | Prometheus-Muster | pattern6, 7 | value, label, function |
output8, 9 | 0, 1, 2, 3 |
| 23 | Prometheus in JSON | pattern6, 7 | 0, 1, 2, 3 | ||
| 24 | CSV in JSON | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | Ersetzen | search string2 | replacement2 | ||
| 26 | Nicht unterstützt prüfen | scope1 | pattern3, 6 | 1, 2, 3 | |
| 27 | XML in JSON | 0, 1, 2, 3 | |||
| 28 | SNMP-Walk-Wert | OID2 | Format: 0 - Unverändert 1 - UTF-8 aus Hex-STRING 2 - MAC aus Hex-STRING 3 - Ganzzahl aus BITS |
0, 1, 2, 3 | |
| 29 | SNMP-Walk in JSON10 | Field name2 | OID prefix2 | Format: 0 - Unverändert 1 - UTF-8 aus Hex-STRING 2 - MAC aus Hex-STRING 3 - Ganzzahl aus BITS |
0, 1, 2, 3 |
| 30 | SNMP-Get-Wert | Format: 1 - UTF-8 aus Hex-STRING 2 - MAC aus Hex-STRING 3 - Ganzzahl aus BITS |
0, 1, 2, 3 | ||
1 Gleitkommazahl (Ganzzahlen werden implizit in Gleitkommawerte konvertiert)
2 Zeichenfolge
3 regulärer Ausdruck
4 JSONPath oder XML XPath
5 positive Ganzzahl (mit Unterstützung von Zeitsuffixen, z. B. 30s, 1m, 2h, 1d)
6 Benutzermakro
7 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.
8 Prometheus-Ausgabe gemäß der Syntax: <label name> (kann ein Benutzermakro sein), wenn label als zweiter Parameter ausgewählt ist.
9 Eine der Aggregationsfunktionen: sum, min, max, avg, count, wenn function als zweiter Parameter ausgewählt ist.
10 Unterstützt mehrere durch ein Zeilenumbruchzeichen getrennte Datensätze im Format „Field name,OID prefix,Format“.