1 Creare un oggetto

Panoramica

Per creare un item nel frontend di Zabbix, procedere come segue:

• Andare su: Data collection > Hosts
• Fare clic su Items nella riga dell'host
• Fare clic su Create item nell'angolo in alto a destra della schermata
• Inserire i parametri dell'item nel modulo

È anche possibile creare un item aprendo uno esistente, premendo il pulsante Clone e quindi salvandolo con un nome diverso.

Configurazione

La scheda Item contiene gli attributi generali dell'item.

Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.

Parametro	Descrizione
Name	Nome dell'item. Sono supportate le macro utente.
Type	Tipo di item. Vedere le singole sezioni item type.
Key	Chiave dell'item (fino a 2048 caratteri). Le item keys supportate sono descritte nelle singole sezioni dei tipi di item. La chiave deve essere univoca all'interno di un singolo host. Se il tipo di chiave è 'Zabbix agent', 'Zabbix agent (active)' o 'Simple check', il valore della chiave deve essere supportato da Zabbix agent o Zabbix server. Vedere anche: il formato corretto della key format.
Type of information	Tipo di dato memorizzato nel database dopo l'eventuale esecuzione di conversioni. Numeric (unsigned) - intero senza segno a 64 bit. Si noti che un valore in virgola mobile, se ricevuto per un item intero, verrà troncato della parte decimale. Numeric (float) - numero in virgola mobile a 64 bit. Questo tipo consente una precisione di circa 15 cifre e un intervallo approssimativo da -1.79E+308 a 1.79E+308 (con l'eccezione di PostgreSQL 11 and earlier versions). È supportata anche la ricezione di valori in notazione scientifica. Ad esempio 1.23E+7, 1e308, 1.1E-4. Character - dati di testo brevi. Log - dati di testo lunghi con proprietà opzionali relative ai log (timestamp, source, severity, logeventid). Text - dati di testo lunghi. Vedere anche i text data limits. Binary - numero binario (supportato solo per gli item dipendenti). Gli item che restituiscono valori con il tipo di dato binario non sono supportati nelle formule degli item calcolati o nelle espressioni di trigger. Per le chiavi degli item che restituiscono dati solo in un formato specifico, il tipo di informazione corrispondente viene selezionato automaticamente.
Host interface	Selezionare l'interfaccia dell'host. Questo campo è disponibile quando si modifica un item a livello di host.
Units	Se è impostato un simbolo di unità, Zabbix applica un post-processing al valore dell'item ricevuto e lo visualizza con il suffisso di unità specificato. Simboli di unità supportati con formattazione speciale (ed esempi di valore dell'item ricevuto → valore visualizzato): B - byte (1024 → 1 KB) Bps - byte al secondo (1024 → 1 KBps) s - secondi, visualizzati usando fino a tre unità di tempo non nulle più grandi (881764 → 10d 4h 56m) uptime - tempo trascorso in hh:mm:ss oppure N days, hh:mm:ss (881764 → 10 days, 04:56:04) unixtime - timestamp Unix, formattato come yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); per una formattazione corretta, il valore dell'item ricevuto deve essere Numeric (unsigned). Per altre unità (come Hz, W, ecc.), se il valore ricevuto supera 1000, viene diviso per 1000 e visualizzato con il prefisso corrispondente (5000 → 5 KHz, 881764 → 881.76 KW). Se il simbolo di unità è preceduto da !, la conversione dell'unità e l'aggiunta del prefisso sono disabilitate (1024 !B → 1024 B, 61 !s → 61 s). Per altri esempi e dettagli sui simboli di unità e sulla conversione delle unità, vedere Item value suffixes.
Update interval	Recupera un nuovo valore per questo item ogni N secondi. L'intervallo di aggiornamento massimo consentito è 86400 secondi (1 giorno). Sono supportati i Time suffixes, ad esempio 30s, 1m, 2h, 1d. Sono supportate le macro utente. Una singola macro deve occupare l'intero campo. Non sono supportate più macro nello stesso campo né macro mescolate con testo. Nota: l'intervallo di aggiornamento può essere impostato su '0' solo se esistono intervalli personalizzati con un valore diverso da zero. Se impostato su '0' e se esiste un intervallo personalizzato (flessibile o pianificato) con un valore diverso da zero, l'item verrà interrogato durante la durata dell'intervallo personalizzato. Nota che la prima interrogazione dell'item dopo che è diventato attivo o dopo la modifica dell'intervallo di aggiornamento potrebbe avvenire prima del valore configurato. I nuovi item verranno controllati entro 60 secondi dalla loro creazione, a meno che non abbiano un intervallo di aggiornamento Scheduling o Flexible e Update interval sia impostato su 0. Un item passivo esistente può essere interrogato immediatamente per ottenere il valore premendo il pulsante Execute now button.
Custom intervals	È possibile creare regole personalizzate per il controllo dell'item: Flexible - crea un'eccezione all'Update interval (intervallo con frequenza diversa). Scheduling - crea una pianificazione personalizzata di polling. Per informazioni dettagliate vedere Custom intervals. Sono supportati i Time suffixes nel campo Interval, ad esempio 30s, 1m, 2h, 1d. Sono supportate le macro utente. Una singola macro deve occupare l'intero campo. Non sono supportate più macro nello stesso campo né macro mescolate con testo.
Timeout	Impostare il timeout del controllo dell'item (disponibile per i tipi di item supported). Selezionare l'opzione di timeout: Global - viene utilizzato il timeout del proxy/globale (visualizzato nel campo Timeout disattivato). Override - viene utilizzato un timeout personalizzato (impostato nel campo Timeout; intervallo consentito: 1 - 600s). Sono supportati i Time suffixes, ad esempio 30s, 1m, e le user macros. Facendo clic sul collegamento Timeouts è possibile configurare i timeout del proxy o i timeout global (se non viene utilizzato un proxy). Si noti che il collegamento Timeouts è visibile solo agli utenti di tipo Super admin con autorizzazioni per le sezioni frontend Administration > General o Administration > Proxies.
History	Selezionare una delle seguenti opzioni: Do not store - la cronologia dell'item non viene memorizzata. Utile per gli item master se solo gli item dipendenti devono mantenere la cronologia. Questa impostazione non può essere sovrascritta dalle settings globali dell'housekeeper. Store up to - specifica la durata di conservazione della cronologia dettagliata nel database (da 1 ora a 25 anni). I dati più vecchi verranno rimossi dall'housekeeper. Memorizzato in secondi. Sono supportati i Time suffixes, ad esempio 2h, 1d. Sono supportate le macro utente. Il valore Store up to può essere sovrascritto globalmente in Administration > Housekeeping. Se esiste un'impostazione globale di override, viene visualizzata un'icona informativa arancione . Posizionando il mouse sopra di essa, viene visualizzato un messaggio di avviso, ad esempio Overridden by global housekeeper settings (1d). Si consiglia di conservare i valori registrati per il minor tempo possibile per ridurre la dimensione della cronologia dei valori nel database. Invece di memorizzare una lunga cronologia dei valori, è possibile conservare dati di trend più estesi. Vedere anche History and trends.
Trends	Selezionare una delle seguenti opzioni: Do not store - i trend non vengono memorizzati. Questa impostazione non può essere sovrascritta dalle settings globali dell'housekeeper. Store up to - specifica la durata di conservazione della cronologia aggregata (min, max, avg, count orari) nel database (da 1 giorno a 25 anni). I dati più vecchi verranno rimossi dall'housekeeper. Memorizzato in secondi. Sono supportati i Time suffixes, ad esempio 24h, 1d. Sono supportate le macro utente. Il valore Store up to può essere sovrascritto globalmente in Administration > Housekeeping. Se esiste un'impostazione globale di override, viene visualizzata un'icona informativa arancione informativa. Posizionando il mouse sopra di essa, viene visualizzato un messaggio di avviso, ad esempio Overridden by global housekeeper settings (7d). Nota: la conservazione dei trend non è disponibile per i dati non numerici - character, log e text. Vedere anche History and trends.
Value mapping	Applica il value mapping a questo item. Il Value mapping non modifica i valori ricevuti, serve solo per la visualizzazione dei dati. Funziona con gli item Numeric(unsigned), Numeric(float) e Character. Ad esempio, "Windows service states".
Log time format	Disponibile solo per gli item di tipo Log. Segnaposto supportati: y: Year (1970-2038). M: Month (01-12). d: Day (01-31). h: Hour (00-23). m: Minute (00-59). s: Second (00-59). Se lasciato vuoto, il timestamp verrà impostato a 0 in Unix time, rappresentando il 1 gennaio 1970. Ad esempio, si consideri la seguente riga dal file di log di Zabbix agent: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Inizia con sei posizioni di carattere per il PID, seguite da data, ora e dal resto del messaggio. Il formato dell'ora del log per questa riga sarebbe "pppppp:yyyyMMdd:hhmmss". Si noti che i caratteri "p" e ":" sono segnaposto e possono essere qualsiasi carattere tranne "yMdhms".
Populates host inventory field	È possibile selezionare un campo dell'inventario dell'host che verrà popolato dal valore dell'item. Questa funzione è disponibile se la popolazione automatica dell'inventory è abilitata per l'host. Questo campo non è disponibile se Type of information è impostato su 'Log'.
Description	Inserire una descrizione dell'item. Sono supportate le macro utente.
Enabled	Selezionare la casella di controllo per abilitare l'item in modo che venga elaborato.
Latest data	Fare clic sul collegamento per visualizzare i dati più recenti dell'item. Questo collegamento è disponibile solo quando si modifica un item già esistente.

