Item Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der item API.
Item
Web-Items können nicht direkt über die Zabbix API erstellt, aktualisiert oder gelöscht werden.
Das Item-Objekt hat die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| itemid | ID | ID des Datenpunkts. Property behavior: - schreibgeschützt - erforderlich für Aktualisierungsvorgänge |
| delay | string | Aktualisierungsintervall des Datenpunkts. Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional ein oder mehrere benutzerdefinierte Intervalle, alle durch Semikolons getrennt. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und 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), "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 der der Datenpunkt gehört. Property behavior: - konstant - erforderlich für Erstellungsoperationen |
| interfaceid | ID | ID der Host-Schnittstelle des Datenpunkts. Property behavior: - 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 erkannte Objekte |
| key_ | string | Schlüssel des Datenpunkts. Property behavior: - erforderlich für Erstellungsoperationen - schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| name | string | Name des Datenpunkts. Unterstützt Benutzermakros. Property behavior: - erforderlich für Erstellungsoperationen - schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| name_resolved | string | Name des Datenpunkts mit aufgelösten Benutzermakros. Property behavior: - 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. Property behavior: - erforderlich für Erstellungsoperationen - schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| url | string | URL-Zeichenfolge. Unterstützt Benutzermakros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}. Property behavior: - erforderlich, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| value_type | integer | Informationstyp des Datenpunkts. Mögliche Werte: 0 - numerisch, Fließkomma; 1 - Zeichen; 2 - Log; 3 - numerisch, vorzeichenlos; 4 - Text; 5 - binär. Property behavior: - erforderlich für Erstellungsoperationen - schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| allow_traps | integer | Erlaubt das Befüllen des Werts ähnlich wie beim Trapper-Datenpunkt. 0 - (Standard) Eingehende Daten nicht akzeptieren; 1 - Eingehende Daten akzeptieren. Property behavior: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für erkannte 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. 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) oder erkannte Objekte |
| description | string | Beschreibung des Datenpunkts. Property behavior: - schreibgeschützt für erkannte Objekte |
| error | string | Fehlertext, wenn beim Aktualisieren des Datenpunktwerts Probleme auftreten. Property behavior: - schreibgeschützt |
| flags | integer | Ursprung des Datenpunkts. Mögliche Werte: 0 - ein normaler Datenpunkt; 4 - ein erkannter Datenpunkt. Property behavior: - schreibgeschützt |
| follow_redirects | integer | Weiterleitungen der Antwort 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 oder erkannte 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 oder erkannte Objekte |
| history | string | Zeiteinheit, wie lange die Verlaufsdaten gespeichert werden sollen. Akzeptiert auch Benutzermakros. Standard: 31d. Property behavior: - schreibgeschützt für erkannte Objekte |
| http_proxy | string | HTTP(S)-Proxy-Verbindungszeichenfolge. Property behavior: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| inventory_link | integer | ID des Host-Inventarfelds, das vom Datenpunkt befüllt wird. Eine Liste der unterstützten Host-Inventarfelder und ihrer IDs finden Sie auf der Host-Inventarseite. Standard: 0. Property behavior: - unterstützt, wenn value_type auf "numerisch, Fließkomma", "Zeichen", "numerisch, vorzeichenlos" oder "Text" gesetzt ist- schreibgeschützt für erkannte 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 oder erkannte Objekte |
| jmx_endpoint | string | Benutzerdefinierte Verbindungszeichenfolge des JMX agent. Standardwert: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Property behavior: - unterstützt, wenn type auf "JMX agent" gesetzt ist- schreibgeschützt für erkannte Objekte |
| lastclock | timestamp | Zeitpunkt, zu dem der Wert des Datenpunkts zuletzt aktualisiert wurde. Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration → General ändern. Property behavior: - schreibgeschützt |
| lastns | integer | Nanosekunden, zu denen der Wert des Datenpunkts zuletzt aktualisiert wurde. Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration → General ändern. Property behavior: - schreibgeschützt |
| lastvalue | string | Letzter Wert des Datenpunkts. Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration → General ändern. Property behavior: - schreibgeschützt |
| logtimefmt | string | Format der Zeit in Logeinträgen. Property behavior: - unterstützt, wenn value_type auf "log" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| master_itemid | ID | ID des Master-Datenpunkts. Rekursion bis zu 3 abhängige Datenpunkte und eine maximale Anzahl abhängiger Datenpunkte von 29999 sind zulässig. Property behavior: - erforderlich, wenn type auf "Dependent item" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| output_format | integer | Soll die Antwort in JSON konvertiert werden. 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 oder erkannte 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; - das Skript für Datenpunkte vom Typ Script und Browser. Property behavior: - 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 erkannte 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.Property behavior: - unterstützt, wenn type auf "Script" oder "Browser" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte 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", "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 erkannte Objekte |
| post_type | integer | Typ des in der Eigenschaft posts gespeicherten Post-Dateninhalts.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 oder erkannte Objekte |
| posts | string | HTTP(S)-Anfragedaten des Nachrichtentexts. 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 oder erkannte Objekte |
| prevvalue | string | Vorheriger Wert des Datenpunkts. Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters Max history display period im Menübereich Administration → General ändern. Property behavior: - schreibgeschützt |
| 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- schreibgeschützt für erkannte Objekte |
| 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- schreibgeschützt für erkannte Objekte |
| 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 oder erkannte 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 oder erkannte 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 oder erkannte Objekte |
| snmp_oid | string | SNMP-OID. Property behavior: - erforderlich, wenn type auf "SNMP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte 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 oder erkannte 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 oder erkannte 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 oder erkannte Objekte |
| state | integer | Status des Datenpunkts. Mögliche Werte: 0 - (Standard) normal; 1 - nicht unterstützt. Property behavior: - schreibgeschützt |
| status | integer | Status des Datenpunkts. Mögliche Werte: 0 - (Standard) aktivierter Datenpunkt; 1 - deaktivierter Datenpunkt. |
| 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 Property behavior: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| templateid | ID | ID des übergeordneten Vorlagen-Datenpunkts. Hinweis: Verwenden Sie die Eigenschaft hostid, um die Vorlage anzugeben, zu der der Datenpunkt gehört.Property behavior: - schreibgeschützt |
| timeout | string | Zeitüberschreitung für die Abfrage des Datenpunkts. Akzeptiert Sekunden oder Zeiteinheiten 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." und "icmpping" beginnt, "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) und snmp_oid mit "walk[" oder "get[" beginnt, "Script" (21), "Browser" (22) gesetzt ist- schreibgeschützt für geerbte und erkannte Objekte |
| trapper_hosts | string | Zulässige Hosts. Property behavior: - schreibgeschützt für erkannte Objekte - unterstützt, wenn type auf "Zabbix trapper" gesetzt ist oder wenn type auf "HTTP agent" gesetzt ist und allow_traps auf "Eingehende Daten akzeptieren" gesetzt ist |
| trends | string | Zeiteinheit, wie lange die Trenddaten gespeichert werden sollen. Akzeptiert auch Benutzermakros. Standard: 365d. Property behavior: - unterstützt, wenn value_type auf "numerisch, Fließkomma" oder "numerisch, vorzeichenlos" gesetzt ist- schreibgeschützt für erkannte Objekte |
| units | string | Werteinheiten. Property behavior: - unterstützt, wenn value_type auf "numerisch, Fließkomma" oder "numerisch, vorzeichenlos" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| 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) oder erkannte Objekte |
| uuid | string | Universell eindeutige Kennung, verwendet, um importierte Datenpunkte mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn nicht angegeben. Property behavior: - unterstützt, wenn der Datenpunkt zu einer Vorlage gehört |
| valuemapid | ID | ID der zugeordneten Wertzuordnung. Property behavior: - unterstützt, wenn value_type auf "numerisch, Fließkomma", "Zeichen" oder "numerisch, vorzeichenlos" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| verify_host | integer | Ob der Hostname der Verbindung mit dem im Zertifikat des Hosts übereinstimmt, validiert werden soll. Mögliche Werte: 0 - (Standard) nicht validieren; 1 - validieren. Property behavior: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| verify_peer | integer | Ob das Zertifikat des Hosts als authentisch validiert werden soll. Mögliche Werte: 0 - (Standard) nicht validieren; 1 - validieren. Property behavior: - unterstützt, wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte 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 Objekt "Datenpunkt-Tag" hat die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| tag | string | Name des Datenpunkt-Tags. Property behavior: - required |
| value | string | Wert des Datenpunkt-Tags. |
Item-Vorverarbeitung
Das Objekt der Item-Vorverarbeitung hat die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| type | integer | Der Typ der Vorverarbeitungsoption. Mögliche Werte: 1 - Benutzerdefinierter Multiplikator; 2 - Rechts abschneiden; 3 - Links abschneiden; 4 - Abschneiden; 5 - Regulärer Ausdruck; 6 - Boolesch zu Dezimal; 7 - Oktal zu Dezimal; 8 - Hexadezimal zu Dezimal; 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 - Auf Fehler mithilfe regulären Ausdrucks prüfen; 19 - Unverändert verwerfen; 20 - Unverändert verwerfen mit Heartbeat; 21 - JavaScript; 22 - Prometheus-Muster; 23 - Prometheus zu JSON; 24 - CSV zu JSON; 25 - Ersetzen; 26 - Nicht unterstützt prüfen; 27 - XML zu JSON; 28 - SNMP-Walk-Wert; 29 - SNMP-Walk zu JSON; 30 - SNMP-Get-Wert. Property behavior: - required |
| params | string | Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden. Mehrere Parameter werden durch das Zeilenumbruchzeichen (\n) getrennt. Wenn type auf "Nicht unterstützt prüfen" gesetzt ist, folgen die Parameter der Syntax <scope>[\n<pattern>], wobei pattern ein regulärer Ausdruck und scope einer der folgenden Werte ist:-1 - beliebigen Fehler abgleichen; \ 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 abschneiden" (2), "Links abschneiden" (3), "Abschneiden" (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), "Auf Fehler mithilfe regulären Ausdrucks prüfen" (18), "Unverändert verwerfen mit Heartbeat" (20), "JavaScript" (21), "Prometheus-Muster" (22), "Prometheus zu JSON" (23), "CSV zu JSON" (24), "Ersetzen" (25), "Nicht unterstützt prüfen" (26), "SNMP-Walk-Wert" (28), "SNMP-Walk zu JSON" (29) oder "SNMP-Get-Wert" (30) gesetzt ist |
| error_handler | integer | Aktionstyp, der im Falle eines Fehlers bei einem Vorverarbeitungsschritt verwendet wird. Mögliche Werte: 0 - Die Fehlermeldung wird vom Zabbix-Server gesetzt; 1 - Wert verwerfen; 2 - Benutzerdefinierten Wert setzen; 3 - Benutzerdefinierte Fehlermeldung setzen. Mögliche Werte, wenn type auf "Nicht unterstützt prüfen" gesetzt ist:1 - Wert verwerfen; 2 - Benutzerdefinierten Wert setzen; 3 - Benutzerdefinierte Fehlermeldung setzen. Property behavior: - required wenn type auf "Benutzerdefinierter Multiplikator" (1), "Regulärer Ausdruck" (5), "Boolesch zu Dezimal" (6), "Oktal zu Dezimal" (7), "Hexadezimal zu Dezimal" (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), "Auf Fehler mithilfe regulären Ausdrucks prüfen" (18), "Prometheus-Muster" (22), "Prometheus zu JSON" (23), "CSV zu JSON" (24), "Nicht unterstützt prüfen" (26), "XML zu JSON" (27), "SNMP-Walk-Wert" (28), "SNMP-Walk zu JSON" (29) oder "SNMP-Get-Wert" (30) gesetzt ist |
| error_handler_params | string | Parameter des Fehlerbehandlers. Property behavior: - required wenn error_handler auf "Benutzerdefinierten Wert setzen" oder "Benutzerdefinierte Fehlermeldung setzen" gesetzt ist |
Die folgenden Parameter und Fehlerbehandler werden für jeden Vorverarbeitungstyp unterstützt.
| Preprocessing type | Name | Parameter 1 | Parameter 2 | Parameter 3 | Supported error handlers |
|---|---|---|---|---|---|
| 1 | Benutzerdefinierter Multiplikator | number1, 6 | 0, 1, 2, 3 | ||
| 2 | Rechts abschneiden | Liste von Zeichen2 | |||
| 3 | Links abschneiden | Liste von Zeichen2 | |||
| 4 | Abschneiden | Liste von Zeichen2 | |||
| 5 | Regulärer Ausdruck | pattern3 | output2 | 0, 1, 2, 3 | |
| 6 | Boolesch zu Dezimal | 0, 1, 2, 3 | |||
| 7 | Oktal zu Dezimal | 0, 1, 2, 3 | |||
| 8 | Hexadezimal zu Dezimal | 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 | Auf Fehler mithilfe regulären Ausdrucks prüfen | pattern3 | output2 | 0, 1, 2, 3 | |
| 19 | Unverändert verwerfen | ||||
| 20 | Unverändert verwerfen mit Heartbeat | seconds5, 6 | |||
| 21 | JavaScript | script2 | |||
| 22 | Prometheus-Muster | pattern6, 7 | value, label, function |
output8, 9 | 0, 1, 2, 3 |
| 23 | Prometheus zu JSON | pattern6, 7 | 0, 1, 2, 3 | ||
| 24 | CSV zu 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 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 JSON10 | 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 Gleitkommazahl (Ganzzahlen werden implizit in Float-Werte umgewandelt)
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 nach der Syntax:
<metric name>{<label name>="<label value>", ...} == <value>. Jede
Komponente des Prometheus-Musters (Metrik, Bezeichnername, Bezeichnerwert und Metrikwert) kann ein Benutzermakro sein.
8 Prometheus-Ausgabe nach 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 Datensätze "Field name,OID prefix,Format", getrennt durch ein Zeilenumbruchzeichen.