8 Grafici
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget Graph nei metodi dashboard.create e dashboard.update.
Le proprietà fields del widget non vengono validate durante la creazione o l'aggiornamento di una dashboard.
Ciò consente agli utenti di modificare i widget integrati e creare widget personalizzati, ma introduce anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o il corretto aggiornamento del widget Graph, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Graph.
| Parametro | type | name | value |
|---|---|---|---|
| Intervallo di aggiornamento | 0 | rf_rate | 0 - Nessun aggiornamento; 10 - 10 secondi; 30 - 30 secondi; 60 - (predefinito) 1 minuto; 120 - 2 minuti; 600 - 10 minuti; 900 - 15 minuti. |
| Riferimento | 1 | reference | Qualsiasi valore stringa composto da 5 caratteri (ad esempio, ABCDE o JBPNL). Questo valore deve essere univoco all'interno della dashboard a cui appartiene il widget.Comportamento del parametro: - obbligatorio |
Data set
I seguenti parametri sono supportati per la configurazione di un Data set.
Il primo numero nel nome della proprietà (ad es. ds.0.hosts.0, ds.0.items.0) rappresenta il particolare data set, mentre il secondo numero, se presente, rappresenta l'host o l'item configurato.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Data set type | 0 | ds.0.dataset_type | 0 - Elenco di item; 1 - (predefinito) Pattern di item. |
|
| Items | 4 | ds.0.itemids.0 | ID dell'item. Quando si configura il widget su un template dashboard, devono essere impostati solo gli item configurati nel template. Nota: per configurare più item, creare un oggetto campo del widget della dashboard per ogni item con un numero incrementato nel nome della proprietà. Comportamento del parametro: - obbligatorio se Data set type è impostato su "Item list" e Items (Widget) non è impostato |
|
| Items (Widget) | 1 | ds.0.itemids.0._reference | Invece dell'ID dell'item:ABCDE._itemid - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli item.Nota: per configurare più widget, creare un oggetto campo del widget della dashboard per ogni widget con un numero incrementato nel nome della proprietà. Comportamento del parametro: - obbligatorio se Data set type è impostato su "Item list" e Items non è impostato |
|
| Color | 1 | ds.0.color.0 | Codice colore esadecimale (ad es. FF0000).Comportamento del parametro: - obbligatorio se Data set type è impostato su "Item list" |
|
| Host patterns | 1 | ds.0.hosts.0 | Nome o pattern dell'host (ad es. "Zabbix*"). Comportamento del parametro: - obbligatorio se Data set type è impostato su "Item patterns" Questo parametro non è supportato se si configura il widget su un template dashboard. |
|
| Item patterns | 1 | ds.0.items.0 | Nome o pattern dell'item (ad es. "*: Number of processed *values per second"). Quando si configura il widget su un template dashboard, devono essere impostati solo i pattern per gli item configurati nel template. Comportamento del parametro: - obbligatorio se Data set type è impostato su "Item patterns" |
|
| Color | 1 | ds.0.color | Codice colore esadecimale (ad es. FF0000).Comportamento del parametro: - supportato se Data set type è impostato su "Item patterns" e Color palette non è impostato |
|
| Color palette | 0 | ds.0.color_palette | Indice della palette di colori. I valori possibili vanno da 0 a 11. Predefinito: 0. Comportamento del parametro: - supportato se Data set type è impostato su "Item patterns" e Color non è impostato |
|
| Draw | 0 | ds.0.type | 0 - (predefinito) Linea; 1 - Punti; 2 - Scala; 3 - Barra. |
|
| Stacked | 0 | ds.0.stacked | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Draw è impostato su "Line", "Staircase" o "Bar" |
|
| Width | 0 | ds.0.width | I valori possibili vanno da 1 a 10. Predefinito: 1. Comportamento del parametro: - supportato se Draw è impostato su "Line" o "Staircase" |
|
| Point size | 0 | ds.0.pointsize | I valori possibili vanno da 1 a 10. Predefinito: 3. Comportamento del parametro: - supportato se Draw è impostato su "Points" |
|
| Transparency | 0 | ds.0.transparency | I valori possibili vanno da 1 a 10. Predefinito: 5. |
|
| Fill | 0 | ds.0.fill | I valori possibili vanno da 1 a 10. Predefinito: 3. Comportamento del parametro: - supportato se Draw è impostato su "Line" o "Staircase" |
|
| Missing data | 0 | ds.0.missingdatafunc | 0 - (predefinito) Nessuno; 1 - Connesso; 2 - Tratta come 0; 3 - Ultimo noto. Comportamento del parametro: - supportato se Draw è impostato su "Line" o "Staircase" |
|
| Override host | 1 | ds.0.override_hostid._reference | ABCDE._hostid- imposta un widget compatibile (con il parametro "Reference" impostato su "ABCDE") come origine dati per gli host;DASHBOARD._hostid - imposta il selettore Host della dashboard come origine dati per gli host.Questo parametro non è supportato se si configura il widget su un template dashboard. |
|
| Y-axis | 0 | ds.0.axisy | 0 - (predefinito) Sinistra; 1 - Destra. |
|
| Time shift | 1 | ds.0.timeshift | Stringa temporale valida (ad es. 3600, 1h, ecc.).È possibile usare i suffissi temporali. Sono consentiti anche valori negativi. Predefinito: "" (vuoto). |
|
| Aggregation function | 0 | ds.0.aggregate_function | 0 - (predefinito) non usato; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
| Aggregation interval | 1 | ds.0.aggregate_interval | Stringa temporale valida (ad es. 3600, 1h, ecc.).È possibile usare i suffissi temporali. Predefinito: 1h. |
|
| Aggregate | 0 | ds.0.aggregate_grouping | 0 - (predefinito) Ogni item; 1 - Data set. Comportamento del parametro: - supportato se Aggregation function è impostato su "min", "max", "avg", "count", "sum", "first" o "last" |
|
| Approximation | 0 | ds.0.approximation | 1 - min; 2 - (predefinito) avg; 4 - max; 7 - all. |
|
| Data set label | 1 | ds.0.data_set_label | Qualsiasi valore stringa. Predefinito: "" (vuoto). |
|
Opzioni di visualizzazione
I seguenti parametri sono supportati per configurare Opzioni di visualizzazione.
| Parametro | type | nome | valore | |
|---|---|---|---|---|
| Selezione dei dati storici | 0 | source | 0 - (predefinito) Automatico; 1 - Storico; 2 - Trend. |
|
| Trigger semplici | 0 | simple_triggers | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
|
| Orario di lavoro | 0 | working_time | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
|
| Linea percentile (sinistra) | ||||
| Stato | 0 | percentile_left | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Asse Y (nella configurazione di Data set) è impostato su "Sinistra" |
|
| Valore | 0 | percentile_left_value | I valori possibili vanno da 1 a 100. Comportamento del parametro: - supportato se Asse Y (nella configurazione di Data set) è impostato su "Sinistra" |
|
| Linea percentile (destra) | ||||
| Stato | 0 | percentile_right | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Asse Y (nella configurazione di Data set) è impostato su "Destra" |
|
| Valore | 0 | percentile_right_value | I valori possibili vanno da 1 a 100. Comportamento del parametro: - supportato se Asse Y (nella configurazione di Data set) è impostato su "Destra" |
|
Periodo di tempo
I seguenti parametri sono supportati per la configurazione di Periodo di tempo.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Periodo di tempo | 1 | time_period._reference | DASHBOARD._timeperiod - imposta il selettore Periodo di tempo come origine dei dati;ABCDE._timeperiod - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dei dati.Predefinito: DASHBOARD._timeperiodIn alternativa, puoi impostare il periodo di tempo solo nei parametri From e To. |
|
| From | 1 | time_period.from | Stringa di tempo valida in sintassi assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - supportato se Periodo di tempo non è impostato - richiesto se time_period.to è impostato |
|
| To | 1 | time_period.to | Stringa di tempo valida in sintassi assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - supportato se Periodo di tempo non è impostato - richiesto se time_period.from è impostato |
|
Assi
I seguenti parametri sono supportati per la configurazione di Assi.
| Parametro | type | name | value |
|---|---|---|---|
| Y sinistro | 0 | lefty | 0 - Disabilitato; 1 - (predefinito) Abilitato. Comportamento del parametro: - supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Sinistra" |
| Y destro | 0 | righty | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Destra" |
| Scala | 0 | lefty_scale | 0 - (predefinito) Lineare; 1 - Logaritmica. |
| righty_scale | |||
| Min | 1 | lefty_min | Qualsiasi valore numerico. Predefinito: "" (vuoto). |
| righty_min | |||
| Max | 1 | lefty_max | Qualsiasi valore numerico. Predefinito: "" (vuoto). |
| righty_max | |||
| Unità (tipo) | 0 | lefty_units | 0 - (predefinito) Automatico; 1 - Statico. |
| righty_units | |||
| Unità (valore) | 1 | lefty_static_units | Qualsiasi valore stringa. Predefinito: "" (vuoto). |
| righty_static_units | |||
| Asse X | 0 | xaxis | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
Legenda
I seguenti parametri sono supportati per la configurazione di Legend.
| Parameter | type | name | value |
|---|---|---|---|
| Mostra legenda | 0 | legend | 0 - Disabilitato; 1 - (predefinito) Abilitato. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
| Mostra min/avg/max | 0 | legend_statistic | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
| Mostra funzione di aggregazione | 0 | legend_aggregation | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
| Righe | 0 | legend_lines_mode | 0 - (predefinito) Fisse; 1 - Variabili. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
| Numero di righe/ Numero massimo di righe |
0 | legend_lines | I valori possibili vanno da 1 a 10. Predefinito: 1. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
| Numero di colonne | 0 | legend_columns | I valori possibili vanno da 1 a 4. Predefinito: 4. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato", e Mostra min/avg/max è impostato su "Disabilitato" |
Problemi
I seguenti parametri sono supportati per la configurazione di Problemi.
| Parametro | type | name | value | |
|---|---|---|---|---|
| Mostra problemi | 0 | show_problems | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
|
| Solo item selezionati | 0 | graph_item_problems | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
|
| Host dei problemi | 1 | problemhosts.0 | Nome Host. Nota: Il numero nel nome della proprietà fa riferimento all'host configurato. Per configurare più host, creare un oggetto campo widget dashboard per ciascun host con un numero incrementato nel nome della proprietà. Questo parametro non è supportato se si configura il widget su una dashboard template. |
|
| Gravità | 0 | severities.0 | 0 - Non classificato; 1 - Informazione; 2 - Avviso; 3 - Medio; 4 - Alto; 5 - Disastro. Predefinito: vuoto (tutti abilitati). Nota: Per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementato nel nome della proprietà. |
|
| Problema | 1 | problem_name | Nome evento del problema (senza distinzione tra maiuscole e minuscole, nome completo o parte di esso). | |
| Tag del problema | ||||
| Tipo di valutazione | 0 | evaltype | 0 - (predefinito) And/Or; 2 - Or. |
|
| Nome tag | 1 | tags.0.tag | Qualsiasi valore stringa. Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag. Comportamento del parametro: - obbligatorio se si configura Tag del problema |
|
| Operatore | 0 | tags.0.operator | 0 - Contiene; 1 - Uguale a; 2 - Non contiene; 3 - Diverso da; 4 - Esiste; 5 - Non esiste. Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag. Comportamento del parametro: - obbligatorio se si configura Tag del problema |
|
| Valore tag | 1 | tags.0.value | Qualsiasi valore stringa. Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag. Comportamento del parametro: - obbligatorio se si configura Tag del problema |
|
Overrides
I seguenti parametri sono supportati per configurare Overrides.
Il primo numero nel nome della proprietà (ad esempio or.0.hosts.0, or.0.items.0) rappresenta il particolare set di dati, mentre il secondo numero, se presente, rappresenta l'host o l'item configurato.
| Parameter | type | name | value |
|---|---|---|---|
| Host patterns | 1 | or.0.hosts.0 | Nome o pattern dell'host (ad esempio Zabbix*).Questo parametro non è supportato se si configura il widget su una template dashboard. Comportamento del parametro: - required se si configurano Overrides |
| Item patterns | 1 | or.0.items.0 | Nome o pattern dell'item (ad esempio *: Number of processed *values per second).Quando si configura il widget su una template dashboard, devono essere impostati solo i pattern per gli item configurati nel template. Comportamento del parametro: - required se si configurano Overrides |
| Base color | 1 | or.0.color | Codice colore esadecimale (ad esempio FF0000). |
| Width | 0 | or.0.width | I valori possibili vanno da 1 a 10. |
| Draw | 0 | or.0.type | 0 - Linea; 1 - Punti; 2 - Scala; 3 - Barra. |
| Transparency | 0 | or.0.transparency | I valori possibili vanno da 1 a 10. |
| Fill | 0 | or.0.fill | I valori possibili vanno da 1 a 10. |
| Point size | 0 | or.0.pointsize | I valori possibili vanno da 1 a 10. |
| Missing data | 0 | or.0.missingdatafunc | 0 - Nessuno; 1 - Collegato; 2 - Tratta come 0; 3 - Ultimo noto. |
| Y-axis | 0 | or.0.axisy | 0 - Sinistra; 1 - Destra. |
| Time shift | 1 | or.0.timeshift | Stringa temporale valida (ad esempio 3600, 1h, ecc.).È possibile usare i suffissi temporali. Sono consentiti valori negativi. |
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Graph.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Graph
Configurare un widget Graph nel modo seguente:
- 2 set di dati per un totale di 9 item su 1 host.
- Il primo set di dati è di tipo "Item list" ed è composto da 3 item rappresentati da linee con colore diverso, ma con la stessa larghezza, trasparenza e riempimento.
- Il secondo set di dati è di tipo "Item patterns", è composto da 6 item, ha un'aggregazione configurata ed è rappresentato da una linea con colore, larghezza, trasparenza e riempimento personalizzati.
- Il secondo set di dati ha anche un'etichetta personalizzata del set di dati.
- I dati nel grafico vengono visualizzati per un periodo di tempo corrispondente alle ultime 3 ore.
- I problemi nel grafico vengono visualizzati solo per gli item configurati.
- Il grafico ha due assi Y, di cui l'asse Y destro visualizza valori solo per il secondo set di dati.
- La legenda del grafico visualizza gli item configurati in 4 righe, nonché i valori minimo, massimo e medio dei set di dati.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "svggraph",
"name": "Graph",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "ds.0.dataset_type",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.0",
"value": 23264
},
{
"type": 1,
"name": "ds.0.color.0",
"value": "FF0000"
},
{
"type": 4,
"name": "ds.0.itemids.1",
"value": 23269
},
{
"type": 1,
"name": "ds.0.color.1",
"value": "BF00FF"
},
{
"type": 4,
"name": "ds.0.itemids.2",
"value": 23257
},
{
"type": 1,
"name": "ds.0.color.2",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.0.width",
"value": 3
},
{
"type": 0,
"name": "ds.0.transparency",
"value": 3
},
{
"type": 0,
"name": "ds.0.fill",
"value": 1
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.1.items.0",
"value": "*: Number of processed *values per second"
},
{
"type": 1,
"name": "ds.1.color",
"value": "000000"
},
{
"type": 0,
"name": "ds.1.transparency",
"value": 0
},
{
"type": 0,
"name": "ds.1.fill",
"value": 0
},
{
"type": 0,
"name": "ds.1.axisy",
"value": 1
},
{
"type": 0,
"name": "ds.1.aggregate_function",
"value": 3
},
{
"type": 1,
"name": "ds.1.aggregate_interval",
"value": "1m"
},
{
"type": 0,
"name": "ds.1.aggregate_grouping",
"value": 1
},
{
"type": 1,
"name": "ds.1.data_set_label",
"value": "Number of processed values per second"
},
{
"type": 0,
"name": "graph_time",
"value": 1
},
{
"type": 1,
"name": "time_period.from",
"value": "now-3h"
},
{
"type": 1,
"name": "time_period.to",
"value": "now"
},
{
"type": 0,
"name": "legend_statistic",
"value": 1
},
{
"type": 0,
"name": "legend_lines",
"value": 4
},
{
"type": 0,
"name": "show_problems",
"value": 1
},
{
"type": 1,
"name": "reference",
"value": "YZABC"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}