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").
| Parameter | type | name | value |
|---|---|---|---|
| Angle | 0 | angle | Valori possibili: 180 (predefinito) o 270. |
| Description | |||
| Description | 1 | description | Qualsiasi valore stringa, incluse le macro. Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente.Predefinito: {ITEM.NAME}. |
| Size | 0 | desc_size | Intervallo di valori possibile: 1-100. Predefinito: 15. |
| Vertical position | 0 | desc_v_pos | 0 - In alto; 1 - (predefinito) In basso. |
| Bold | 0 | desc_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Color | 1 | desc_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto). |
| Value | |||
| Decimal places | 0 | decimal_places | Intervallo di valori possibile: 1-10. Predefinito: 2. |
| Size | 0 | value_size | Intervallo di valori possibile: 1-100. Predefinito: 25. |
| Bold | 0 | value_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Color | 1 | value_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto). |
| Units | |||
| Units (checkbox) | 0 | units_show | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
| Units (value) | 1 | units | Qualsiasi valore stringa. Comportamento del parametro: - supportato se Units (checkbox) è impostato su "Abilitato" |
| Size | 0 | units_size | Intervallo di valori possibile: 1-100. Predefinito: 25. Comportamento del parametro: - supportato se Units (checkbox) è impostato su "Abilitato" |
| Bold | 0 | units_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se Units (checkbox) è impostato su "Abilitato" |
| Position | 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 Units (checkbox) è impostato su "Abilitato" Questo parametro viene ignorato se impostato su una delle seguenti unità relative al tempo: unixtime, uptime, s. |
| Color | 1 | units_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto). |
| Value arc | |||
| Arc size | 0 | value_arc_size | Intervallo di valori possibile: 1-100. Predefinito: 20. |
| Needle | |||
| Color | 1 | needle_color | Codice colore esadecimale (ad esempio, FF0000).Predefinito: "" (vuoto).Comportamento del parametro: - supportato se è impostato un oggetto campo del widget della dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Scale | |||
| Show units | 0 | scale_show_units | 0 - Disabilitato; 1 - (predefinito) Abilitato. Comportamento del parametro: - supportato se Units (checkbox) è impostato su "Abilitato" e se è impostato un oggetto campo del widget della dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Size | 0 | scale_size | Intervallo di valori possibile: 1-100. Predefinito: 15. Comportamento del parametro: - supportato se è impostato un oggetto campo del widget della dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Decimal places | 0 | scale_decimal_places | Intervallo di valori possibile: 1-10. Predefinito: 0. Comportamento del parametro: - supportato se è impostato un oggetto campo del widget della dashboard per Show con il valore "Value arc", oppure Show arc è impostato su "Abilitato" |
| Thresholds | |||
| Color | 1 | thresholds.0.color | Codice colore esadecimale (ad esempio, FF0000). |
| Threshold | 1 | thresholds.0.threshold | Qualsiasi valore numerico. Sono supportati i suffissi (ad esempio, "1d", "2w", "4K", "8G"). |
| Show labels | 0 | th_show_labels | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se le Thresholds sono impostate e se è impostato un oggetto campo del widget della dashboard per Show con il valore "Value arc" oppure Show arc è impostato su "Abilitato" |
| Show arc | 0 | th_show_arc | 0 - (predefinito) Disabilitato; 1 - Abilitato. Comportamento del parametro: - supportato se le Thresholds sono impostate |
| Arc size | 0 | th_arc_size | Intervallo di valori possibile: 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
}