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.
Wenn die eingehenden Daten bereits ein Ressourcenattribut mit demselben Namen enthalten, wird das eingehende Attribut anstelle des hier angegebenen beibehalten.

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