La scheda Tags consente di definire i tag a livello di item.

Pre-elaborazione dei valori degli item

La scheda Preprocessing consente di definire regole di trasformazione per i valori ricevuti.

Test dell'item

È possibile testare un item e, se configurato correttamente, ottenere in risposta un valore reale. Il test può essere eseguito anche prima che un item venga salvato.

Il test è disponibile per gli item di host e template, i prototipi di item e le regole di discovery a basso livello. Il test non è disponibile per gli item attivi.

Il test dell'item è disponibile per i seguenti tipi di item passivi:

• Zabbix agent
• SNMP agent (v1, v2, v3)
• IPMI agent
• SSH checks
• Telnet checks
• JMX agent
• Simple checks (except icmpping*, vmware.* items)
• Zabbix internal
• Calculated items
• External checks
• Database monitor
• HTTP agent
• Script
• Browser

Per testare un item, fai clic sul pulsante Test in fondo al modulo di configurazione dell'item. Nota che il pulsante Test sarà disabilitato per gli item che non possono essere testati (come gli active checks, i simple checks esclusi).

Il modulo di test dell'item contiene campi per i parametri host richiesti (indirizzo host, porta, test con server/proxy (nome proxy)) e dettagli specifici dell'item (come la community SNMPv2 o le credenziali di sicurezza SNMPv3). Questi campi sono sensibili al contesto:

