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 Datenpunkt-Objekt hat 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 Sekunden oder eine Zeiteinheit 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 Intervallen und Planungsintervallen sein.

Akzeptiert Benutzermakros. Falls verwendet, muss der Wert aus genau einem einzelnen Makro bestehen. Mehrere Makros oder mit Text gemischte Makros 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 entdeckte Objekte
key_ string Datenpunktschlüssel.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte oder entdeckte Objekte
name string Name des Datenpunkts.
Unterstützt Benutzermakros.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte oder entdeckte 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-Datenpunkt;
10 - External check;
11 - Database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
15 - Calculated;
16 - JMX agent;
17 - SNMP trap;
18 - Abhängiger Datenpunkt;
19 - HTTP agent;
20 - SNMP agent;
21 - Script;
22 - Browser.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte oder entdeckte 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 entdeckte Objekte
value_type integer Informationstyp des Datenpunkts.

Mögliche Werte:
0 - numerischer Gleitkommawert;
1 - Zeichen;
2 - Log;
3 - numerisch ohne Vorzeichen;
4 - Text;
5 - binär;
6 - JSON.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für geerbte oder entdeckte Objekte
allow_traps integer Erlaubt das Befüllen des Werts ähnlich wie bei einem Trapper-Datenpunkt.

0 - (Standard) Das Annehmen eingehender Daten nicht erlauben;
1 - Das Annehmen eingehender Daten erlauben.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für entdeckte 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 entdeckte Objekte
description string Beschreibung des Datenpunkts.

Verhalten der Eigenschaft:
- schreibgeschützt für entdeckte Objekte
error string Fehlertext, wenn es Probleme beim Aktualisieren des Datenpunktwerts gibt.

Verhalten der Eigenschaft:
- schreibgeschützt
flags integer Herkunft des Datenpunkts.

Mögliche Werte:
0 - ein normaler Datenpunkt;
4 - ein aus einem Prototyp konvertierter Datenpunkt.

Verhalten der Eigenschaft:
- schreibgeschützt
follow_redirects integer Antwort-Weiterleitungen beim Abrufen von Daten folgen.

Mögliche Werte:
0 - Weiterleitungen nicht folgen;
1 - (Standard) Weiterleitungen folgen.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte 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 entdeckte Objekte
history string Eine Zeiteinheit dafür, wie lange die Verlaufsdaten gespeichert werden sollen.
Akzeptiert auch Benutzermakros.

Standard: 31d.

Verhalten der Eigenschaft:
- schreibgeschützt für entdeckte 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 entdeckte Objekte
inventory_link integer ID des Host-Inventarfelds, das durch den Datenpunkt befüllt wird.

Eine Liste der unterstützten Host-Inventarfelder und ihrer IDs finden Sie auf der Seite Host-Inventar.

Standard: 0.

Verhalten der Eigenschaft:
- unterstützt, wenn value_type auf "numeric float", "character", "numeric unsigned" oder "text" gesetzt ist
- schreibgeschützt für entdeckte 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 oder entdeckte Objekte
jmx_endpoint string Benutzerdefinierte Verbindungszeichenfolge für 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 entdeckte Objekte
lastclock timestamp Zeitpunkt, zu dem der Datenpunktwert zuletzt aktualisiert wurde.

Standardmäßig werden nur Werte angezeigt, die innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum erweitern, indem Sie den Wert des Parameters Max history display period im Menüabschnitt Administration → General ändern.

Verhalten der Eigenschaft:
- schreibgeschützt
lastns integer Nanosekunden des Zeitpunkts, zu dem der Datenpunktwert zuletzt aktualisiert wurde.

Standardmäßig werden nur Werte angezeigt, die innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum erweitern, indem Sie den Wert des Parameters Max history display period im Menüabschnitt 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 erweitern, indem Sie den Wert des Parameters Max history display period im Menüabschnitt Administration → General ändern.

Verhalten der Eigenschaft:
- schreibgeschützt
logtimefmt string Format der Zeit in Log-Einträgen.

Verhalten der Eigenschaft:
- unterstützt, wenn value_type auf "log" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte 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 entdeckte Objekte
output_format integer 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 entdeckte Objekte
params string Zusätzliche Parameter abhängig vom Typ des Datenpunkts:
- ausgeführtes Skript für SSH agent- und TELNET agent-Datenpunkte;
- SQL-Abfrage für Database monitor-Datenpunkte;
- Formel für Calculated-Datenpunkte;
- das Skript für Script- und Browser-Datenpunkte.

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 entdeckte 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 entdeckte Objekte
password string Passwort für die Authentifizierung.

Verhalten der Eigenschaft:
- 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 entdeckte 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 entdeckte Objekte
posts string HTTP(S)-Anfrage-Body-Daten.

Verhalten der Eigenschaft:
- 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 oder entdeckte 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 erweitern, indem Sie den Wert des Parameters Max history display period im Menüabschnitt Administration → General ändern.

