8 Grafici

Panoramica

Il widget graph offre un modo moderno e versatile per visualizzare i dati raccolti da Zabbix utilizzando una tecnica di disegno di immagini vettoriali. Questo widget graph è supportato a partire da Zabbix 4.0. Si noti che il widget graph supportato prima di Zabbix 4.0 può ancora essere utilizzato come Graph (classic). Vedere anche la sezione Aggiunta di widget nella pagina Dashboards per ulteriori dettagli.

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:

Data set

La scheda Data set consente di selezionare i dati per il grafico aggiungendo dei data set. È possibile aggiungere due tipi di data set:

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

Per impostazione predefinita, viene aggiunto un data set Item patterns.
Data set Per il data set Item patterns:
Selezionare o immettere 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 wildcard (ad esempio, * restituirà i risultati che corrispondono a zero o più caratteri).
Per specificare un pattern con wildcard, immettere manualmente la stringa e premere Enter.
Il simbolo wildcard viene sempre interpretato, quindi non è possibile aggiungere, ad esempio, un item denominato item* singolarmente se esistono altri item corrispondenti (ad esempio, item2, item3).
La specifica dei pattern di host e item è obbligatoria per i data set "Item patterns".
Vedere anche: Dettagli di configurazione del data set.

Per il data set Item list:
Selezionare gli item per il grafico facendo clic sul pulsante Add item.
È inoltre possibile selezionare widget compatibili come origine dati per gli item facendo clic sul pulsante Add widget.
La specifica di item o widget è obbligatoria per i data set "Item list".
Vedere anche: Dettagli di configurazione del data set.

Si noti che sono consentiti solo tipi di item numerici.

Quando si configura 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 Scegliere il tipo di disegno della metrica.
Tipi di disegno disponibili: Line (impostato per default), Points, Staircase e Bar.
Si noti che se nel grafico lineare/a gradini è 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 Selezionare la casella di controllo per visualizzare i dati come impilati (aree riempite visualizzate).
Questa opzione è disabilitata quando è selezionato il tipo di disegno Points.
Width Impostare la larghezza della linea.
Questa opzione è disponibile quando è selezionato il tipo di disegno Line o Staircase.
Point size Impostare la dimensione del punto.
Questa opzione è disponibile quando è selezionato il tipo di disegno Points.
Transparency Impostare il livello di trasparenza.
Fill Impostare il livello di riempimento.
Questa opzione è disponibile quando è selezionato il tipo di disegno Line o Staircase.
Missing data Selezionare l'opzione per la visualizzazione dei 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 ai tipi di disegno Points e Bar.
Override host Selezionare un widget compatibile o il dashboard come origine dati per gli host.
Questo parametro non è disponibile quando si configura il widget in una template dashboard.
Y-axis Selezionare il lato del grafico in cui verrà visualizzato l'asse Y.
Time shift Specificare lo spostamento temporale, se necessario.
In questo campo è possibile usare i time suffixes. Sono consentiti valori negativi.
Aggregation function Specificare quale funzione di aggregazione usare per ciascun item o per l'intero data set 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).

Per min, max, avg e sum possono essere visualizzati solo dati numerici. Per count, i dati non numerici verranno convertiti in numerici.
Vedere anche: Aggregazione nei grafici.
Aggregation interval Specificare l'intervallo per l'aggregazione dei valori.
In questo campo è possibile usare i time suffixes. Un valore numerico senza suffisso sarà considerato in secondi.

Si noti che se il widget è configurato per visualizzare dati storici basati sui trends (History data selection è impostato su Trends o Auto), si consiglia di 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ò produrre risultati difficili da interpretare.
Aggregate Specificare se aggregare:
Each item - ogni item nel data set verrà aggregato e visualizzato separatamente;
Data set - tutti gli item del data set verranno aggregati e visualizzati come un unico valore.
Approximation Specificare 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 lungo periodo di tempo con un intervallo di aggiornamento frequente (ad esempio, un anno di valori raccolti ogni 10 minuti).
Data set label Specificare l'etichetta del data set visualizzata nella configurazione Data set del grafico e nella Legend del grafico (per i data set aggregati).
Tutti i data set sono numerati, inclusi quelli con un Data set label specificato. Se non viene specificata alcuna etichetta, il data set verrà etichettato automaticamente in base al proprio numero (ad esempio, "Data set #2", "Data set #3", ecc.). La numerazione dei data set viene ricalcolata dopo il riordino/trascinamento dei data set.
Le etichette dei data set troppo lunghe verranno abbreviate per adattarsi allo spazio disponibile (ad esempio, "Number of proc...").
Dettagli di configurazione del set di dati

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

  • 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. È possibile inserire un codice esadecimale, scegliere un campione a tinta unita 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. Usare Tab per spostarsi tra i controlli della finestra di dialogo, i tasti freccia per navigare tra i campioni 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 degli item. Se si fa 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 il 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 Item list contiene il pulsante Add item che consente di aggiungere item da visualizzare nel grafico. È inoltre possibile aggiungere widget compatibili come data source per gli item facendo clic sul pulsante Add widget.

