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 | type | name | value |
|---|---|---|---|
| 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 | Valori possibili nell'intervallo 1-100. Predefinito: 15. |
| Posizione verticale | 0 | desc_v_pos | 0 - In alto; 1 - (predefinito) In basso. |
| Grassetto | 0 | desc_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | desc_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
| Valore | |||
| Posizioni decimali | 0 | decimal_places | Valori possibili nell'intervallo 1-10. Predefinito: 2. |
| Dimensione | 0 | value_size | Valori possibili nell'intervallo 1-100. Predefinito: 25. |
| Grassetto | 0 | value_bold | 0 - (predefinito) Disabilitato; 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 - (predefinito) Abilitato. |
| Unità (valore) | 1 | units | Qualsiasi valore stringa. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" |
| Dimensione | 0 | units_size | Valori possibili nell'intervallo 1-100. Predefinito: 25. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" |
| Grassetto | 0 | units_bold | 0 - (predefinito) Disabilitato; 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 - (predefinito) Dopo il valore; 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 arco | 0 | value_arc_size | Valori possibili nell'intervallo 1-100. Predefinito: 20. |
| Ago | |||
| Colore | 1 | needle_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto).Comportamento del parametro: - supportato se è impostato un oggetto campo widget dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Scala | |||
| Mostra unità | 0 | scale_show_units | 0 - Disabilitato; 1 - (predefinito) Abilitato. Comportamento del parametro: - supportato se Unità (casella di controllo) è impostato su "Abilitato" e se è impostato un oggetto campo widget dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Dimensione | 0 | scale_size | Valori possibili nell'intervallo 1-100. Predefinito: 15. Comportamento del parametro: - supportato se è impostato un oggetto campo widget dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Posizioni decimali | 0 | scale_decimal_places | Valori possibili nell'intervallo 1-10. Predefinito: 0. Comportamento del parametro: - supportato se è impostato un oggetto campo widget dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Soglie | |||
| Colore | 1 | thresholds.0.color | Codice colore esadecimale (ad esempio FF0000). |
| Soglia | 1 | thresholds.0.threshold | Qualsiasi valore numerico. I suffissi (ad esempio "1d", "2w", "4K", "8G") sono supportati. |
| Mostra etichette | 0 | th_show_labels | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se le Soglie sono impostate e se è impostato un oggetto campo widget dashboard per Show con il valore "Value arc" oppure Show arc è impostato su "Abilitato" |
| Mostra arco | 0 | th_show_arc | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se le Soglie sono impostate |
| Dimensione arco | 0 | th_arc_size | Valori possibili nell'intervallo 1-100. Predefinito: 5. Comportamento del parametro: - supportato se Show arc è 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
}