• I valori vengono precompilati quando possibile, ad esempio per gli item che richiedono un agent, prendendo le informazioni dall'interfaccia agent selezionata dell'host.
• I valori devono essere inseriti manualmente per gli item di template.
• I valori delle macro in testo normale vengono risolti.
• I campi in cui il valore (o parte del valore) è un segreto o una macro Vault sono vuoti e devono essere inseriti manualmente. Se un parametro dell'item contiene un valore di macro segreta, viene visualizzato il seguente messaggio di avviso: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
• I campi sono disabilitati quando non necessari nel contesto del tipo di item (ad esempio, il campo indirizzo host e il campo proxy sono disabilitati per gli item calcolati)

Per testare l'item, fai clic su Get value. Se il valore viene recuperato correttamente, verrà inserito nel campo Value, spostando il valore corrente (se presente) nel campo Previous value e calcolando anche il campo Prev. time, cioè la differenza di tempo tra i due valori (clic) e cercando di rilevare una sequenza EOL e passare a CRLF se viene rilevato "\n\r" nel valore recuperato.

Fai clic su Get value and test per testare il preprocessing.

I valori recuperati da un host e i risultati del test vengono troncati a una dimensione massima di 512KB quando inviati al frontend. Se un risultato viene troncato, viene visualizzata un'icona di avviso. La descrizione dell'avviso viene visualizzata al passaggio del mouse. Nota che i dati superiori a 512KB vengono comunque elaborati integralmente da Zabbix server.

