8 Grafico

Panoramica

Il widget Graph visualizza i dati numerici degli item come un grafico vettoriale. Può aiutarti a monitorare le tendenze, individuare problemi e confrontare i valori nel tempo e tra host diversi.

Passando il cursore sul grafico viene visualizzato un tooltip con un elenco di item ordinati per valore in ordine decrescente.

Passando il cursore su un item nel tooltip, il relativo grafico viene evidenziato (gli altri vengono attenuati); selezionando l'item, i suoi dati vengono trasmessi ad altri widget.

Il grafico può essere visualizzato con i valori dell'asse Y invertiti; ciò influisce solo sulla rappresentazione visiva e non modifica i valori originali.

È disponibile anche il widget legacy Graph (classic).

Le informazioni visualizzate nel widget Graph possono essere scaricate come immagine PNG selezionando l'opzione Download image nel menu del widget.

Configurazione

Per configurare, selezionare Graph come tipo:

Dataset

La scheda Dataset consente di selezionare i dati per il grafico aggiungendo dataset. È possibile aggiungere due tipi di dataset:

  • Item patterns - vengono visualizzati i dati degli item corrispondenti. Puoi scegliere un singolo colore di base oppure selezionare una riga della tavolozza per assegnare colori distinti a ciascun item corrispondente.
  • Item list - vengono visualizzati i dati degli item selezionati. Puoi scegliere il colore di ciascun item singolarmente dal selettore.

Per impostazione predefinita, viene aggiunto un dataset Item patterns.
Dataset Per il dataset Item patterns:
Seleziona o inserisci i pattern di host e item; i dati degli item che corrispondono a questi pattern verranno visualizzati nel grafico; è possibile visualizzare fino a 50 item.
Per la selezione è possibile usare pattern con caratteri jolly (ad esempio, * restituirà i risultati che corrispondono a zero o più caratteri).
Per specificare un pattern con caratteri jolly, inserisci manualmente la stringa e premi Enter.
Il simbolo jolly viene sempre interpretato, quindi non è possibile aggiungere singolarmente, ad esempio, un item denominato item* se esistono altri item corrispondenti (ad esempio, item2, item3).
La specifica dei pattern di host e item è obbligatoria per i dataset "Item patterns".
Vedi anche: Dettagli di configurazione del dataset.

Per il dataset Item list:
Seleziona gli item per il grafico facendo clic sul pulsante Add item.
Puoi anche selezionare widget compatibili come origine dati per gli item facendo clic sul pulsante Add widget.
La specifica di item o widget è obbligatoria per i dataset "Item list".
Vedi anche: Dettagli di configurazione del dataset.

Nota che sono consentiti solo tipi di item numerici.

