Oggetto elemento

I seguenti oggetti sono direttamente correlati all'API item.

Item

Gli item web non possono essere creati, aggiornati o eliminati direttamente tramite l'API Zabbix.

L'oggetto item dispone delle seguenti proprietà.

Property Type Description
itemid ID ID dell'item.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
delay string Intervallo di aggiornamento dell'item.

Accetta un numero di secondi (ad esempio, 1, 60, 300), un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h, 1d) oppure, facoltativamente, uno o più intervalli personalizzati, tutti separati da punto e virgola. Gli intervalli personalizzati possono essere una combinazione di intervalli flessibili e di pianificazione.

Accetta macro utente. Se utilizzato, il valore deve essere una singola macro. Non sono supportate più macro o macro combinate con testo. Gli intervalli flessibili possono essere scritti come due macro separate da una barra (ad esempio, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Esempio:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Comportamento della proprietà:
- obbligatoria se type è impostato su "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "Calculated" (15), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), "Telemetry query" (24), oppure se type è impostato su "Zabbix agent (active)" (7) e key_ non contiene "mqtt.get"
hostid ID ID dell'host o del template a cui appartiene l'item.

Comportamento della proprietà:
- costante
- obbligatoria per le operazioni di creazione
interfaceid ID ID dell'interfaccia host dell'item.

Comportamento della proprietà:
- obbligatoria se l'item appartiene a un host e type è impostato su "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap" o "SNMP agent"
- supportata se l'item appartiene a un host e type è impostato su "Simple check", "External check", "SSH agent", "TELNET agent" o "HTTP agent"
- sola lettura per gli oggetti rilevati
key_ string Chiave dell'item.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
- sola lettura per gli oggetti ereditati o rilevati
name string Nome dell'item.
Supporta macro utente.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
- sola lettura per gli oggetti ereditati o rilevati
name_resolved string Nome dell'item con le macro utente risolte.

Comportamento della proprietà:
- sola lettura
type integer Tipo di item.

Valori possibili:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - Simple check;
5 - Zabbix internal;
7 - Zabbix agent (active);
9 - Web item;
10 - External check;
11 - Database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
15 - Calculated;
16 - JMX agent;
17 - SNMP trap;
18 - Dependent item;
19 - HTTP agent;
20 - SNMP agent;
21 - Script;
22 - Browser;
24 - Telemetry query.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
- sola lettura per gli oggetti ereditati o rilevati
url string Stringa URL.
Supporta macro utente, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.

Comportamento della proprietà:
- obbligatoria se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
value_type integer Tipo di informazione dell'item.

Valori possibili:
0 - virgola mobile numerica;
1 - carattere;
2 - log;
3 - numerico senza segno;
4 - testo;
5 - binario;
6 - JSON.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
- sola lettura per gli oggetti ereditati o rilevati
allow_traps integer Consente di popolare il valore come per l'item trapper.

0 - (predefinito) Non accettare dati in ingresso;
1 - Accettare dati in ingresso.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti rilevati
authtype integer Metodo di autenticazione.

Valori possibili se type è impostato su "SSH agent":
0 - (predefinito) password;
1 - chiave pubblica.

Valori possibili se type è impostato su "HTTP agent":
0 - (predefinito) nessuno;
1 - basic;
2 - NTLM;
3 - Kerberos;
4 - Digest.

Comportamento della proprietà:
- supportata se type è impostato su "SSH agent" o "HTTP agent"
- sola lettura per gli oggetti ereditati (se type è impostato su "HTTP agent") o rilevati
description string Descrizione dell'item.

Comportamento della proprietà:
- sola lettura per gli oggetti rilevati
error string Testo dell'errore se si verificano problemi durante l'aggiornamento del valore dell'item.

Comportamento della proprietà:
- sola lettura
flags integer Origine dell'item.

Valori possibili:
0 - item normale;
4 - item convertito da un prototipo.

Comportamento della proprietà:
- sola lettura
follow_redirects integer Segue i reindirizzamenti della risposta durante il polling dei dati.

Valori possibili:
0 - Non seguire i reindirizzamenti;
1 - (predefinito) Seguire i reindirizzamenti.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
headers array Array di intestazioni da inviare durante l'esecuzione di una richiesta HTTP.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
history string Unità di tempo per la quale devono essere conservati i dati della cronologia.
Accetta anche macro utente.

Predefinito: 31d.

Comportamento della proprietà:
- sola lettura per gli oggetti rilevati
http_proxy string Stringa di connessione proxy HTTP(S).

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
inventory_link integer ID del campo dell'inventario host popolato dall'item.

Consultare la pagina dell'inventario host per un elenco dei campi dell'inventario host supportati e dei relativi ID.

Predefinito: 0.

Comportamento della proprietà:
- supportata se value_type è impostato su "numeric float", "character", "numeric unsigned" o "text"
- sola lettura per gli oggetti rilevati
ipmi_sensor string Sensore IPMI.

Comportamento della proprietà:
- obbligatoria se type è impostato su "IPMI agent" e key_ non è impostato su "ipmi.get"
- supportata se type è impostato su "IPMI agent"
- sola lettura per gli oggetti ereditati o rilevati
jmx_endpoint string Stringa di connessione personalizzata dell'agent JMX.

Valore predefinito: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Comportamento della proprietà:
- supportata se type è impostato su "JMX agent"
- sola lettura per gli oggetti rilevati
lastclock timestamp Ora dell'ultimo aggiornamento del valore dell'item.

Per impostazione predefinita, vengono visualizzati solo i valori relativi alle ultime 24 ore. È possibile estendere questo periodo modificando il valore del parametro Max history display period nella sezione di menu Administration > General.

Comportamento della proprietà:
- sola lettura
lastns integer Nanosecondi dell'ultimo aggiornamento del valore dell'item.

Per impostazione predefinita, vengono visualizzati solo i valori relativi alle ultime 24 ore. È possibile estendere questo periodo modificando il valore del parametro Max history display period nella sezione di menu Administration > General.

Comportamento della proprietà:
- sola lettura
lastvalue string Ultimo valore dell'item.

Per impostazione predefinita, vengono visualizzati solo i valori relativi alle ultime 24 ore. È possibile estendere questo periodo modificando il valore del parametro Max history display period nella sezione di menu Administration > General.

Comportamento della proprietà:
- sola lettura
logtimefmt string Formato dell'ora nelle voci di log.

Comportamento della proprietà:
- supportata se value_type è impostato su "log"
- sola lettura per gli oggetti ereditati o rilevati
master_itemid ID ID dell'item master.

Comportamento della proprietà:
- obbligatoria se type è impostato su "Dependent item"
- sola lettura per gli oggetti ereditati o rilevati
output_format integer Indica se la risposta deve essere convertita in JSON.

0 - (predefinito) Memorizzazione non elaborata;
1 - Converti in JSON.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
params string Parametri aggiuntivi in base al tipo di item:
- script eseguito per gli item SSH agent e TELNET agent;
- query SQL per gli item database monitor;
- formula per gli item calcolati;
- script per gli item script e browser.

Comportamento della proprietà:
- obbligatoria se type è impostato su "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script" o "Browser"
- sola lettura per gli oggetti ereditati (se type è impostato su "Script" o "Browser") o rilevati
parameters object/array Parametri aggiuntivi se type è impostato su "Script" o "Browser". Array di oggetti con le proprietà name e value, dove name deve essere univoco.

Comportamento della proprietà:
- supportata se type è impostato su "Script" o "Browser"
- sola lettura per gli oggetti ereditati o rilevati
password string Password per l'autenticazione.

Comportamento della proprietà:
- obbligatoria se type è impostato su "JMX agent" e username è impostato
- supportata se type è impostato su "Simple check", "SSH agent", "TELNET agent", "Database monitor" o "HTTP agent"
- sola lettura per gli oggetti ereditati (se type è impostato su "HTTP agent") o rilevati
post_type integer Tipo del corpo dei dati POST memorizzato nella proprietà posts.

Valori possibili:
0 - (predefinito) Dati non elaborati;
2 - Dati JSON;
3 - Dati XML.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
posts string Dati del corpo della richiesta HTTP(S).

Comportamento della proprietà:
- obbligatoria se type è impostato su "HTTP agent" e post_type è impostato su "JSON data" o "XML data"
- supportata se type è impostato su "HTTP agent" e post_type è impostato su "Raw data"
- sola lettura per gli oggetti ereditati o rilevati
prevvalue string Valore precedente dell'item.

Per impostazione predefinita, vengono visualizzati solo i valori relativi alle ultime 24 ore. È possibile estendere questo periodo modificando il valore del parametro Max history display period nella sezione di menu Administration > General.

Comportamento della proprietà:
- sola lettura
privatekey string Nome del file della chiave privata.

Comportamento della proprietà:
- obbligatoria se type è impostato su "SSH agent" e authtype è impostato su "public key"
- sola lettura per gli oggetti rilevati
publickey string Nome del file della chiave pubblica.

Comportamento della proprietà:
- obbligatoria se type è impostato su "SSH agent" e authtype è impostato su "public key"
- sola lettura per gli oggetti rilevati
query_fields array Array di campi query da inviare durante l'esecuzione di una richiesta HTTP.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
request_method integer Tipo di metodo della richiesta.

Valori possibili:
0 - (predefinito) GET;
1 - POST;
2 - PUT;
3 - HEAD.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
retrieve_mode integer Parte della risposta da memorizzare.

Valori possibili se request_method è impostato su "GET", "POST" o "PUT":
0 - (predefinito) Corpo;
1 - Intestazioni;
2 - Verranno memorizzati sia il corpo sia le intestazioni.

Valori possibili se request_method è impostato su "HEAD":
1 - Intestazioni.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
snmp_oid string OID SNMP.

Comportamento della proprietà:
- obbligatoria se type è impostato su "SNMP agent"
- sola lettura per gli oggetti ereditati o rilevati
ssl_cert_file string Percorso del file della chiave SSL pubblica.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
ssl_key_file string Percorso del file della chiave SSL privata.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
ssl_key_password string Password del file della chiave SSL.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
state integer Stato dell'item.

Valori possibili:
0 - (predefinito) normale;
1 - non supportato.

Comportamento della proprietà:
- sola lettura
status integer Stato dell'item.

Valori possibili:
0 - (predefinito) item abilitato;
1 - item disabilitato.
status_codes string Intervalli dei codici di stato HTTP richiesti, separati da virgole.
Supporta anche macro utente come parte dell'elenco separato da virgole.

Esempio: 200,200-{$M},{$M},200-400

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
templateid ID ID dell'item del template padre.

Suggerimento: utilizzare la proprietà hostid per specificare il template a cui appartiene l'item.

Comportamento della proprietà:
- sola lettura
timeout string Timeout della richiesta di polling dei dati dell'item.
Accetta un numero di secondi (ad esempio, 1, 60, 300) o un valore con un suffisso temporale (ad esempio, 300s, 1m). Accetta anche macro utente.

Intervallo di valori possibili: 1-600s.

Predefinito: "" - utilizza le impostazioni del proxy/globali.

Comportamento della proprietà:
- supportata se type è impostato su "Zabbix agent" (0), "Simple check" (3) e key_ non inizia con "vmware." e "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) e snmp_oid inizia con "walk[" o "get[", "Script" (21), "Browser" (22)
- sola lettura per gli oggetti ereditati e rilevati,
- se viene applicato il valore predefinito e l'item appartiene a un host monitorato da un proxy o da un gruppo di proxy non accessibile, viene utilizzato il timeout globale.
trapper_hosts string Host consentiti.

Comportamento della proprietà:
- sola lettura per gli oggetti rilevati
- supportata se type è impostato su "Zabbix trapper", oppure se type è impostato su "HTTP agent" e allow_traps è impostato su "Allow to accept incoming data".
Se la proprietà viene omessa, viene impostata automaticamente sulla macro utente {$TRAPPER.ALLOWED_HOSTS} (valore predefinito). Per impostazione predefinita, {$TRAPPER.ALLOWED_HOSTS} è 127.0.0.1,::1.
Se la proprietà è impostata su una stringa vuota, le connessioni in ingresso verranno negate da tutti gli host.
trends string Unità di tempo per la quale devono essere conservati i dati delle tendenze.
Accetta anche macro utente.

Predefinito: 365d.

Comportamento della proprietà:
- supportata se value_type è impostato su "numeric float" o "numeric unsigned"
- sola lettura per gli oggetti rilevati
units string Unità del valore.

Comportamento della proprietà:
- supportata se value_type è impostato su "numeric float" o "numeric unsigned"
- sola lettura per gli oggetti ereditati o rilevati
username string Nome utente per l'autenticazione.

Comportamento della proprietà:
- obbligatorio se type è impostato su "SSH agent", "TELNET agent", oppure se type è impostato su "JMX agent" e password è impostato
- supportato se type è impostato su "Simple check", "Database monitor" o "HTTP agent"
- sola lettura per gli oggetti ereditati (se type è impostato su "HTTP agent") o rilevati
uuid string Identificatore univoco universale, utilizzato per collegare l'item importato a quelli già esistenti. Generato automaticamente se non specificato.

Comportamento della proprietà:
- supportato se l'item appartiene a un template
valuemapid ID ID della mappa valori associata.

Comportamento della proprietà:
- supportata se value_type è impostato su "numeric float", "character" o "numeric unsigned"
- sola lettura per gli oggetti ereditati o rilevati
verify_host integer Indica se convalidare che il nome host della connessione corrisponda a quello presente nel certificato dell'host.

Valori possibili:
0 - (predefinito) Non convalidare;
1 - Convalida.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
verify_peer integer Indica se convalidare l'autenticità del certificato dell'host.

Valori possibili:
0 - (predefinito) Non convalidare;
1 - Convalida.

Comportamento della proprietà:
- supportata se type è impostato su "HTTP agent"
- sola lettura per gli oggetti ereditati o rilevati
query object Configurazione della query di telemetria. Definisce cosa interroga l'item dalla fonte dei dati di telemetria, come filtra i dati e come aggrega il risultato.

Comportamento della proprietà:
- obbligatoria se type è impostato su "Telemetry query"
- sola lettura per gli oggetti ereditati o rilevati
time_shift string Quanto indietro nel tempo, prima dell'ora corrente, termina l'intervallo temporale interrogato dall'item.

Accetta un numero di secondi (ad esempio, 1, 60, 300) o un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h, 1d). Accetta anche macro utente.

Intervallo di valori possibili: 0-86400s.

Predefinito: 15s.

Comportamento della proprietà:
- supportata se type è impostato su "Telemetry query"
lookback_limit string Quanto indietro nel tempo, prima dell'ora corrente, l'item interroga i dati quando non esiste una query precedente da cui continuare (ad esempio, alla prima esecuzione dell'item) oppure quando la query precedente è più vecchia di delay (ad esempio, perché il server Zabbix era inattivo).

Accetta un numero di secondi (ad esempio, 1, 60, 300) o un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h, 1d). Accetta anche macro utente.

Intervallo di valori possibili: 1-259200s.

Predefinito: 10m.

Comportamento della proprietà:
- supportata se type è impostato su "Telemetry query"
granularity string Durata di una porzione in cui viene suddiviso l'intero intervallo temporale della query.

Accetta un numero di secondi (ad esempio, 1, 60, 300) o un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h, 1d). Accetta anche macro utente.

Intervallo di valori possibili: 1-86400s.

Predefinito: 15s.

Comportamento della proprietà:
- supportata se type è impostato su "Telemetry query"

Intestazione HTTP

L'oggetto header ha le seguenti proprietà:

Proprietà Tipo Descrizione
name string Nome dell'intestazione HTTP.

Comportamento della proprietà:
- obbligatorio
value string Valore dell'intestazione.

Comportamento della proprietà:
- obbligatorio

Campo della query HTTP

L'oggetto del campo della query definisce un nome e un valore utilizzati per specificare un parametro URL. Ha le seguenti proprietà:

Proprietà Type Descrizione
name string Nome del parametro.

Comportamento della proprietà:
- obbligatorio
value string Valore del parametro.

Comportamento della proprietà:
- obbligatorio

Query di telemetria

L'oggetto query di telemetria ha le seguenti proprietà.

Property Type Description
signal_type integer Tipo di segnale interrogato dall'item.

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

Comportamento della proprietà:
- obbligatoria
metric_point_type integer Tipo di punto metrica interrogato dall'item.

Valori possibili:
0 - Somma;
1 - Gauge;
2 - Istogramma;
3 - Istogramma esponenziale.

Comportamento della proprietà:
- obbligatoria se signal_type è impostato su "Metrics"
columns array Array di colonne di dati di telemetria interrogate dall'item. Può essere vuoto.

Comportamento della proprietà:
- obbligatoria
aggregated_columns array Array di colonne aggregate di dati di telemetria interrogate dall'item e modalità di calcolo di un valore dai record delle colonne.

Comportamento della proprietà:
- obbligatoria
filter object Filtro della query di telemetria per i record delle colonne nella query.

Comportamento della proprietà:
- obbligatoria
Colonne dei dati di telemetria

L'oggetto delle colonne dei dati di telemetria presenta le seguenti proprietà.

Property Type Description
column string Nome della colonna dei dati di telemetria interrogata dall'item.
Vedere colonne dei dati di telemetria supportate.

Per più colonne a valore singolo, ogni valore column deve essere univoco. Per più colonne che contengono coppie chiave-valore, ogni coppia column e attribute_key deve essere univoca.
attribute_key string Nome della chiave interrogata dall'item all'interno della colonna che contiene coppie chiave-valore.

Per più colonne che contengono coppie chiave-valore, ogni coppia column e attribute_key deve essere univoca.

Comportamento della proprietà:
- required se column è impostato su una colonna che contiene coppie chiave-valore
Colonne aggregate dei dati di telemetria

L'oggetto delle colonne aggregate dei dati di telemetria presenta le seguenti proprietà.

Property Type Description
column string Nome della colonna dei dati di telemetria interrogata dall'item.
Vedere colonne dei dati di telemetria supportate.

Per più colonne, ogni valore di column deve essere univoco.

Questa proprietà non è supportata se function è impostato su "Count".

Comportamento della proprietà:
- obbligatoria se function è impostato su "Min", "Max", "Average", "Sum" o "Percentile"
function integer Funzione applicata dall'item ai record della colonna.

Valori possibili:
1 - Min;
2 - Max;
3 - Average;
4 - Count;
5 - Sum;
8 - Percentile.

Comportamento della proprietà:
- obbligatoria
parameters array Percentile calcolato dall'item a partire dai record della colonna.

Valore possibile: un numero da 0 a 100, specificato come stringa.

Comportamento della proprietà:
- obbligatoria se function è impostato su "Percentile"
alias string Nome univoco del valore calcolato, utilizzato per identificarlo nel valore dell'item.

Ogni valore di alias deve essere univoco.

Comportamento della proprietà:
- obbligatoria
Filtro dei dati di telemetria

L'oggetto filtro dei dati di telemetria presenta le seguenti proprietà.

Property Type Description
conditions array Condizioni del filtro dei dati di telemetria che un record in una colonna di dati di telemetria deve soddisfare.

Comportamento della proprietà:
- obbligatoria
evaltype integer Metodo di valutazione delle condizioni del filtro.

Valori possibili:
0 - And/Or;
1 - And;
2 - Or;
3 - Espressione personalizzata.

Comportamento della proprietà:
- obbligatoria
eval_formula string Espressione generata utilizzata per valutare le condizioni del filtro. L'espressione contiene ID che fanno riferimento a condizioni specifiche del filtro tramite il relativo formulaid. Il valore di eval_formula è uguale al valore di formula per i filtri con un'espressione personalizzata.

Comportamento della proprietà:
- sola lettura
formula string Espressione definita dall'utente da utilizzare per valutare le condizioni dei filtri con un'espressione personalizzata. L'espressione deve contenere ID che fanno riferimento a condizioni specifiche del filtro tramite il relativo formulaid. Gli ID utilizzati nell'espressione devono corrispondere esattamente a quelli definiti nelle condizioni del filtro: nessuna condizione può rimanere inutilizzata o essere omessa.

Comportamento della proprietà:
- obbligatoria se evaltype è impostato su "Espressione personalizzata"
Condizioni del filtro dei dati di telemetria

L'oggetto delle condizioni del filtro dei dati di telemetria presenta le seguenti proprietà.

Property Type Description
column string Nome della colonna dei dati di telemetria a cui si applica la condizione del filtro.
Vedere le colonne dei dati di telemetria supportate.

Comportamento della proprietà:
- obbligatoria
attribute_key string Nome della chiave a cui si applica la condizione, all'interno della colonna che contiene coppie chiave-valore.

Comportamento della proprietà:
- obbligatoria se column è impostata su una colonna che contiene coppie chiave-valore
operator integer Operatore della condizione del filtro.

Valori possibili per le colonne a valore singolo:
0 - Uguale;
1 - Diverso da;
2 - Contiene;
3 - Non contiene.

Valori possibili per le colonne che contengono coppie chiave-valore:
0 - Uguale;
1 - Diverso da;
12 - Esiste.

Comportamento della proprietà:
- obbligatoria
value string Valore con cui effettuare il confronto.

Comportamento della proprietà:
- obbligatoria se operator è impostato su "Uguale", "Diverso da", "Contiene" o "Non contiene"
formulaid string ID univoco arbitrario utilizzato per fare riferimento alla condizione da un'espressione personalizzata. Può contenere solo lettere maiuscole. L'ID deve essere definito dall'utente quando modifica le condizioni del filtro, ma verrà generato nuovamente quando queste verranno richieste in seguito.

Comportamento della proprietà:
- obbligatoria se evaltype dell'oggetto Filtro della query di telemetria è impostato su "Espressione personalizzata"

Tag dell'item

L'oggetto tag dell'item ha le seguenti proprietà.

Proprietà Type Descrizione
tag string Nome del tag dell'item.

Comportamento della proprietà:
- obbligatoria
value string Valore del tag dell'item.

Comportamento della proprietà:
- sola lettura.
object integer Tipo di oggetto da cui il tag è stato ereditato.

Valori possibili:
0 - template;
1 - host.

Comportamento della proprietà:
- sola lettura.
objectid ID ID dell'oggetto da cui il tag è stato ereditato.

Comportamento della proprietà:
- sola lettura.

Preelaborazione dell'item

L'oggetto di preelaborazione dell'item ha le seguenti proprietà.

Proprietà Tipo Descrizione
type integer Il tipo di opzione di preelaborazione.

Valori possibili:
1 - Moltiplicatore personalizzato;
2 - Rimozione a destra;
3 - Rimozione a sinistra;
4 - Rimozione;
5 - Espressione regolare;
6 - Booleano in decimale;
7 - Ottale in decimale;
8 - Esadecimale in decimale;
9 - Modifica semplice;
10 - Modifica al secondo;
11 - XPath XML;
12 - JSONPath;
13 - Nell'intervallo;
14 - Corrisponde all'espressione regolare;
15 - Non corrisponde all'espressione regolare;
16 - Verifica la presenza di errori in JSON;
17 - Verifica la presenza di errori in XML;
18 - Verifica la presenza di errori tramite espressione regolare;
19 - Ignora i valori invariati;
20 - Ignora i valori invariati con heartbeat;
21 - JavaScript;
22 - Pattern Prometheus;
23 - Prometheus in JSON;
24 - CSV in JSON;
25 - Sostituzione;
26 - Verifica non supportato;
27 - XML in JSON;
28 - Valore SNMP walk;
29 - SNMP walk in JSON;
30 - Valore SNMP get.

Comportamento della proprietà:
- obbligatoria
params string Parametri aggiuntivi utilizzati dall'opzione di preelaborazione.
I parametri multipli sono separati dal carattere di nuova riga (\n).

Se type è impostato su "Verifica non supportato", i parametri seguono la sintassi <scope>[\n<pattern>], dove pattern è un'espressione regolare e scope è uno dei seguenti:
-1 - corrisponde a qualsiasi errore;
\ 0 - verifica se il messaggio di errore corrisponde a pattern;
\ 1 - verifica se il messaggio di errore non corrisponde a pattern.

Comportamento della proprietà:
- obbligatoria se type è impostato su "Moltiplicatore personalizzato" (1), "Rimozione a destra" (2), "Rimozione a sinistra" (3), "Rimozione" (4), "Espressione regolare" (5), "XPath XML" (11), "JSONPath" (12), "Nell'intervallo" (13), "Corrisponde all'espressione regolare" (14), "Non corrisponde all'espressione regolare" (15), "Verifica la presenza di errori in JSON" (16), "Verifica la presenza di errori in XML" (17), "Verifica la presenza di errori tramite espressione regolare" (18), "Ignora i valori invariati con heartbeat" (20), "JavaScript" (21), "Pattern Prometheus" (22), "Prometheus in JSON" (23), "CSV in JSON" (24), "Sostituzione" (25), Verifica non supportato (26), "Valore SNMP walk" (28), "SNMP walk in JSON" (29) o "Valore SNMP get" (30)
error_handler integer Tipo di azione utilizzato in caso di errore del passaggio di preelaborazione.

Valori possibili:
0 - Il messaggio di errore viene impostato dal server Zabbix;
1 - Ignora il valore;
2 - Imposta un valore personalizzato;
3 - Imposta un messaggio di errore personalizzato.

Valori possibili se type è impostato su "Verifica non supportato":
1 - Ignora il valore;
2 - Imposta un valore personalizzato;
3 - Imposta un messaggio di errore personalizzato.

Comportamento della proprietà:
- obbligatoria se type è impostato su "Moltiplicatore personalizzato" (1), "Espressione regolare" (5), "Booleano in decimale" (6), "Ottale in decimale" (7), "Esadecimale in decimale" (8), "Modifica semplice" (9), "Modifica al secondo" (10), "XPath XML" (11), "JSONPath" (12), "Nell'intervallo" (13), "Corrisponde all'espressione regolare" (14), "Non corrisponde all'espressione regolare" (15), "Verifica la presenza di errori in JSON" (16), "Verifica la presenza di errori in XML" (17), "Verifica la presenza di errori tramite espressione regolare" (18), "Pattern Prometheus" (22), "Prometheus in JSON" (23), "CSV in JSON" (24), "Verifica non supportato" (26), "XML in JSON" (27), "Valore SNMP walk" (28), "SNMP walk in JSON" (29) o "Valore SNMP get" (30)
error_handler_params string Parametri del gestore degli errori.

Comportamento della proprietà:
- obbligatoria se error_handler è impostato su "Imposta un valore personalizzato" o "Imposta un messaggio di errore personalizzato"

I seguenti parametri e gestori degli errori sono supportati per ogni tipo di preelaborazione.

Tipo di preelaborazione Nome Parametro 1 Parametro 2 Parametro 3 Gestori degli errori supportati
1 Moltiplicatore personalizzato numero1, 6 0, 1, 2, 3
2 Rimozione a destra elenco di caratteri2
3 Rimozione a sinistra elenco di caratteri2
4 Rimozione elenco di caratteri2
5 Espressione regolare pattern3 output2 0, 1, 2, 3
6 Booleano in decimale 0, 1, 2, 3
7 Ottale in decimale 0, 1, 2, 3
8 Esadecimale in decimale 0, 1, 2, 3
9 Modifica semplice 0, 1, 2, 3
10 Modifica al secondo 0, 1, 2, 3
11 XPath XML percorso4 0, 1, 2, 3
12 JSONPath percorso4 0, 1, 2, 3
13 Nell'intervallo min1, 6 max1, 6 0, 1, 2, 3
14 Corrisponde all'espressione regolare pattern3 0, 1, 2, 3
15 Non corrisponde all'espressione regolare pattern3 0, 1, 2, 3
16 Verifica la presenza di errori in JSON percorso4 0, 1, 2, 3
17 Verifica la presenza di errori in XML percorso4 0, 1, 2, 3
18 Verifica la presenza di errori tramite espressione regolare pattern3 output2 0, 1, 2, 3
19 Ignora i valori invariati
20 Ignora i valori invariati con heartbeat secondi5, 6
21 JavaScript script2
22 Pattern Prometheus pattern6, 7 value, label, function output8, 9 0, 1, 2, 3
23 Prometheus in JSON pattern6, 7 0, 1, 2, 3
24 CSV in JSON carattere2 carattere2 0,1 0, 1, 2, 3
25 Sostituzione stringa di ricerca2 sostituzione2
26 Verifica non supportato scope1 pattern3, 6 1, 2, 3
27 XML in JSON 0, 1, 2, 3
28 Valore SNMP walk OID2 Formato:
0 - Invariato
1 - UTF-8 da Hex-STRING
2 - MAC da Hex-STRING
3 - Intero da BITS		 0, 1, 2, 3
29 SNMP walk in JSON10 Nome del campo2 Prefisso OID2 Formato:
0 - Invariato
1 - UTF-8 da Hex-STRING
2 - MAC da Hex-STRING
3 - Intero da BITS		 0, 1, 2, 3
30 Valore SNMP get Formato:
1 - UTF-8 da Hex-STRING
2 - MAC da Hex-STRING
3 - Intero da BITS		 0, 1, 2, 3

1 numero a virgola mobile (gli interi vengono convertiti implicitamente in valori a virgola mobile)
2 stringa
3 espressione regolare
4 JSONPath o XPath XML
5 intero positivo (con supporto dei suffissi temporali, ad esempio 30s, 1m, 2h, 1d)
6 macro utente
7 pattern Prometheus conforme alla sintassi: <metric name>{<label name>="<label value>", ...} == <value>. Ogni componente del pattern Prometheus (metrica, nome dell'etichetta, valore dell'etichetta e valore della metrica) può essere una macro utente.
8 output Prometheus conforme alla sintassi: <label name> (può essere una macro utente) se label è selezionato come secondo parametro.
9 Una delle funzioni di aggregazione: sum, min, max, avg, count se function è selezionato come secondo parametro.
10 Supporta più record "Nome del campo,Prefisso OID,Formato" delimitati da un carattere di nuova riga.