Se la configurazione non è corretta, viene visualizzato un messaggio di errore che descrive la possibile causa.

Un valore recuperato con successo da un host può essere usato anche per testare i passaggi di preprocessing.

Pulsanti del modulo

I pulsanti nella parte inferiore del modulo consentono di eseguire diverse operazioni.

	Aggiungi un item. Questo pulsante è disponibile solo per i nuovi item.
	Aggiorna le proprietà di un item.
	Crea un altro item basato sulle proprietà dell'item corrente.
	Esegui immediatamente un controllo per un nuovo valore dell'item. Supportato solo per i controlli passivi (vedi maggiori dettagli). Nota: quando si esegue immediatamente il controllo di un valore, la cache di configurazione non viene aggiornata, pertanto il valore non rifletterà modifiche molto recenti alla configurazione dell'item.
	Verifica se la configurazione dell'item è corretta ottenendo un valore.
	Elimina la cronologia e i trend dell'item.
	Elimina l'item.
	Annulla la modifica delle proprietà dell'item.

Limiti dei dati di testo

I limiti dei dati di testo dipendono dal backend del database. Prima di memorizzare i valori di testo nel database, questi vengono troncati per adattarsi al limite del tipo di valore del database:

Limite degli script personalizzati

La lunghezza disponibile degli script personalizzati dipende dal database utilizzato:

Timeout dell'item

Il timeout dell'item specifica per quanto tempo Zabbix deve attendere prima di interrompere il controllo considerandolo fallito.

Quando viene raggiunto il timeout, il controllo viene interrotto anche se il recupero dei dati non è terminato. Se i dati vengono ricevuti solo parzialmente, l'item diventa non supportato e viene registrato un messaggio di errore (ad esempio, se i dati vengono raccolti correttamente solo per uno dei più OID in un controllo SNMP).

Per molti tipi di item, è possibile impostare timeout dell'item flessibili:

• per singolo item
• per tipo di item (a livello di proxy)
• per tipo di item (a livello globale)

Un timeout personalizzato per singolo item è utile se si desidera specificare un timeout più lungo per un item specifico, mantenendo bassi i timeout per gli altri item.

Precedenza dei timeout

1. Il timeout del singolo item ha la precedenza su qualsiasi altro timeout.
2. I timeout a livello di proxy hanno la precedenza sui timeout globali.

Il timeout dalla configurazione di Zabbix server o proxy non svolge alcun ruolo nei controlli per i quali sono impostati timeout flessibili.

Supporto per timeout flessibili

I timeout flessibili degli item sono supportati per questi tipi di item:

• Zabbix agent (sia controlli passivi sia attivi)
• SNMP agent (eccetto i controlli SNMP legacy¹)
• Simple check (eccetto icmpping* e gli item VMware²)
• SSH agent
• Telnet agent
• External check
• Database monitor
• Script
• HTTP agent

• Browser

  ¹ Per i controlli SNMP legacy (polling di un singolo OID), si applicano le impostazioni di timeout di server o proxy.
  ² Per gli item icmpping*, il valore del timeout è specificato direttamente nella chiave dell'item. Gli item di monitoraggio VMware utilizzano il proprio parametro VMwareTimeout dalla configurazione di server o proxy.

Item non supportati

Gli item non supportati vengono segnalati con stato Non supportato e vengono comunque ricontrollati al loro Intervallo di aggiornamento standard.

Un item diventa non supportato se il suo valore non può essere recuperato per qualche motivo (ad esempio, errore di connessione, nessun poller configurato per elaborare l'item). Inoltre, gli item che non ricevono dati storici rimangono nello stato Non supportato. Questo comportamento è previsto: un item passa allo stato Normale solo quando riceve nuovi dati storici validi.

Come i problemi, gli item non supportati vengono rivalutati solo quando vengono ricevuti nuovi dati, anche se per quell'item non sono più disponibili dati storici. In altre parole, item e trigger cambiano stato esclusivamente alla ricezione di nuovi dati. Tuttavia, se un'espressione di trigger include una funzione date and time e/o nodata(), il trigger verrà ricalcolato ogni 30 secondi (vedere triggers calculation time per i dettagli).