On this page

Proxy-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der proxy API.

Proxy

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

Eigenschaft Typ Beschreibung
proxyid ID ID des Proxy.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
name string Name des Proxy.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
proxy_groupid ID ID der Proxy-Gruppe.

0 - Proxy ist keiner Proxy-Gruppe zugewiesen.
local_address string Adresse für aktive Agents. IP-Adresse oder DNS-Name, zu dem eine Verbindung hergestellt werden soll.

Verhalten der Eigenschaft:
- erforderlich, wenn proxy_groupid nicht 0 ist
local_port string Lokale Proxy-Portnummer, zu der eine Verbindung hergestellt werden soll.

Benutzermakros werden unterstützt.

Standard: 10051.

Verhalten der Eigenschaft:
- unterstützt, wenn proxy_groupid nicht 0 ist
operating_mode integer Typ des Proxy.

Mögliche Werte:
0 - aktiver Proxy;
1 - passiver Proxy.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
description text Beschreibung des Proxy.
lastaccess timestamp Zeitpunkt, zu dem der Proxy zuletzt eine Verbindung zum Server hergestellt hat.

Verhalten der Eigenschaft:
- schreibgeschützt
address string IP-Adresse oder DNS-Name, zu dem eine Verbindung hergestellt werden soll.

Benutzermakros werden unterstützt.

Verhalten der Eigenschaft:
- erforderlich, wenn der Betriebsmodus des Zabbix Proxy passiv ist
port string Portnummer, zu der eine Verbindung hergestellt werden soll.

Benutzermakros werden unterstützt.

Standard: 10051.

Verhalten der Eigenschaft:
- unterstützt, wenn der Betriebsmodus des Zabbix Proxy passiv ist
allowed_addresses string Durch Kommas getrennte IP-Adressen oder DNS-Namen des aktiven Zabbix Proxy.
tls_connect integer Verbindungen zum Proxy.

Mögliche Werte:
1 - (Standard) Keine Verschlüsselung;
2 - PSK;
4 - Zertifikat.
tls_accept integer Verbindungen vom Proxy.

Mögliche Bitmap-Werte:
1 - (Standard) Keine Verschlüsselung;
2 - PSK;
4 - Zertifikat.

Dies ist ein Bitmaskenfeld; jede Summe möglicher Bitmap-Werte ist zulässig (beispielsweise 6 für PSK und Zertifikat).
tls_issuer string Aussteller des Zertifikats.
tls_subject string Betreff des Zertifikats.
tls_psk_identity string PSK-Identität; muss mit genau einem PSK verknüpft sein (über Autoregistrierung, Hosts und Proxies hinweg).

Fügen Sie keine vertraulichen Informationen in die PSK-Identität ein, da sie unverschlüsselt über das Netzwerk gesendet wird, um dem Empfänger mitzuteilen, welcher PSK verwendet werden soll.

Verhalten der Eigenschaft:
- nur schreibbar
- erforderlich, wenn tls_connect auf "PSK" gesetzt ist oder tls_accept das Bit "PSK" enthält
tls_psk string Pre-Shared Key (PSK); muss mindestens 32 Hexadezimalziffern enthalten.

Verhalten der Eigenschaft:
- nur schreibbar
- erforderlich, wenn tls_connect auf "PSK" gesetzt ist oder tls_accept das Bit "PSK" enthält
custom_timeouts integer Gibt an, ob globale Zeitüberschreitungen für Datenpunkte auf Proxy-Ebene überschrieben werden sollen.

Mögliche Werte:
0 - (Standard) globale Einstellungen verwenden;
1 - Zeitüberschreitungen überschreiben.
timeout_zabbix_agent string Nicht mehr als timeout_* Sekunden für die Verarbeitung aufwenden.
Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300) oder einen Wert mit einem Zeitsuffix (z. B. 30s, 1m). Akzeptiert auch Benutzermakros.

Möglicher Wertebereich: 1-600 s.

Standard: "".

Verhalten der Eigenschaft:
- erforderlich, wenn custom_timeouts auf 1 gesetzt ist.
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser
version integer Version des Proxy.

Dreiteilige Zabbix-Versionsnummer, bei der für jeden Teil zwei Dezimalziffern verwendet werden, z. B. 60401 für Version 6.4.1, 70002 für Version 7.0.2 usw.
0 - Unbekannte Proxy-Version.

Verhalten der Eigenschaft:
- schreibgeschützt
compatibility integer Version des Proxy im Vergleich zur Zabbix-Server-Version.

Mögliche Werte:
0 - Nicht definiert;
1 - Aktuelle Version (Proxy und Server verfügen über dieselbe Hauptversion);
2 - Veraltete Version (Proxy-Version ist älter als die Server-Version, wird jedoch teilweise unterstützt);
3 - Nicht unterstützte Version (Proxy-Version ist älter als die vorherige LTS-Release-Version des Servers oder die Hauptversion des Servers ist älter als die Hauptversion des Proxy).

Verhalten der Eigenschaft:
- schreibgeschützt
state integer Status des Proxy.

Mögliche Werte:
0 - Unbekannt;
1 - Offline;
2 - Online.

Verhalten der Eigenschaft:
- schreibgeschützt