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. |
Set di dati
I seguenti parametri sono supportati per la configurazione di un set di dati.
Il primo numero nel nome della proprietà (ad es. ds.0.hosts.0, ds.0.items.0) rappresenta il set di dati specifico, mentre il secondo numero, se presente, rappresenta l'host o l'item configurato.
| Parametro | type | name | value | |
|---|---|---|---|---|
| Tipo di set di dati | 0 | ds.0.dataset_type | 0 - Elenco di item; 1 - (predefinito) Pattern di item. |
|
| Item | 4 | ds.0.itemids.0 | ID dell'item. Quando si configura il widget in una dashboard di template, impostare solo gli item configurati nel template. Nota: per configurare più item, creare un oggetto campo del widget della dashboard per ogni item, incrementando il numero nel nome della proprietà. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco di item" e Item (widget) non è impostato |
|
| Item (widget) | 1 | ds.0.itemids.0._reference | Invece dell'ID dell'item:ABCDE._itemid - impostare un widget compatibile (con il parametro Riferimento 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, incrementando il numero nel nome della proprietà. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco di item" e Item non è impostato |
|
| Colore | 1 | ds.0.color.0 | Codice colore esadecimale (ad es. FF0000).Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco di item" |
|
| Tipo di item | 0 | ds.0.type.0 | 0 - (predefinito) Normale; 1 - Totale. Il valore "Totale" può essere impostato per un solo item nell'intero grafico. Comportamento del parametro: - supportato se Tipo di set di dati è impostato su "Elenco di item" |
|
| Pattern di host | 1 | ds.0.hosts.0 | Nome o pattern dell'host (ad es. "Zabbix*"). Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Pattern di item" Questo parametro non è supportato quando si configura il widget in una dashboard di template. |
|
| Pattern di item | 1 | ds.0.items.0 | Nome o pattern dell'item (ad es. "*: Numero di *valori elaborati al secondo"). Quando si configura il widget in una dashboard di template, impostare solo i pattern degli item configurati nel template. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Pattern di item" |
|
| Colore | 1 | ds.0.color | Codice colore esadecimale (ad es. FF0000).Comportamento del parametro: - supportato se Tipo di set di dati è impostato su "Pattern di item" e Tavolozza dei colori non è impostata |
|
| Tavolozza dei colori | 0 | ds.0.color_palette | Indice della tavolozza dei colori. I valori possibili vanno da 0 a 11. Predefinito: 0. Comportamento del parametro: - supportato se Tipo di set di dati è impostato su "Pattern di item" e Colore non è impostato |
|
| Funzione di aggregazione | 0 | ds.0.aggregate_function | 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - (predefinito) last. |
|
| Aggregazione del set di dati | 0 | ds.0.dataset_aggregation | 0 - (predefinito) nessuna; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum. Comportamento del parametro: - supportato se Tipo di item è impostato su "Totale" |
|
| Etichetta del set di dati | 1 | ds.0.data_set_label | Qualsiasi valore stringa. Predefinito: "" (vuoto). |
|
Visualizzazione delle opzioni
I seguenti parametri sono supportati per la configurazione delle opzioni di visualizzazione.
| Parametro | type | name | value | |
|---|---|---|---|---|
| Selezione dei dati cronologici | 0 | source | 0 - (predefinito) Automatico; 1 - Cronologia; 2 - Tendenze. |
|
| Disegno | 0 | draw_type | 0 - (predefinito) Grafico a torta; 1 - Grafico ad anello. |
|
| 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 "Grafico ad anello" |
|
| Larghezza del tratto | 0 | stroke | I valori possibili sono compresi tra 0 e 10. Predefinito: 0. Comportamento del parametro: - supportato se Disegno è impostato su "Grafico ad anello" |
|
| Mostra valore totale | 0 | total_show | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Disegno è impostato su "Grafico ad anello" |
|
| Dimensione | 0 | value_size_type | 0 - (predefinito) Automatico; 1 - Personalizzata. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Dimensione (valore per la dimensione personalizzata) | 0 | value_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 20. Comportamento del parametro: - supportato se Mostra valore totale è impostato su "Abilitato" |
|
| Posizioni decimali | 0 | decimal_places | I valori possibili sono compresi tra 0 e 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 sono compresi tra 0 e 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 sono compresi tra 1 e 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 | tipo | nome | valore |
|---|---|---|---|
| Mostra legenda | 0 | legend | 0 - Disabilitata; 1 - (predefinita) Abilitata. |
| Mostra valore | 0 | legend_value | 0 - (predefinita) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitata" |
| Mostra funzione di aggregazione | 0 | legend_aggregation | 0 - (predefinita) Disabilitata; 1 - Abilitata. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitata" |
| Righe | 0 | legend_lines_mode | 0 - (predefinita) Fisse; 1 - Variabili. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitata" |
| Numero di righe/ Numero massimo di righe |
0 | legend_lines | I valori possibili sono compresi tra 1 e 10. Predefinito: 1. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitata" |
| Numero di colonne | 0 | legend_columns | I valori possibili sono compresi tra 1 e 4. Predefinito: 4. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitata" 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
}