Quando configuri il widget in una template dashboard, il parametro per specificare i pattern di host non è disponibile e il parametro per specificare un elenco di item consente di selezionare solo gli item configurati nel template.
Draw Scegli il tipo di disegno della metrica.
I tipi di disegno possibili sono: Line (impostato per default), Points, Staircase e Bar.
Nota che se nel grafico line/staircase è presente un solo punto dati, questo viene disegnato come punto indipendentemente dal tipo di disegno. La dimensione del punto viene calcolata in base alla larghezza della linea, ma non può essere inferiore a 3 pixel, anche se la larghezza della linea è minore.
Stacked Seleziona la casella per visualizzare i dati come stacked (aree riempite visualizzate).
Questa opzione è disabilitata quando è selezionato il tipo di disegno Points.
Width Imposta la larghezza della linea.
Questa opzione è disponibile quando è selezionato il tipo di disegno Line o Staircase.
Point size Imposta la dimensione del punto.
Questa opzione è disponibile quando è selezionato il tipo di disegno Points.
Transparency Imposta il livello di trasparenza.
Fill Imposta il livello di riempimento.
Questa opzione è disponibile quando è selezionato il tipo di disegno Line o Staircase.
Missing data Seleziona l'opzione per visualizzare i dati mancanti:
None - il vuoto viene lasciato vuoto;
Connected - due valori di bordo vengono collegati;
Treat as 0 - i dati mancanti vengono visualizzati come valori 0;
Last known - i dati mancanti vengono visualizzati con lo stesso valore dell'ultimo valore noto; non applicabile per il tipo di disegno Points e Bar.
Override host Seleziona un widget compatibile o il selettore host della dashboard come origine dati per gli host.
Questo parametro non è disponibile quando si configura il widget in una template dashboard.
Y-axis Seleziona il lato del grafico in cui verrà visualizzato l'asse Y.
Invert values Seleziona la casella per moltiplicare tutti i valori dell'asse Y per -1 prima di visualizzarli nel grafico.
Questo influisce solo sulla rappresentazione visiva; i dati originali rimangono invariati.
Questa opzione non influisce su tooltip, legenda o linea percentile. Se per l'asse è selezionata l'opzione Simple triggers, le soglie del trigger verranno visualizzate invertite.
Time shift Specifica lo spostamento temporale, se necessario.
In questo campo puoi usare i suffissi temporali. Sono consentiti valori negativi.
Aggregation function Specifica quale funzione di aggregazione usare per ciascun item o per un intero dataset all'interno del Aggregation interval selezionato:
min - visualizza il valore più piccolo;
max - visualizza il valore più grande;
avg - visualizza il valore medio;
sum - visualizza la somma dei valori;
count - visualizza il conteggio dei valori;
first - visualizza il primo valore;
last - visualizza l'ultimo valore.
Se viene selezionato not used, tutti i valori vengono visualizzati (nessuna aggregazione).

Solo i dati numerici possono essere visualizzati per min, max, avg e sum. Per count, i dati non numerici verranno convertiti in numerici.
Vedi anche: Aggregazione nei grafici.
Aggregation interval Specifica l'intervallo per aggregare i valori.
In questo campo puoi usare i suffissi temporali. Un valore numerico senza suffisso sarà considerato in secondi.

Nota che se il widget è configurato per visualizzare dati storici basati su trends (History data selection è impostato su Trends o Auto), è consigliato usare un intervallo di aggregazione multiplo di 1 ora (ad esempio, 3600, 60m, 1h, 3h, ecc.). I trends memorizzano valori aggregati su base oraria, quindi l'uso di un intervallo di aggregazione che non sia multiplo di 1 ora (ad esempio, 100s, 7min, 15min, 90min, ecc.) può portare a risultati difficili da interpretare.
Aggregate Specifica se aggregare:
Each item - ogni item nel dataset verrà aggregato e visualizzato separatamente;
Data set - tutti gli item del dataset verranno aggregati e visualizzati come un unico valore.
Approximation Specifica quale valore visualizzare quando esiste più di un valore per pixel verticale del grafico:
all - visualizza il valore più piccolo, il più grande e il valore medio;
min - visualizza il valore più piccolo;
max - visualizza il valore più grande;
avg - visualizza il valore medio.

Questa impostazione è utile quando si visualizza un grafico per un ampio intervallo di tempo con un intervallo di aggiornamento frequente (ad esempio, un anno di valori raccolti ogni 10 minuti).
Data set label Specifica l'etichetta del dataset visualizzata nella configurazione Data set del grafico e nella Legend del grafico (per i dataset aggregati).
Tutti i dataset sono numerati, inclusi quelli con un Data set label specificato. Se non viene specificata alcuna etichetta, il dataset verrà etichettato automaticamente in base al suo numero (ad esempio, "Data set #2", "Data set #3", ecc.). La numerazione dei dataset viene ricalcolata dopo il riordino/trascinamento dei dataset.
Le etichette dei dataset troppo lunghe verranno abbreviate per adattarsi allo spazio disponibile (ad esempio, "Number of proc...").
Item tags Specifica i tag per filtrare gli item visualizzati nel widget.
È possibile includere ed escludere tag e valori di tag specifici. È possibile impostare più condizioni.
La corrispondenza del nome del tag è sempre sensibile alle maiuscole/minuscole.