Ad esempio, facendo clic sul pulsante Add item si apre una finestra popup contenente un parametro Host. Dopo aver selezionato un host, tutti i relativi 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, medio, ecc.) su 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 a ciascun item separatamente 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 più basso 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 su cinque minuti (aggregato da valori medi di un minuto), confrontato con il carico medio della CPU su cinque minuti.

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

Visualizzazione delle opzioni

La scheda Visualizzazione delle opzioni consente di definire la selezione dei dati storici:
Selezione dei dati storici Imposta la sorgente dei dati del grafico:
Auto - i dati vengono ottenuti in base al classico algoritmo del grafico (predefinito);
History - dati dalla history;
Trends - dati dalle trends.
Trigger semplici Seleziona la casella di controllo per mostrare le soglie dei trigger semplici. Le soglie verranno disegnate come linee tratteggiate usando il colore della severità del trigger.
Un trigger semplice è un trigger con una sola funzione (solo last, max, min, avg) per un item nell'espressione.
È possibile disegnare al massimo tre trigger. Nota che il trigger deve rientrare nell'intervallo visualizzato per essere visibile.
Orario di lavoro Seleziona la casella di controllo 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).
Linea percentile (sinistra) Seleziona la casella di controllo e inserisci il valore del percentile per mostrare il percentile specificato come linea sull'asse Y sinistro del grafico.
Ad esempio, se è impostato un percentile del 95%, la linea del percentile sarà al livello sotto il quale ricade il 95% dei valori.
Linea percentile (destra) Seleziona la casella di controllo e inserisci il valore del percentile per mostrare il percentile specificato come linea sull'asse Y destro del grafico.
Ad esempio, se è impostato un percentile del 95%, la linea del percentile sarà al livello sotto il quale ricade il 95% 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:
Time period Selezionare la sorgente dati per il periodo di tempo:
Dashboard - imposta il selettore Time period come sorgente dati;
Widget - imposta come sorgente dati un widget compatibile specificato nel parametro Widget;
Custom - imposta come sorgente dati il periodo di tempo specificato nei parametri From e To; se impostato, nell'angolo in alto a destra del widget verrà visualizzata un'icona a forma di orologio, che indica l'orario impostato al passaggio del mouse.
Widget Inserire o selezionare un widget compatibile come sorgente dati per il periodo di tempo.
Questo parametro è disponibile se Time period è impostato su "Widget".
From 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 Time period è impostato su "Custom".
To 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 Time period è impostato su "Custom".

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 Problems consente di personalizzare la visualizzazione dei problemi:
Show problems Seleziona questa casella di controllo per abilitare la visualizzazione dei problemi nel grafico (non selezionata, cioè disabilitata per impostazione predefinita).
Selected items only Seleziona questa casella di controllo per includere nel grafico solo i problemi relativi agli item selezionati.
Problem hosts Seleziona gli host dei problemi da visualizzare nel grafico.

È 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 semplicemente la stringa manualmente e premi Enter.
Mentre digiti, osserva come tutti gli host corrispondenti vengono visualizzati nel menu a discesa.

Questo parametro non è disponibile quando si configura il widget in una template dashboard.
Severity Seleziona le severità dei problemi per filtrare i problemi da visualizzare nel grafico.
Se non viene selezionata alcuna severità, verranno visualizzati tutti i problemi.
Problem Specifica il nome del problema da visualizzare nel grafico.
Problem tags Specifica i tag dei problemi per limitare il numero di problemi 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 e minuscole.

Sono disponibili diversi operatori per ciascuna condizione:
Exists - include i nomi dei tag specificati;
Equals - include i nomi e i valori dei tag specificati (sensibile alle maiuscole e minuscole);
Contains - include i nomi dei tag specificati in cui i valori del tag contengono la stringa inserita (corrispondenza di sottostringa, non sensibile alle maiuscole e 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 e minuscole);
Does not contain - esclude i nomi dei tag specificati in cui i valori del tag contengono la stringa inserita (corrispondenza di sottostringa, non sensibile alle maiuscole e 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 dalla condizione Or;
Or - è sufficiente che una condizione sia soddisfatta.

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 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 per 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 come tutti gli host corrispondenti vengano visualizzati nel menu a discesa. Il simbolo del carattere jolly viene sempre interpretato, pertanto non è possibile aggiungere, ad esempio, un item denominato "item*" singolarmente se esistono altri item corrispondenti (ad esempio item2, item3). I parametri del pattern per host e del pattern per item sono obbligatori. Il parametro per specificare i pattern per 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 sul template quando si configura il widget su una template dashboard.
  • Fare clic su , per selezionare i parametri dell'override. Deve essere selezionato almeno un parametro di override. Per le descrizioni dei parametri, vedere la scheda Data set sopra.