On this page
25 Grafico a dispersione
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare
il widget Scatter plot 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 Scatter plot, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Scatter plot.
| 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 |
Set di dati
I seguenti parametri sono supportati per configurare un Set di dati.
Il primo numero nel nome della proprietà (ad esempio, ds.0.hosts.0, ds.0.items.0) rappresenta lo specifico set di dati, 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 item; 1 - (predefinito) Modelli di item. |
|
| Set di dati: Elenco item | < | < | < | ||
| Colore | < | 1 | ds.0.color.0 | Codice colore esadecimale (ad esempio, FF0000).Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco item" |
|
| Asse X | < | 4 | ds.0.x_axis_itemids.0 | ID item. Quando si configura il widget in una dashboard template, devono essere impostati solo gli item configurati nel template. Nota: Per configurare più item, creare un oggetto campo widget dashboard per ciascun item con un numero incrementato nel nome della proprietà. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco item" e Asse X (Widget) non è impostato |
|
| Asse X (Widget) | < | 1 | ds.0.x_axis_itemids.0._reference | Invece dell'ID 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 widget dashboard per ciascun widget con un numero incrementato nel nome della proprietà. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco item" e Asse X non è impostato |
|
| Asse Y | < | 4 | ds.0.y_axis_itemids.0 | ID item. Quando si configura il widget in una dashboard template, devono essere impostati solo gli item configurati nel template. Nota: Per configurare più item, creare un oggetto campo widget dashboard per ciascun item con un numero incrementato nel nome della proprietà. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco item" e Asse Y (Widget) non è impostato |
|
| Asse Y (Widget) | < | 1 | ds.0.y_axis_itemids.0._reference | Invece dell'ID 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 widget dashboard per ciascun widget con un numero incrementato nel nome della proprietà. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Elenco item" e Asse Y non è impostato |
|
| Sostituisci 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 in una dashboard template. |
|
| Set di dati: Modelli di item | < | < | < | ||
| Colore | < | 1 | ds.0.color | Codice colore esadecimale (ad esempio, FF0000).Comportamento del parametro: - supportato se Tipo di set di dati è impostato su "Modelli di item" e Palette colori non è impostata |
|
| Palette colori | < | 0 | ds.0.color_palette | Indice della palette colori. Intervallo di valori possibili: 0-11. Predefinito: 0. Comportamento del parametro: - supportato se Tipo di set di dati è impostato su "Modelli di item" e Colore non è impostato |
|
| Modelli host | < | 1 | ds.0.hosts.0 | Nome o modello di host (ad esempio, "Zabbix*"). Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Modelli di item" Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Modelli item asse X | < | 1 | ds.0.x_axis_items.0 | Nome o modello di item (ad esempio, "*: Number of processed *values per second"). Quando si configura il widget in una dashboard template, devono essere impostati solo i modelli per gli item configurati nel template. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Modelli di item" |
|
| Modelli item asse Y | < | 1 | ds.0.y_axis_items.0 | Nome o modello di item (ad esempio, "*: Number of processed *values per second"). Quando si configura il widget in una dashboard template, devono essere impostati solo i modelli per gli item configurati nel template. Comportamento del parametro: - obbligatorio se Tipo di set di dati è impostato su "Modelli di item" |
|
| Gruppi host | < | 2 | groupids.0 | ID gruppo host. Nota: Per configurare più gruppi host, creare un oggetto campo widget dashboard per ciascun gruppo host con un numero incrementato nel nome della proprietà. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Gruppi host (Widget) | < | 1 | groupids._reference | Invece dell'ID gruppo host:ABCDE._hostgroupids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per i gruppi host.Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Sostituisci 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 in una dashboard template. |
|
| Tag host | < | < | < | < | |
| < | Tipo di valutazione | 0 | evaltype_host | 0 - (predefinito) And/Or; 2 - Or. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| ^ | Nome tag | 1 | host_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 configurano i Tag host Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| ^ | Operatore | 0 | host_tags.0.operator | 0 - Contiene; 1 - Uguale; 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 configurano i Tag host Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| ^ | Valore tag | 1 | host_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 configurano i Tag host Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Marcatore | < | 0 | ds.0.marker | 0 - (predefinito) Ellisse; 1 - Quadrato; 2 - Triangolo; 3 - Rombo; 4 - Stella; 5 - Croce. |
|
| Dimensione marcatore | < | 0 | ds.0.marker_size | 0 - (predefinito) Piccolo (6px); 1 - Medio (9px); 2 - Grande (15px). |
|
| Spostamento temporale | < | 1 | ds.0.timeshift | Stringa temporale valida (ad esempio, 3600, 1h, ecc.).È possibile usare i suffissi temporali. Sono consentiti anche valori negativi. Predefinito: "" (vuoto). |
|
| Intervallo di aggregazione | < | 1 | ds.0.aggregate_interval | Stringa temporale valida (ad esempio, 3600, 1h, ecc.).È possibile usare i suffissi temporali. Predefinito: 15m. |
|
| Funzione di aggregazione | < | 0 | ds.0.aggregate_function | 0 - non utilizzata; 1 - min; 2 - max; 3 - (predefinito) avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
Opzioni di visualizzazione
I seguenti parametri sono supportati per la configurazione di Opzioni di visualizzazione.
| Parametro | type | name | value |
|---|---|---|---|
| Selezione dei dati storici | 0 | source | 0 - (predefinito) Auto; 1 - Storico; 2 - Trend. |
| Nomi host nelle etichette | 0 | show_hostnames | 0 - (predefinito) Auto; 1 - Mostra; 2 - Nascondi. Questo parametro non è supportato se si configura il widget in una dashboard di template. |
Periodo di tempo
I seguenti parametri sono supportati per la configurazione di Periodo di tempo.
| Parametro | type | name | value | |
|---|---|---|---|---|
| Periodo di tempo | 1 | time_period._reference | DASHBOARD._timeperiod - imposta il selettore del periodo di tempo della dashboard come origine dati;ABCDE._timeperiod - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati.Predefinito: DASHBOARD._timeperiodIn alternativa, è possibile impostare il periodo di tempo solo nei parametri Da e A. |
|
| Da | 1 | time_period.from | Stringa temporale valida nella sintassi temporale 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 |
|
| A | 1 | time_period.to | Stringa temporale valida nella sintassi temporale 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 |
|
Assi
I seguenti parametri sono supportati per la configurazione di Assi.
| Parametro | type | name | value |
|---|---|---|---|
| Asse X | 0 | x_axis | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
| Asse Y | 0 | y_axis | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Min | 1 | x_axis_min | Qualsiasi valore numerico. Predefinito: "" (vuoto). |
| y_axis_min | |||
| Max | 1 | x_axis_max | Qualsiasi valore numerico. Predefinito: "" (vuoto). |
| y_axis_max | |||
| Unità (tipo) | 0 | x_axis_units | 0 - (predefinito) Automatico; 1 - Statico. |
| y_axis_units | |||
| Unità (valore) | 1 | x_axis_static_units | Qualsiasi valore stringa. Predefinito: "" (vuoto). |
| y_axis_static_units |
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 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 | Intervallo di valori possibili: 1-10. Predefinito: 1. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
| Numero di colonne | 0 | legend_columns | Intervallo di valori possibili: 1-4. Predefinito: 4. Comportamento del parametro: - supportato se Mostra legenda è impostato su "Abilitato" |
Soglie
I seguenti parametri sono supportati per la configurazione delle Soglie.
Il numero nel nome della proprietà Thresholds (ad esempio, thresholds.0.color) fa riferimento alla posizione della soglia in un elenco, ordinato in ordine crescente.
Tuttavia, se le soglie sono configurate in un ordine diverso, i valori verranno ordinati in ordine crescente dopo l'aggiornamento della configurazione del widget nel frontend di Zabbix
(ad esempio, "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parametro | type | name | value |
|---|---|---|---|
| Interpolazione del colore | 0 | interpolation | 0 - (predefinito) Disabilitata; 1 - Abilitata. |
| Colore | 1 | thresholds.0.color | Codice colore esadecimale (ad esempio, FF0000). |
| Asse X | 1 | thresholds.0.x_axis_threshold | Qualsiasi valore numerico. Sono supportati i suffissi (ad esempio, "1d", "2w", "4K", "8G"). |
| Asse Y | 1 | thresholds.0.y_axis_threshold | Qualsiasi valore numerico. Sono supportati i suffissi (ad esempio, "1d", "2w", "4K", "8G"). |
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Scatter plot.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Grafico a dispersione
Configurare un widget Grafico a dispersione nel modo seguente:
- 5 set di dati di tipo "Pattern di item", ciascuno con aggregazione predefinita (avg, 15m) e marcatori diversi.
- La legenda visualizza gli item configurati in una singola riga e due colonne.
- Le soglie sono configurate per colorare di rosso un marcatore quando il suo valore raggiunge 80 su qualsiasi asse.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "scatterplot",
"name": "Scatter plot",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.0.color",
"value": "0C5A87"
},
{
"type": 1,
"name": "ds.0.hosts.0",
"value": "de-frankfurt*"
},
{
"type": 1,
"name": "ds.0.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.0.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.0.marker",
"value": 0
},
{
"type": 0,
"name": "ds.0.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.1.color",
"value": "66B0D9"
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "fr-paris*"
},
{
"type": 1,
"name": "ds.1.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.1.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.1.marker",
"value": 1
},
{
"type": 0,
"name": "ds.1.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.2.color",
"value": "0A466A"
},
{
"type": 1,
"name": "ds.2.hosts.0",
"value": "lv-riga*"
},
{
"type": 1,
"name": "ds.2.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.2.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.2.marker",
"value": 2
},
{
"type": 0,
"name": "ds.2.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.3.color",
"value": "3394C3"
},
{
"type": 1,
"name": "ds.3.hosts.0",
"value": "pl-warsaw*"
},
{
"type": 1,
"name": "ds.3.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.3.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.3.marker",
"value": 3
},
{
"type": 0,
"name": "ds.3.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.4.color",
"value": "1492C8"
},
{
"type": 1,
"name": "ds.4.hosts.0",
"value": "se-stockholm*"
},
{
"type": 1,
"name": "ds.4.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.4.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.4.marker",
"value": 4
},
{
"type": 0,
"name": "ds.4.marker_size",
"value": 1
},
{
"type": 0,
"name": "legend_columns",
"value": 2
},
{
"type": 0,
"name": "interpolation",
"value": 1
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.0.x_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "thresholds.0.y_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.1.x_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.y_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "reference",
"value": "JQISY"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}