Per ciascuna condizione sono disponibili diversi operatori:
Exists - include i nomi dei tag specificati;
Equals - include i nomi e i valori dei tag specificati (sensibile alle maiuscole/minuscole);
Contains - include i nomi dei tag specificati i cui valori contengono la stringa inserita (corrispondenza di sottostringa, non sensibile alle maiuscole/minuscole);
Does not exist - esclude i nomi dei tag specificati;
Does not equal - esclude i nomi e i valori dei tag specificati (sensibile alle maiuscole/minuscole);
Does not contain - esclude i nomi dei tag specificati i cui valori contengono la stringa inserita (corrispondenza di sottostringa, non sensibile alle maiuscole/minuscole).

Esistono due tipi di calcolo per le condizioni:
And/Or - tutte le condizioni devono essere soddisfatte, le condizioni con lo stesso nome di tag verranno raggruppate in base alla condizione Or;
Or - è sufficiente che una condizione sia soddisfatta.
Dettagli di configurazione del set di dati

I set di dati esistenti sono visualizzati in un elenco. Puoi:

  • Fare clic sull'icona di spostamento e trascinare un set di dati in una nuova posizione nell'elenco.
  • Fare clic sull'icona di espansione per espandere i dettagli del set di dati. Quando è espansa, questa icona diventa un'icona di compressione .
  • Fare clic sull'icona del colore per aprire il selettore. Puoi inserire un codice esadecimale, scegliere una campitura uniforme oppure passare alla scheda Palette e selezionare una riga di colori predefiniti. Il colore scelto viene applicato direttamente ai set di dati Item list oppure come base per le sfumature generate in Item patterns. Usa Tab per spostarti tra i controlli della finestra di dialogo, i tasti freccia per navigare tra le campiture o le righe della palette, Invio per selezionare ed Esc per annullare.
  • Fare clic sul pulsante Add new data set per aggiungere un set di dati vuoto che consenta di selezionare host e pattern di item. Se fai clic sull'icona rivolta verso il basso accanto al pulsante Add new data set, viene visualizzato un menu a discesa che consente di aggiungere un nuovo set di dati Item patterns o Item list oppure di Clone del set di dati attualmente aperto. Se tutti i set di dati sono compressi, l'opzione Clone non è disponibile.

Il set di dati Pattern degli item contiene i campi Pattern degli host e Pattern degli item, entrambi in grado di riconoscere nomi completi o pattern contenenti un simbolo jolly (*). Questa funzionalità consente di selezionare tutti i nomi host e i nomi degli item che contengono il pattern selezionato. Durante la digitazione del nome dell'item o del pattern dell'item nel campo Pattern degli item, nell'elenco a discesa vengono visualizzati solo gli item che appartengono ai nomi host selezionati.

Ad esempio, dopo aver digitato il pattern z* nel campo Pattern degli host, l'elenco a discesa mostra tutti i nomi host che contengono questo pattern: z*, Zabbix server, Zabbix proxy. Dopo aver premuto Invio, questo pattern viene accettato e visualizzato come z*. Allo stesso modo, dopo aver digitato il pattern a* nel campo Pattern degli item, l'elenco a discesa mostra tutti i nomi degli item che contengono questo pattern: a*, Available memory, Available memory in %.

Dopo aver premuto Invio, il pattern viene accettato e mostrato come **a***.

Il grafico mostra quindi tutti gli item che appartengono ai nomi host selezionati.

Il set di dati Elenco item contiene il pulsante Aggiungi item, che consente di aggiungere item da visualizzare nel grafico. È inoltre possibile aggiungere widget compatibili come origine dati per gli item facendo clic sul pulsante Aggiungi widget.

Ad esempio, facendo clic sul pulsante Aggiungi item si apre una finestra pop-up contenente il parametro Host. Dopo aver selezionato un host, tutti i suoi item disponibili per la selezione vengono visualizzati in un elenco.

