On this page
6 Misuratore
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget Misuratore nei metodi dashboard.create e dashboard.update.
Le proprietà fields del widget non vengono convalidate durante la creazione o l'aggiornamento di una dashboard.
Questo consente agli utenti di modificare i widget built-in e creare widget personalizzati, ma comporta anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o l'aggiornamento del widget Misuratore, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Gauge.
| 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. |
|
| Item | 4 | itemid.0 | ID item. Comportamento del parametro: - obbligatorio se Item (Widget) non è impostato |
|
| Item (Widget) | 1 | itemid._reference | Invece dell'ID item:ABCDE._itemid - imposta un widget compatibile (con il relativo parametro Reference impostato su "ABCDE") come origine dati per gli item.Comportamento del parametro: - obbligatorio se Item non è impostato |
|
| Min | 1 | min | Qualsiasi valore numerico. I suffissi (ad es. "1d", "2w", "4K", "8G") sono supportati. Predefinito: "0". |
|
| Max | 1 | max | Qualsiasi valore numerico. I suffissi (ad es. "1d", "2w", "4K", "8G") sono supportati. Predefinito: "100". |
|
| Arco del valore | 1 | value_arc_color | Codice colore esadecimale (ad es. FF0000).Predefinito: "" (vuoto). |
|
| Sfondo dell'arco | 1 | empty_color | Codice colore esadecimale (ad es. FF0000).Predefinito: "" (vuoto). |
|
| Sfondo | 1 | bg_color | Codice colore esadecimale (ad es. FF0000).Predefinito: "" (vuoto). |
|
| Mostra | 0 | show.0 | 1 - Descrizione; 2 - Valore; 3 - Lancetta; 4 - Scala; 5 - Arco del valore. Nota: per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementato nel nome della proprietà. Predefinito: 1, 2, 4, 5. I valori "Lancetta" e "Scala" non sono supportati se entrambe le condizioni seguenti sono vere: - non è impostato alcun oggetto campo widget dashboard per Mostra con il valore "Arco del valore"; - il parametro di configurazione avanzata Show arc è impostato su "Disabled". I parametri di configurazione avanzata per le opzioni di Mostra non sono supportati se non è impostato alcun oggetto campo widget dashboard con i rispettivi valori. |
|
| Sostituisci host | 1 | override_hostid._reference | ABCDE._hostid - imposta un widget compatibile (con il relativo 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. |
|
Configurazione avanzata
I seguenti parametri di configurazione avanzata sono supportati per il widget Gauge.
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 | tipo | nome | valore |
|---|---|---|---|
| Angolo | 0 | angle | Valori possibili: 180 (predefinito) o 270. |
| Descrizione | |||
| Descrizione | 1 | description | Qualsiasi valore stringa, incluse le macro. Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente.Predefinito: {ITEM.NAME}. |
| Dimensione | 0 | desc_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 15. |
| Posizione verticale | 0 | desc_v_pos | 0 - In alto; 1 - In basso (predefinito). |
| Grassetto | 0 | desc_bold | 0 - Disabilitato (predefinito); 1 - Abilitato. |
| Colore | 1 | desc_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto). |
| Valore | |||
| Posizioni decimali | 0 | decimal_places | I valori possibili sono compresi tra 1 e 10. Predefinito: 2. |
| Dimensione | 0 | value_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 25. |
| Grassetto | 0 | value_bold | 0 - Disabilitato (predefinito); 1 - Abilitato. |
| Colore | 1 | value_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto). |
| Unità | |||
| Unità (casella di controllo) | 0 | units_show | 0 - Disabilitato; 1 - Abilitato (predefinito). |
| Unità (valore) | 1 | units | Qualsiasi valore stringa. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" |
| Dimensione | 0 | units_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 25. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" |
| Grassetto | 0 | units_bold | 0 - Disabilitato (predefinito); 1 - Abilitato. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" |
| Posizione | 0 | units_pos | 0 - Prima del valore; 1 - Sopra il valore; 2 - Dopo il valore (predefinito); 3 - Sotto il valore. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" Questo parametro viene ignorato se impostato su una delle seguenti unità relative al tempo: unixtime, uptime, s. |
| Colore | 1 | units_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto). |
| Arco del valore | |||
| Dimensione dell'arco | 0 | value_arc_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 20. |
| Lancetta | |||
| Colore | 1 | needle_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto).Comportamento del parametro: - supportato se è impostato un oggetto campo del widget dashboard per Mostra con il valore "Arco del valore", oppure se Mostra arco è impostato su "Abilitato" |
| Scala | |||
| Mostra unità | 0 | scale_show_units | 0 - Disabilitato; 1 - Abilitato (predefinito). Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" e se è impostato un oggetto campo del widget dashboard per Mostra con il valore "Arco del valore", oppure Mostra arco è impostato su "Abilitato" |
| Dimensione | 0 | scale_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 15. Comportamento del parametro: - supportato se è impostato un oggetto campo del widget dashboard per Mostra con il valore "Arco del valore", oppure se Mostra arco è impostato su "Abilitato" |
| Posizioni decimali | 0 | scale_decimal_places | I valori possibili sono compresi tra 1 e 10. Predefinito: 0. Comportamento del parametro: - supportato se è impostato un oggetto campo del widget dashboard per Mostra con il valore "Arco del valore", oppure se Mostra arco è impostato su "Abilitato" |
| Soglie | |||
| Colore | 1 | thresholds.0.color | Codice colore esadecimale (ad esempio, FF0000). |
| Soglia | 1 | thresholds.0.threshold | Qualsiasi valore numerico. Sono supportati i suffissi (ad esempio, "1d", "2w", "4K", "8G"). |
| Mostra etichette | 0 | th_show_labels | 0 - Disabilitato (predefinito); 1 - Abilitato. Comportamento del parametro: - supportato se sono impostate le Soglie e se è impostato un oggetto campo del widget dashboard per Mostra con il valore "Arco del valore", oppure Mostra arco è impostato su "Abilitato" |
| Mostra arco | 0 | th_show_arc | 0 - Disabilitato (predefinito); 1 - Abilitato. Comportamento del parametro: - supportato se sono impostate le Soglie |
| Dimensione dell'arco | 0 | th_arc_size | I valori possibili sono compresi tra 1 e 100. Predefinito: 5. Comportamento del parametro: - supportato se Mostra arco è impostato su "Abilitato" |
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Gauge.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Gauge
Configurare un widget Gauge che visualizza il valore dell'item per l'item "44474" (Interfaccia enp0s3: Bit inviati). Inoltre, perfezionare visivamente il widget con più opzioni avanzate, incluse le soglie.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "gauge",
"name": "Gauge",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 44474
},
{
"type": 1,
"name": "min",
"value": "100000"
},
{
"type": 1,
"name": "max",
"value": "1000000"
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 0,
"name": "show.4",
"value": 4
},
{
"type": 0,
"name": "show.5",
"value": 5
},
{
"type": 0,
"name": "angle",
"value": 270
},
{
"type": 0,
"name": "desc_size",
"value": 10
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 0,
"name": "decimal_places",
"value": 0
},
{
"type": 0,
"name": "value_bold",
"value": 1
},
{
"type": 0,
"name": "units_size",
"value": 15
},
{
"type": 0,
"name": "units_pos",
"value": 3
},
{
"type": 1,
"name": "needle_color",
"value": "3C3C3C"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "700000"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "500000"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "100000"
},
{
"type": 0,
"name": "th_show_labels",
"value": 1
},
{
"type": 0,
"name": "th_show_arc",
"value": 1
},
{
"type": 0,
"name": "th_arc_size",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}