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.

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

Eigenschaftsverhalten:
- 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.

Eigenschaftsverhalten:
- 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.

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

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

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

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

Benutzermakros werden unterstützt.

Eigenschaftsverhalten:
- 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.

Eigenschaftsverhalten:
- 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 Bitmaskenwerte:
1 - (Standard) Keine Verschlüsselung;
2 - PSK;
4 - Zertifikat.

Dies ist ein Bitmaskenfeld; jede Summe möglicher Bitmaskenwerte 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; darf nur mit einem einzigen PSK verknüpft sein (über Autoregistrierung, Hosts und Proxys 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.

Eigenschaftsverhalten:
- nur schreiben
- 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.

Eigenschaftsverhalten:
- nur schreiben
- 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 Für die Verarbeitung nicht mehr als timeout_* Sekunden aufwenden.
Akzeptiert eine Anzahl von Sekunden (z. B. 1, 60, 300) oder einen Wert mit einem Zeitsuffix (z. B. 30s, 1m). Akzeptiert auch Benutzermakros.
Wird nur verwendet, wenn custom_timeouts auf „Zeitüberschreitungen überschreiben“ gesetzt ist; andernfalls wird der Wert ignoriert.

Möglicher Wertebereich: 1-600s.

Eigenschaftsverhalten:
- erforderlich, wenn custom_timeouts auf „Zeitüberschreitungen überschreiben“ 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
timeout_telemetry_query
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.

Eigenschaftsverhalten:
- 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 aber teilweise unterstützt);
3 - Nicht unterstützte Version (Proxy-Version ist älter als die vorherige LTS-Version des Servers oder die Hauptversion des Servers ist älter als die Hauptversion des Proxy).

Eigenschaftsverhalten:
- schreibgeschützt
state integer Status des Proxy.

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

Eigenschaftsverhalten:
- schreibgeschützt

Application Performance Monitoring (APM)

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

Property Type Description
data_collection_status integer Gibt an, ob die Erfassung von Telemetriedaten auf dem Proxy aktiviert ist.

Mögliche Werte:
0 - (Standard) Deaktiviert;
1 - Aktiviert.
max_messages_per_second integer Maximale Anzahl von Nachrichten pro Sekunde, die der Proxy akzeptiert.

Möglicher Wertebereich: 0 (unbegrenzt) – 2147483647.

Standard: 0.

Verhalten der Eigenschaft:
- unterstützt, wenn data_collection_status auf „Enabled“ gesetzt ist
additional_resource_attributes array Array von Ressourcenattributen, die den eingehenden Telemetriedaten hinzugefügt werden sollen.

Verhalten der Eigenschaft:
- unterstützt, wenn data_collection_status auf „Enabled“ gesetzt ist

Ressourcenattribute

Das Objekt für Ressourcenattribute verfügt über die folgenden Eigenschaften.

Property Type Description
key string Name des Ressourcenattributs.
Muss für den angegebenen signal_type eindeutig sein.

Verhalten der Eigenschaft:
- erforderlich
value string Wert des Ressourcenattributs.
Kann leer sein.
signal_type integer Typ der Telemetriedaten, auf den das Attribut angewendet wird.

Mögliche Werte:
0 - Traces;
1 - Metriken;
2 - Logs.

Verhalten der Eigenschaft:
- erforderlich