Verhalten der Eigenschaft:
- schreibgeschützt
privatekey string Name der privaten Schlüsseldatei.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SSH agent" gesetzt ist und authtype auf "public key" gesetzt ist
- schreibgeschützt für entdeckte Objekte
publickey string Name der öffentlichen Schlüsseldatei.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SSH agent" gesetzt ist und authtype auf "public key" gesetzt ist
- schreibgeschützt für entdeckte 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 entdeckte 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 entdeckte 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.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte Objekte
snmp_oid string SNMP-OID.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SNMP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte Objekte
ssl_cert_file string Pfad zur öffentlichen SSL-Schlüsseldatei.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte Objekte
ssl_key_file string Pfad zur privaten SSL-Schlüsseldatei.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte 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 entdeckte 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 kommagetrennten 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 entdeckte Objekte
templateid ID ID des übergeordneten Vorlagen-Datenpunkts.

Hinweis: Verwenden Sie die Eigenschaft hostid, um die Vorlage anzugeben, zu der der Datenpunkt gehört.

Verhalten der Eigenschaft:
- schreibgeschützt
timeout string Timeout der Datenabfrageanforderung des Datenpunkts.
Akzeptiert Sekunden oder eine Zeiteinheit mit Suffix (z. B. 30s, 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." 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)
- schreibgeschützt für geerbte und entdeckte Objekte
trapper_hosts string Erlaubte Hosts.

Verhalten der Eigenschaft:
- schreibgeschützt für entdeckte Objekte
- unterstützt, wenn type auf "Zabbix trapper" gesetzt ist oder wenn type auf "HTTP agent" gesetzt ist und allow_traps auf "Allow to accept incoming data" gesetzt ist
trends string Eine Zeiteinheit dafür, wie lange die Trenddaten gespeichert werden sollen.
Akzeptiert auch Benutzermakros.

Standard: 365d.

Verhalten der Eigenschaft:
- unterstützt, wenn value_type auf "numeric float" oder "numeric unsigned" gesetzt ist
- schreibgeschützt für entdeckte 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 entdeckte Objekte
username string Benutzername für die Authentifizierung.

Verhalten der Eigenschaft:
- 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 entdeckte Objekte
uuid string Universell eindeutige Kennung, die verwendet wird, um einen importierten Datenpunkt mit bereits vorhandenen zu verknüpfen. Wird automatisch erzeugt, wenn sie nicht angegeben wird.

Verhalten der Eigenschaft:
- unterstützt, wenn der Datenpunkt zu einer Vorlage gehört
valuemapid ID ID der zugeordneten Wertezuordnung.

Verhalten der Eigenschaft:
- unterstützt, wenn value_type auf "numeric float", "character" oder "numeric unsigned" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte Objekte
verify_host integer Ob geprüft werden soll, dass der Hostname für die Verbindung mit dem im Zertifikat des Hosts übereinstimmt.

Mögliche Werte:
0 - (Standard) Nicht prüfen;
1 - Prüfen.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte 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.

Verhalten der Eigenschaft:
- unterstützt, wenn type auf "HTTP agent" gesetzt ist
- schreibgeschützt für geerbte oder entdeckte 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 hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
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 mit regulärem Ausdruck prüfen;
19 - Unveränderte Werte verwerfen;
20 - Unveränderte Werte 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 "Check unsupported" 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 - auf beliebigen Fehler prüfen;
\ 0 - prüfen, ob die Fehlermeldung pattern entspricht;
\ 1 - prüfen, ob die Fehlermeldung pattern nicht entspricht.

Property behavior:
- required wenn type auf "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "SNMP walk value" (28), "SNMP walk to JSON" (29) oder "SNMP get value" (30) gesetzt ist
error_handler integer Aktionstyp, der bei einem Fehler im 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 "Check unsupported" gesetzt ist:
1 - Wert verwerfen;
2 - Benutzerdefinierten Wert setzen;
3 - Benutzerdefinierte Fehlermeldung setzen.

Property behavior:
- required wenn type auf "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29) oder "SNMP get value" (30) gesetzt ist
error_handler_params string Parameter für den Fehler-Handler.

Property behavior:
- required wenn error_handler auf "Set custom value" oder "Set custom error message" gesetzt ist

Die folgenden Parameter und Fehler-Handler werden für jeden Vorverarbeitungstyp unterstützt.

Vorverarbeitungstyp Name Parameter 1 Parameter 2 Parameter 3 Unterstützte Fehler-Handler
1 Benutzerdefinierter Multiplikator number1,\ 6 0, 1, 2, 3
2 Rechts trimmen Zeichenliste2
3 Links trimmen Zeichenliste2
4 Trimmen Zeichenliste2
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 mit regulärem Ausdruck 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 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 Feldname2 OID-Präfix2 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 mit folgender 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 mit folgender 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 vom Typ "Field name,OID prefix,Format records", die durch ein Zeilenumbruchzeichen getrennt sind.