18 Valore dell'item

Panoramica

Questo widget è utile per visualizzare in modo prominente il valore di un singolo item. Può trattarsi sia dell'ultimo valore sia di un valore aggregato per un certo periodo nel passato.

Oltre al valore stesso, se desiderato, possono essere visualizzati elementi aggiuntivi:

  • Ora della metrica
  • Descrizione dell'item
  • Indicatore di variazione del valore
  • Colore di sfondo per il valore
  • Unità dell'item
  • Grafico sparkline per i valori del periodo di tempo specificato

Il widget può visualizzare valori numerici e stringa. La visualizzazione di valori binari non è supportata. I valori stringa vengono visualizzati su una sola riga e troncati, se necessario. Se non è disponibile alcun valore per l'item, viene visualizzato "No data".

L'indicatore di variazione confronta sempre con lo stesso periodo nel passato. Quindi, ad esempio, l'ultimo valore verrà confrontato con il valore precedente, mentre l'ultimo mese verrà confrontato con il mese precedente. Si noti che il periodo precedente per le aggregazioni viene calcolato come un periodo di tempo della stessa durata di quello originale, con l'ora di fine immediatamente precedente all'ora di inizio del periodo originale.

Facendo clic sul valore si accede a un grafico ad hoc per gli item numerici oppure ai dati più recenti per gli item stringa.

Il widget e tutti i suoi elementi possono essere ottimizzati visivamente tramite le opzioni di configurazione avanzata, consentendo di creare un'ampia varietà di stili visivi:

Configurazione

Per configurare, seleziona Item value come tipo di widget:

Oltre ai parametri comuni a tutti i widget, puoi impostare le seguenti opzioni specifiche:
Item Seleziona l'item.
In alternativa, seleziona un widget compatibile come origine dati per l'item.
Show Seleziona la casella di controllo per visualizzare il rispettivo elemento: descrizione, valore, ora, indicatore di variazione, sparkline. Deselezionala per nasconderlo. Deve essere selezionato almeno un elemento.
Override host Seleziona un widget compatibile o il dashboard come origine dati per gli host.
Questo parametro non è disponibile quando si configura il widget su un template dashboard.
Advanced configuration Fai clic sull'intestazione Advanced configuration per visualizzare le opzioni di configurazione avanzata.

Configurazione avanzata

Le opzioni di configurazione avanzata sono disponibili nella sezione comprimibile Configurazione avanzata, e solo per gli elementi selezionati nel campo Mostra (vedi sopra).

Si noti che più elementi non possono occupare lo stesso spazio; se vengono posizionati nello stesso spazio, verrà visualizzato un messaggio di errore.

Parametri generici del widget

Questi parametri determinano il colore di sfondo (statico o dinamico) per l'intero widget e una funzione di aggregazione per la visualizzazione dei valori.
Colore di sfondo Seleziona il colore di sfondo per l'intero widget dal selettore di colori.
D indica il colore predefinito (dipende dal tema del frontend). Per tornare al valore predefinito, fai clic sul pulsante Usa predefinito nel selettore di colori.
Soglie Configura il colore di sfondo dinamico per l'intero widget. Fai clic su Aggiungi per aggiungere una soglia, seleziona il colore di sfondo dal selettore di colori e specifica un valore numerico. Quando il valore dell'item è uguale o superiore al valore della soglia, il colore di sfondo cambierà.
L'elenco verrà ordinato in ordine crescente al momento del salvataggio.
Nota che il colore di sfondo dinamico verrà visualizzato correttamente solo per gli item numerici.
Funzione di aggregazione Specifica quale funzione di aggregazione usare all'interno del Periodo di tempo selezionato:
min - visualizza il valore più piccolo;
max - visualizza il valore più grande;
avg - visualizza il valore medio;
count - visualizza il conteggio dei valori;
sum - visualizza la somma dei valori;
first - visualizza il primo valore;
last - visualizza l'ultimo valore.
Se viene selezionato non usato, viene visualizzato il valore più recente (nessuna aggregazione).