Dopo aver selezionato uno o più item, questi verranno visualizzati nell'elenco degli item del set di dati e nel grafico.

Aggregazione nei grafici

L'aggregazione consente di visualizzare un valore aggregato (minimo, massimo, media, ecc.) in un intervallo di tempo specificato (5 minuti, un'ora, un giorno, ecc.) invece di tutti i singoli valori. All'interno di un set di dati, l'aggregazione può essere applicata separatamente a ciascun item oppure all'intero set di dati.

Alcuni casi d'uso della funzione di aggregazione possono essere i seguenti:

  • Il numero medio di richieste a un server Nginx al giorno.
  • Lo spazio su disco minimo tra i cluster per settimana.

Nell'esempio seguente, la funzione di aggregazione "max" viene applicata all'item con un intervallo di aggregazione di cinque minuti:

L'esempio mostra il carico massimo della CPU in cinque minuti (aggregato da valori medi di un minuto), confrontato con il carico medio della CPU in cinque minuti.

Quando per la legenda è selezionata l'opzione Mostra funzione di aggregazione, gli item vengono visualizzati tra parentesi, preceduti dalla funzione di aggregazione nella legenda e nel tooltip. Se per un grafico è specificata l'opzione Etichetta set di dati, l'etichetta viene visualizzata tra parentesi, preceduta dalla funzione di aggregazione.

Opzioni di visualizzazione

La scheda Opzioni di visualizzazione consente di definire la selezione dei dati dello storico:
Selezione dei dati dello storico Imposta la sorgente dei dati del grafico:
Auto - i dati vengono recuperati in base al classico algoritmo del grafico (predefinito);
Storico - dati dallo storico;
Trend - dati dai trend.
Trigger semplici Selezionare la casella per mostrare le soglie dei trigger semplici. Le soglie verranno disegnate come linee tratteggiate utilizzando il colore di gravità del trigger.
Un trigger semplice è un trigger con una funzione (solo last, max, min, avg) per un item nell'espressione.
È possibile disegnare un massimo di tre trigger. Si noti che il trigger deve trovarsi all'interno dell'intervallo disegnato per essere visibile.
Orario di lavoro Selezionare la casella per mostrare l'orario di lavoro nel grafico. L'orario di lavoro (giorni lavorativi) viene visualizzato nei grafici con uno sfondo bianco, mentre il tempo non lavorativo viene visualizzato in grigio (con il tema frontend predefinito Original blue).
Nomi degli host nelle etichette Scegliere se visualizzare i nomi degli host nella legenda del grafico e nel tooltip che appare passando il cursore sui dati del grafico:
Auto - i nomi degli host vengono visualizzati solo se nei set di dati è presente più di un host (predefinito).
Mostra - i nomi degli host vengono visualizzati.
Nascondi - i nomi degli host vengono nascosti.
Questo parametro non è disponibile durante la configurazione del widget in una dashboard di template.
Linea del percentile (sinistra) Selezionare la casella e inserire il valore del percentile per mostrare il percentile specificato come linea sull'asse Y sinistro del grafico.
Se, ad esempio, è impostato un percentile del 95%, la linea del percentile si troverà al livello sotto il quale ricade il 95 percento dei valori.
Linea del percentile (destra) Selezionare la casella e inserire il valore del percentile per mostrare il percentile specificato come linea sull'asse Y destro del grafico.
Se, ad esempio, è impostato un percentile del 95%, la linea del percentile si troverà al livello sotto il quale ricade il 95 percento dei valori.

Periodo di tempo

