Konnektor Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit derconnector API.

Connector

Das Connector-Objekt verfügt über die folgenden Eigenschaften.

Property Type Description
connectorid ID ID des Connectors.

Property behavior:
- read-only
- required für Aktualisierungsvorgänge
name string Name des Connectors.

Property behavior:
- required für Erstellungsvorgänge
url string Endpunkt-URL, d. h. URL des Empfängers.
Benutzermakros werden unterstützt.

Property behavior:
- required für Erstellungsvorgänge
protocol integer Kommunikationsprotokoll.

Mögliche Werte:
0 - (default) Zabbix Streaming Protocol v1.0.
data_type integer Datentyp.

Mögliche Werte:
0 - (default) Datenpunktwerte;
1 - Ereignisse.
item_value_type integer Summe der zu sendenden Datenpunktwerttypen.

Mögliche Werte:
1 - Numerisch (Gleitkomma);
2 - Zeichen;
4 - Log;
8 - Numerisch (vorzeichenlos);
16 - Text;
32 - Binär (unterstützt ab Zabbix 7.0.5).

Standard: 31 - Alle Datenpunkttypen (außer binär).

Property behavior:
- supported, wenn data_type auf „Item values“ gesetzt ist.
max_records integer Maximale Anzahl von Ereignissen oder Datenpunkten, die innerhalb einer Nachricht gesendet werden können.

Mögliche Werte: 0-2147483647 (Maximalwert einer vorzeichenbehafteten 32-Bit-Ganzzahl).

Standard: 0 - Unbegrenzt.
max_senders integer Anzahl der Senderprozesse, die für diesen Connector ausgeführt werden sollen.

Mögliche Werte: 1-100.

Standard: 1.
max_attempts integer Anzahl der Versuche.

Mögliche Werte: 1-5.

Standard: 1.
attempt_interval string Intervall zwischen Wiederholungsversuchen.
Akzeptiert Sekunden.

Mögliche Werte: 0s-10s.

Standard: 5s.

Property behavior:
- supported, wenn max_attempts größer als 1 ist.
timeout string Zeitüberschreitung.
Zeitsuffixe werden unterstützt (z. B. 30s, 1m).
Benutzermakros werden unterstützt.

Mögliche Werte: 1s-60s.

Standard: 5s.
http_proxy string HTTP(S)-Proxy-Verbindungszeichenfolge im Format
[protocol]://[username[:password]@]proxy.example.com[:port].

Benutzermakros werden unterstützt.
authtype integer HTTP-Authentifizierungsmethode.

Mögliche Werte:
0 - (default) Keine;
1 - Basic;
2 - NTLM;
3 - Kerberos;
4 - Digest;
5 - Bearer.
username string Benutzername.
Benutzermakros werden unterstützt.

Property behavior:
- supported, wenn authtype auf „Basic“, „NTLM“, „Kerberos“ oder „Digest“ gesetzt ist
password string Passwort.
Benutzermakros werden unterstützt.

Property behavior:
- supported, wenn authtype auf „Basic“, „NTLM“, „Kerberos“ oder „Digest“ gesetzt ist
token string Bearer-Token.
Benutzermakros werden unterstützt.

Property behavior:
- required, wenn authtype auf „Bearer“ gesetzt ist
verify_peer integer Gibt an, ob überprüft werden soll, dass das Zertifikat des Hosts authentisch ist.

Mögliche Werte:
0 - Nicht überprüfen;
1 - (default) Überprüfen.
verify_host integer Gibt an, ob überprüft werden soll, dass der Hostname der Verbindung mit dem im Zertifikat des Hosts übereinstimmt.

Mögliche Werte:
0 - Nicht überprüfen;
1 - (default) Überprüfen.
ssl_cert_file string Dateipfad zum öffentlichen SSL-Schlüssel.
Benutzermakros werden unterstützt.
ssl_key_file string Dateipfad zum privaten SSL-Schlüssel.
Benutzermakros werden unterstützt.
ssl_key_password string Passwort für die SSL-Schlüsseldatei.
Benutzermakros werden unterstützt.
description text Beschreibung des Connectors.
status integer Gibt an, ob der Connector aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (default) Aktiviert.
tags_evaltype integer Auswertungsmethode für Tags.

Mögliche Werte:
0 - (default) Und/Oder;
2 - Oder.

Tag-Filter

Mit dem Tag-Filter können nur übereinstimmende Datenpunkt-Werte oder Ereignisse exportiert werden. Wenn er nicht gesetzt ist, wird alles exportiert. Das Tag-Filter-Objekt hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
tag string Tag-Name.

Verhalten der Eigenschaft:
- erforderlich
operator integer Bedingungs-Operator.

Mögliche Werte:
0 - (Standard) Gleich;
1 - Ungleich;
2 - Enthält;
3 - Enthält nicht;
12 - Existiert;
13 - Existiert nicht.
value string Tag-Wert.