Oggetto proxy

I seguenti oggetti sono direttamente correlati all'API proxy.

Proxy

L'oggetto proxy presenta le seguenti proprietà.

Property Type Description
proxyid ID ID del proxy.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
name string Nome del proxy.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
proxy_groupid ID ID del gruppo di proxy.

0 - il proxy non è assegnato ad alcun gruppo di proxy.
local_address string Indirizzo per gli agent attivi. Indirizzo IP o nome DNS a cui connettersi.

Comportamento della proprietà:
- obbligatorio se proxy_groupid non è 0
local_port string Numero della porta locale del proxy a cui connettersi.

Le macro utente sono supportate.

Predefinito: 10051.

Comportamento della proprietà:
- supportato se proxy_groupid non è 0
operating_mode integer Tipo di proxy.

Valori possibili:
0 - proxy attivo;
1 - proxy passivo.

Comportamento della proprietà:
- obbligatorio per le operazioni di creazione
description text Descrizione del proxy.
lastaccess timestamp Ora dell'ultima connessione del proxy al server.

Comportamento della proprietà:
- sola lettura
address string Indirizzo IP o nome DNS a cui connettersi.

Le macro utente sono supportate.

Comportamento della proprietà:
- obbligatorio se la modalità operativa del proxy Zabbix è passiva
port string Numero della porta a cui connettersi.

Le macro utente sono supportate.

Predefinito: 10051.

Comportamento della proprietà:
- supportato se la modalità operativa del proxy Zabbix è passiva
allowed_addresses string Indirizzi IP o nomi DNS del proxy Zabbix attivo, delimitati da virgole.
tls_connect integer Connessioni al proxy.

Valori possibili:
1 - (predefinito) Nessuna crittografia;
2 - PSK;
4 - certificato.
tls_accept integer Connessioni dal proxy.

Valori bitmap possibili:
1 - (predefinito) Nessuna crittografia;
2 - PSK;
4 - certificato.

Questo è un campo con maschera di bit; è accettata qualsiasi somma dei valori bitmap possibili (ad esempio, 6 per PSK e certificato).
tls_issuer string Emittente del certificato.
tls_subject string Oggetto del certificato.
tls_psk_identity string Identità PSK; deve essere associata a una sola PSK (tra autoregistrazione, host e proxy).

Non includere informazioni sensibili nell'identità PSK, poiché viene inviata non crittografata sulla rete per informare il destinatario quale PSK utilizzare.

Comportamento della proprietà:
- sola scrittura
- obbligatoria se tls_connect è impostato su "PSK" oppure se tls_accept contiene il bit "PSK"
tls_psk string Chiave precondivisa (PSK); deve contenere almeno 32 cifre esadecimali.

Comportamento della proprietà:
- sola scrittura
- obbligatoria se tls_connect è impostato su "PSK" oppure se tls_accept contiene il bit "PSK"
custom_timeouts integer Indica se sovrascrivere i timeout globali degli item a livello di proxy.

Valori possibili:
0 - (predefinito) usa le impostazioni globali;
1 - sovrascrive i timeout.
timeout_zabbix_agent string Non dedicare più di timeout_* secondi all'elaborazione.
Accetta un numero di secondi (ad esempio 1, 60, 300) oppure un valore con un suffisso temporale (ad esempio 30s, 1m). Accetta anche macro utente.
Utilizzato solo se custom_timeouts è impostato su "override timeouts"; in caso contrario, il valore viene ignorato.

Intervallo di valori possibile: 1-600s.

Comportamento della proprietà:
- obbligatorio se custom_timeouts è impostato su "override timeouts"
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 Versione del proxy.

Numero di versione Zabbix composto da tre parti, in cui per ciascuna parte vengono utilizzate due cifre decimali, ad esempio 60401 per la versione 6.4.1, 70002 per la versione 7.0.2 e così via.
0 - Versione del proxy sconosciuta.

Comportamento della proprietà:
- sola lettura
compatibility integer Versione del proxy rispetto alla versione del server Zabbix.

Valori possibili:
0 - Non definita;
1 - Versione corrente (proxy e server hanno la stessa versione principale);
2 - Versione obsoleta (la versione del proxy è precedente a quella del server, ma è parzialmente supportata);
3 - Versione non supportata (la versione del proxy è precedente alla versione della release LTS precedente del server oppure la versione principale del server è precedente a quella del proxy).

Comportamento della proprietà:
- sola lettura
state integer Stato del proxy.

Valori possibili:
0 - Sconosciuto;
1 - Offline;
2 - Online.

Comportamento della proprietà:
- sola lettura

Monitoraggio delle prestazioni delle applicazioni (APM)

L'oggetto APM ha le seguenti proprietà.

Property Type Description
data_collection_status integer Indica se la raccolta dei dati di telemetria è abilitata sul proxy.

Valori possibili:
0 - (predefinito) Disabilitata;
1 - Abilitata.
max_messages_per_second integer Numero massimo di messaggi al secondo accettati dal proxy.

Intervallo di valori possibile: 0 (illimitato) – 2147483647.

Predefinito: 0.

Comportamento della proprietà:
- supportata se data_collection_status è impostato su "Enabled"
additional_resource_attributes array Array di attributi delle risorse da aggiungere ai dati di telemetria in ingresso.

Comportamento della proprietà:
- supportata se data_collection_status è impostato su "Enabled"

Attributi della risorsa

L'oggetto degli attributi della risorsa ha le seguenti proprietà.

Property Type Description
key string Nome dell'attributo della risorsa.
Deve essere univoco per il signal_type specificato.

Comportamento della proprietà:
- obbligatorio
value string Valore dell'attributo della risorsa.
Può essere vuoto.
signal_type integer Tipo di dati di telemetria a cui si applica l'attributo.

Valori possibili:
0 - Tracce;
1 - Metriche;
2 - Log.

Comportamento della proprietà:
- obbligatorio