La scheda Periodo di tempo consente di impostare un periodo di tempo per il quale visualizzare i dati nel grafico:
Periodo di tempo Selezionare l'origine dati per il periodo di tempo:
Dashboard - utilizza il selettore del periodo di tempo della dashboard;
Widget - utilizza un widget compatibile (impostato nel parametro Widget);
Personalizzato - utilizza un periodo di tempo personalizzato impostato nei parametri Da e A; se impostato, nell'angolo superiore destro del widget verrà visualizzata un'icona a forma di orologio che, al passaggio del mouse, indicherà l'ora impostata.
Si noti che, indipendentemente dalla configurazione di Periodo di tempo del widget, i widget compatibili possono comunque utilizzarlo come origine dati per il periodo di tempo.
Widget Inserire o selezionare un widget compatibile come origine dati per il periodo di tempo.
Questo parametro è disponibile se Periodo di tempo è impostato su "Widget".
Da Inserire o selezionare l'inizio del periodo di tempo.
È supportata la sintassi del tempo relativo (now, now/d, now/w-1w, ecc.).
Questo parametro è disponibile se Periodo di tempo è impostato su "Personalizzato".
A Inserire o selezionare la fine del periodo di tempo.
È supportata la sintassi del tempo relativo (now, now/d, now/w-1w, ecc.).
Questo parametro è disponibile se Periodo di tempo è impostato su "Personalizzato".

Assi

La scheda Assi consente di personalizzare la visualizzazione degli assi:
Y sinistro Selezionare questa casella per rendere visibile l'asse Y sinistro.
La casella può essere disabilitata se non è selezionata né nella scheda Set di dati né nella scheda Sostituzioni.
Y destro Selezionare questa casella per rendere visibile l'asse Y destro.
La casella può essere disabilitata se non è selezionata né nella scheda Set di dati né nella scheda Sostituzioni.
Asse X Deselezionare questa casella per nascondere l'asse X (selezionata per impostazione predefinita).
Scala Scegliere la scala per i valori dell'asse del grafico dal menu a discesa:
Lineare - i valori dell'asse aumentano di una quantità fissa (ad esempio 10, 20, 30), adatta a dati che cambiano in modo costante o coprono un intervallo da piccolo a moderato;
Logaritmica - i valori dell'asse aumentano in modo esponenziale (ad esempio 10, 100, 1000), adatta a dati che cambiano rapidamente o coprono un intervallo ampio.
Min Impostare il valore minimo dell'asse corrispondente.
Viene specificato il valore minimo dell'intervallo visibile dell'asse Y.
Max Impostare il valore massimo dell'asse corrispondente.
Viene specificato il valore massimo dell'intervallo visibile dell'asse Y.
Unità Scegliere l'unità per i valori dell'asse del grafico dal menu a discesa:
Auto - i valori dell'asse vengono visualizzati utilizzando l'unità del primo item nel set di dati;
Statica - i valori dell'asse vengono visualizzati utilizzando l'unità specificata nel campo di input valore; se il campo viene lasciato vuoto, vengono visualizzati solo valori numerici.

Legenda

La scheda Legenda consente di personalizzare la legenda del grafico:
Mostra legenda Deseleziona questa casella di controllo per nascondere la legenda nel grafico (selezionata per impostazione predefinita).
Visualizza min/media/max Seleziona questa casella di controllo per visualizzare nella legenda i valori minimo, medio e massimo dell'item.
Mostra funzione di aggregazione Seleziona questa casella di controllo per mostrare nella legenda la funzione di aggregazione.
Righe Seleziona la modalità di visualizzazione per le righe della legenda:
Fisso - il numero di righe visualizzate è determinato dal valore del parametro Numero di righe;
Variabile - il numero di righe visualizzate è determinato dalla quantità di item configurati, senza superare il valore del parametro Numero massimo di righe.
Numero di righe/
Numero massimo di righe		 Se Righe è impostato su "Fisso", imposta il numero di righe della legenda da visualizzare (1-10).
Se Righe è impostato su "Variabile", imposta il numero massimo di righe della legenda da visualizzare (1-10).
Numero di colonne Imposta il numero di colonne della legenda da visualizzare (1-4).
Questo parametro è disponibile se Visualizza min/media/max non è selezionato.

Problemi

