21 Grafico a torta
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget Grafico a torta 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 Grafico a torta, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Grafico a torta.
| 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. |
Data set
I seguenti parametri sono supportati per configurare 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.
| Parametro | 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" |
|
| Item type | 0 | ds.0.type.0 | 0 - (predefinito) Normale; 1 - Totale. Il valore "Total" può essere impostato solo per un item nell'intero grafico. Comportamento del parametro: - supportato 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 il widget viene configurato 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 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 |
|
| Aggregation function | 0 | ds.0.aggregate_function | 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - (predefinito) last. |
|
| Data set aggregation | 0 | ds.0.dataset_aggregation | 0 - (predefinito) nessuna; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum. Comportamento del parametro: - supportato se Item type è impostato su "Total" |
|
| Data set label | 1 | ds.0.data_set_label | Qualsiasi valore stringa. Predefinito: "" (vuoto). |
|
Opzioni di visualizzazione
I seguenti parametri sono supportati per configurare le Opzioni di visualizzazione.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Selezione dei dati storici | 0 | source | 0 - (predefinito) Auto; 1 - Storico; 2 - Trend. |
|
| Disegno | 0 | draw_type | 0 - (predefinito) Torta; 1 - Ciambella. |
|
| Larghezza | 0 | width | 20 - 20% del raggio; 30 - 30% del raggio; 40 - 40% del raggio; 50 - (predefinito) 50% del raggio. Comportamento del parametro: - supportato se Disegno è impostato su "Ciambella" |
|
| Larghezza del bordo | 0 | stroke | I valori possibili vanno da 0 a 10. Predefinito: 0. Comportamento del parametro: - supportato se Disegno è impostato su "Ciambella" |
|
| Mostra valore totale | 0 | total_show | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Disegno è impostato su "Ciambella" |
|
| Dimensione | 0 | value_size_type | 0 - (predefinito) Auto; 1 - Personalizzata. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Dimensione (valore per dimensione personalizzata) | 0 | value_size | I valori possibili vanno da 1 a 100. Predefinito: 20. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Posizioni decimali | 0 | decimal_places | I valori possibili vanno da 0 a 6. Predefinito: 2. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Unità (casella di controllo) | 0 | units_show | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Unità (valore) | 1 | units | Qualsiasi valore stringa. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" |
|
| Grassetto | 0 | value_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Colore | 1 | value_color | Codice colore esadecimale (ad esempio FF0000).Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Spazio tra i settori | 0 | space | I valori possibili vanno da 0 a 10. Predefinito: 1. |
|
| Unisci i settori più piccoli di N% (casella di controllo) | 0 | merge | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
|
| Unisci i settori più piccoli di N% (valore) | 0 | merge_percent | I valori possibili vanno da 1 a 10. Predefinito: 1. Comportamento del parametro: - supportato se Unisci i settori più piccoli di N% (casella di controllo) è impostato su "Abilitato" |
|
| Unisci i settori più piccoli di N% (colore) | 1 | merge_color | Codice colore esadecimale (ad esempio FF0000).Comportamento del parametro: - supportato se Unisci i settori più piccoli di N% (casella di controllo) è impostato su "Abilitato" |
|
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 - obbligatorio 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 - obbligatorio se time_period.from è impostato |
|
Legenda
I seguenti parametri sono supportati per la configurazione della Legenda.
| Parametro | type | name | value |
|---|---|---|---|
| Mostra legenda | 0 | legend | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
| Mostra valore | 0 | legend_value | 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) Fisso; 1 - Variabile. 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 valore è impostato su "Disabilitato" |
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget del widget Grafico a torta.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Grafico a torta
Configurare un widget Grafico a torta nel modo seguente:
- 2 set di dati per un totale di 9 item su 1 host.
- Il primo set di dati è di tipo "Elenco item" ed è composto da 3 item, tutti di tipo "Normale" e rappresentati da un colore diverso.
- Il secondo set di dati è di tipo "Pattern di item", è composto da 6 item, ha un'aggregazione configurata per ciascun item ed è rappresentato da un colore personalizzato.
- Il secondo set di dati ha anche un'etichetta del set di dati personalizzata.
- I dati nel grafico a torta sono visualizzati come grafico ad anello con una larghezza personalizzata e il valore totale con unità al centro.
- I dati nel grafico a torta sono visualizzati e aggregati per un periodo di tempo personalizzato delle ultime 3 ore.
- La legenda del grafico a torta visualizza gli item configurati in 4 righe.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "piechart",
"name": "Pie chart",
"x": 0,
"y": 0,
"width": 24,
"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": 0,
"name": "ds.0.type.0",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.1",
"value": 23269
},
{
"type": 1,
"name": "ds.0.color.1",
"value": "BF00FF"
},
{
"type": 0,
"name": "ds.0.type.1",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.2",
"value": 23257
},
{
"type": 1,
"name": "ds.0.color.2",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.0.type.2",
"value": 0
},
{
"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.aggregate_function",
"value": 3
},
{
"type": 1,
"name": "ds.1.data_set_label",
"value": "Number of processed values per second"
},
{
"type": 0,
"name": "draw_type",
"value": 1
},
{
"type": 0,
"name": "width",
"value": 30
},
{
"type": 0,
"name": "total_show",
"value": 1
},
{
"type": 0,
"name": "units_show",
"value": 1
},
{
"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_lines",
"value": 4
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}