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 Objekt "item" hat die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| itemid | ID | ID des Datenpunkts. Property behavior: - schreibgeschützt - erforderlich für Aktualisierungsoperationen |
| delay | string | Aktualisierungsintervall des Datenpunkts. Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional einen 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) oder "Browser" (22) gesetzt ist, oder wenn type auf "Zabbix agent (active)" (7) gesetzt ist und key_ kein "mqtt.get" enthält |
| hostid | ID | ID des Hosts oder der Vorlage, zu dem 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}, {HOST.PORT}, {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 float; 1 - Zeichen; 2 - Log; 3 - numerisch unsigned; 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 Probleme beim Aktualisieren des Datenpunktwerts auftreten. Property behavior: - schreibgeschützt |
| flags | integer | Ursprung des Datenpunkts. Mögliche Werte: 0 - ein normaler Datenpunkt; 4 - ein aus einem Prototyp konvertierter Datenpunkt. Property behavior: - schreibgeschützt |
| follow_redirects | integer | Antwort-Weiterleitungen beim Abrufen von 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 float", "Zeichen", "numerisch unsigned" 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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter 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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter 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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter 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. 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 HTTP-Post-Body.Mögliche Werte: 0 - (Standard) Rohdaten; 2 - JSON-Daten; 3 - XML-Daten. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| posts | string | Daten des HTTP(S)-Anfragebodys. 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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter 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 der erforderlichen HTTP-Statuscodes. Unterstützt auch Benutzermakros als Teil der 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 | Timeout 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 float" oder "numerisch unsigned" gesetzt ist- schreibgeschützt für erkannte Objekte |
| units | string | Einheiten des Werts. Property behavior: - unterstützt wenn value_type auf "numerisch float" oder "numerisch unsigned" 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, die verwendet wird, um den importierten Datenpunkt 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 zugehörigen Wertzuordnung. Property behavior: - unterstützt wenn value_type auf "numerisch float", "Zeichen" oder "numerisch unsigned" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| verify_host | integer | Ob geprüft werden soll, dass der Hostname der Verbindung mit dem im Zertifikat des Hosts übereinstimmt. Mögliche Werte: 0 - (Standard) nicht prüfen; 1 - prüfen. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte oder erkannte Objekte |
| verify_peer | integer | Ob geprüft werden soll, dass das Zertifikat des Hosts authentisch ist. Mögliche Werte: 0 - (Standard) nicht prüfen; 1 - prüfen. Property behavior: - unterstützt wenn type auf "HTTP agent" gesetzt ist- schreibgeschützt für geerbte Objekte 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 Datenpunkt-Tag-Objekt 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 trimmen; 3 - Links trimmen; 4 - Trimmen; 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 mit Heartbeat verwerfen; 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 ist 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 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), "Auf Fehler mithilfe regulären Ausdrucks prüfen" (18), "Unverändert mit Heartbeat verwerfen" (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 - 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 trimmen | list of characters2 | |||
| 3 | Links trimmen | list of characters2 | |||
| 4 | Trimmen | list of characters2 | |||
| 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 mit Heartbeat verwerfen | 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 Gleitkommawerte umgewandelt)
2 Zeichenkette
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, Label-Name, Label-Wert 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 records", getrennt durch ein Zeilenumbruchzeichen.