La scheda Problemi consente di personalizzare la visualizzazione dei problemi:
Mostra problemi Selezionare questa casella per abilitare la visualizzazione dei problemi nel grafico (non selezionata, cioè disabilitata per impostazione predefinita).
Solo item selezionati Selezionare questa casella per includere nel grafico solo i problemi relativi agli item selezionati.
Host dei problemi Selezionare gli host dei problemi da visualizzare nel grafico.

È possibile utilizzare modelli con caratteri jolly (ad esempio, * restituirà risultati che corrispondono a zero o più caratteri).
Per specificare un modello con caratteri jolly, inserire semplicemente la stringa manualmente e premere Invio.
Durante la digitazione, notare come tutti gli host corrispondenti vengano visualizzati nel menu a discesa.

Questo parametro non è disponibile durante la configurazione del widget in una dashboard di template.
Gravità Selezionare le gravità dei problemi per filtrare i problemi da visualizzare nel grafico.
Se non viene selezionata alcuna gravità, verranno visualizzati tutti i problemi.
Problema Specificare il nome del problema da visualizzare nel grafico.
Tag del problema Specificare i tag del problema per limitare il numero di problemi visualizzati nel widget.
È possibile includere così come escludere tag specifici e valori dei tag. È possibile impostare diverse condizioni. La corrispondenza del nome del tag distingue sempre tra maiuscole e minuscole.

Sono disponibili diversi operatori per ogni condizione:
Esiste - include i nomi dei tag specificati;
Uguale a - include i nomi e i valori dei tag specificati (con distinzione tra maiuscole e minuscole);
Contiene - include i nomi dei tag specificati in cui i valori dei tag contengono la stringa immessa (corrispondenza per sottostringa, senza distinzione tra maiuscole e minuscole);
Non esiste - esclude i nomi dei tag specificati;
Diverso da - esclude i nomi e i valori dei tag specificati (con distinzione tra maiuscole e minuscole);
Non contiene - esclude i nomi dei tag specificati in cui i valori dei tag contengono la stringa immessa (corrispondenza per sottostringa, senza distinzione tra maiuscole e minuscole).

Per le condizioni sono disponibili due tipi di calcolo:
And/Or - tutte le condizioni devono essere soddisfatte; le condizioni con lo stesso nome del tag verranno raggruppate dalla condizione Or;
Or - è sufficiente che sia soddisfatta una sola condizione.

Overrides

La scheda Overrides consente di aggiungere override personalizzati per i set di dati:

Gli override sono utili quando per un set di dati vengono selezionati più item usando il carattere jolly * e si desidera modificare il modo in cui gli item vengono visualizzati per impostazione predefinita (ad esempio, il colore di base predefinito o qualsiasi altra proprietà).

Gli override esistenti (se presenti) vengono visualizzati in un elenco. Per aggiungere un nuovo override:

  • Fare clic sul pulsante
  • Selezionare host e item per l'override. In alternativa, è possibile inserire pattern di host e item. È possibile usare pattern con caratteri jolly (ad esempio, * restituirà risultati che corrispondono a zero o più caratteri). Per specificare un pattern con caratteri jolly, inserire semplicemente la stringa manualmente e premere Invio. Durante la digitazione, si noti che tutti gli host corrispondenti vengono visualizzati nel menu a discesa. Il simbolo jolly viene sempre interpretato, pertanto non è possibile aggiungere singolarmente, ad esempio, un item denominato "item*" se esistono altri item corrispondenti (ad esempio item2, item3). I parametri del pattern host e del pattern item sono obbligatori. Il parametro per specificare i pattern host non è disponibile quando si configura il widget su una template dashboard. Il parametro per specificare un elenco di item consente di selezionare solo item configurati nel template quando si configura il widget su una template dashboard.
  • Fare clic su per selezionare i parametri dell'override. È necessario selezionare almeno un parametro di override. Per le descrizioni dei parametri, vedere la scheda Data set sopra.