L'aggregazione consente di visualizzare un valore aggregato per l'intervallo scelto (5 minuti, un'ora, un giorno), invece del valore più recente.
Solo i dati numerici possono essere visualizzati per min, max, avg e sum. Per count, i dati non numerici verranno convertiti in numerici.
Periodo di tempo Specifica il periodo di tempo da usare per aggregare i valori:
Dashboard - usa il periodo di tempo della dashboard;
Widget - usa il periodo di tempo del widget specificato;
Custom - usa un periodo di tempo personalizzato.
Questo parametro è nascosto quando Funzione di aggregazione è impostata su "non usato".
Widget Seleziona il widget.
Questo parametro verrà visualizzato solo se Periodo di tempo è impostato su "Widget".
Da Seleziona il periodo di tempo da cui partire (valore predefinito now-1h). Vedi sintassi del tempo relativo.
Questo parametro verrà visualizzato solo se Periodo di tempo è impostato su "Custom".
A Seleziona il periodo di tempo fino a (valore predefinito now). Vedi sintassi del tempo relativo.
Questo parametro verrà visualizzato solo se Periodo di tempo è impostato su "Custom".
Dati storici Prendi i dati dalla history o dai trend:
Auto - selezione automatica;
History - prendi i dati di history;
Trends - prendi i dati dei trend.

Questa impostazione si applica solo ai dati numerici. I dati non numerici verranno sempre presi dalla history.
Descrizione

Questi parametri determinano come deve essere visualizzata la descrizione dell'item.
Descrizione Inserire la descrizione dell'item. Questa descrizione può sostituire il nome predefinito dell'item. Sono supportate descrizioni su più righe. È possibile utilizzare una combinazione di testo e macro supportate.
{HOST.*}, {ITEM.*}, {INVENTORY.*} e le macro utente sono supportate.
Posizione orizzontale Selezionare la posizione orizzontale della descrizione dell'item: a sinistra, a destra o al centro.
Posizione verticale Selezionare la posizione verticale della descrizione dell'item: in alto, in basso o al centro.
Dimensione Inserire l'altezza della dimensione del carattere per la descrizione dell'item (in percentuale rispetto all'altezza totale del widget).
Grassetto Selezionare la casella di controllo per visualizzare la descrizione dell'item in grassetto.
Colore Selezionare il colore della descrizione dell'item dal selettore colori.
D indica il colore predefinito (dipende dal tema del frontend). Per ripristinare il valore predefinito, fare clic sul pulsante Usa predefinito nel selettore colori.
Valore

Questi parametri determinano come deve essere visualizzato il valore dell'item.
Posizioni decimali Selezionare quante posizioni decimali verranno visualizzate con il valore. Questo valore influisce solo sugli item float. Per gli item con unità impostate su "s", se questo valore è maggiore di 0 (il valore predefinito è 2), il widget arrotonda l'unità di tempo più significativa e visualizza un valore numerico (ad esempio, "10.43m") invece di convertire il valore in una stringa temporale completa. Se impostato su 0, i secondi vengono convertiti in una stringa temporale leggibile (ad esempio, "4h 56m 30s").
Dimensione Inserire l'altezza della dimensione del carattere per le posizioni decimali (in percentuale rispetto all'altezza totale del widget).
Posizione orizzontale Selezionare la posizione orizzontale del valore dell'item: a sinistra, a destra o al centro.
Posizione verticale Selezionare la posizione verticale del valore dell'item: in alto, in basso o al centro.
Dimensione Inserire l'altezza della dimensione del carattere per il valore dell'item (in percentuale rispetto all'altezza totale del widget).
Si noti che la dimensione del valore dell'item ha la priorità; gli altri elementi devono cedere spazio al valore. Tuttavia, con l'indicatore di variazione, se il valore è troppo grande, verrà troncato per mostrare l'indicatore di variazione.
Grassetto Selezionare la casella di controllo per visualizzare il valore dell'item in grassetto.
Colore Selezionare il colore del valore dell'item dal selettore colori.
D indica il colore predefinito (dipende dal tema del frontend). Per tornare al valore predefinito, fare clic sul pulsante Usa predefinito nel selettore colori.
Unità
Unità Selezionare la casella di controllo per visualizzare le unità con il valore dell'item. Se si inserisce un nome di unità, questo sovrascriverà l'unità della configurazione dell'item.
Posizione Selezionare la posizione dell'unità dell'item: sopra, sotto, prima o dopo il valore.
Dimensione Inserire l'altezza della dimensione del carattere per l'unità dell'item (in percentuale rispetto all'altezza totale del widget).
Grassetto Selezionare la casella di controllo per visualizzare l'unità dell'item in grassetto.
Colore Selezionare il colore dell'unità dell'item dal selettore colori.
D indica il colore predefinito (dipende dal tema del frontend). Per tornare al valore predefinito, fare clic sul pulsante Usa predefinito nel selettore colori.
Ora

Questi parametri determinano come deve essere visualizzata l'ora (valore del clock dalla cronologia dell'item).
Posizione orizzontale Selezionare la posizione orizzontale dell'ora: a sinistra, a destra o al centro.
Posizione verticale Selezionare la posizione verticale dell'ora: in alto, in basso o al centro.
Dimensione Inserire l'altezza della dimensione del carattere per l'ora (in percentuale rispetto all'altezza totale del widget).
Grassetto Selezionare la casella di controllo per visualizzare l'ora in grassetto.
Colore Selezionare il colore dell'ora dal selettore colori.
D indica il colore predefinito (dipende dal tema del frontend). Per tornare al valore predefinito, fare clic sul pulsante Usa predefinito nel selettore colori.
Indicatore di modifica

Questa sezione consente di selezionare il colore degli indicatori di modifica dal selettore dei colori.

Gli indicatori di modifica sono i seguenti:

  • ↑ - il valore dell'item è aumentato (per gli item numerici)
  • ↓ - il valore dell'item è diminuito (per gli item numerici)
  • ↕ - il valore dell'item è cambiato (per gli item stringa e gli item con mappatura dei valori)

D indica il colore predefinito (dipende dal tema del frontend). Per tornare al valore predefinito, fare clic sul pulsante Use default nel selettore dei colori.

L'altezza verticale dell'indicatore di modifica è uguale alla dimensione del valore (parte intera del valore per gli item numerici).

Si noti che gli indicatori di aumento e diminuzione non vengono mostrati con un solo valore.

Sparkline

Questi parametri determinano come deve essere visualizzato il grafico sparkline.
Width Imposta lo spessore della linea del grafico usando il cursore oppure inserendo manualmente un valore nell'intervallo da 0 a 10.
Color Seleziona il colore della linea e del riempimento.
Fill Imposta il livello di trasparenza del colore di riempimento usando il cursore oppure inserendo manualmente un valore nell'intervallo da 0 a 10.
Time period Specifica il periodo di tempo per i valori da includere nel grafico sparkline:
Dashboard - usa il periodo di tempo della dashboard;
Widget - usa il periodo di tempo del widget specificato;
Custom - usa un periodo di tempo personalizzato.
Widget Seleziona il widget.
Questo parametro viene visualizzato solo se Time period è impostato su "Widget".
From Seleziona il periodo di tempo iniziale (valore predefinito now-1h). Vedi relative time syntax.
Questo parametro viene visualizzato solo se Time period è impostato su "Custom".
To Seleziona il periodo di tempo finale (valore predefinito now). Vedi relative time syntax.
Questo parametro viene visualizzato solo se Time period è impostato su "Custom".
History data Prendi i dati dalla history o dalle trends:
Auto - selezione automatica;
History - usa i dati di history;
Trends - usa i dati di trend.