[comment]: # ({364afe17-7f83c4c7})
# 6 Misuratore

[comment]: # ({/364afe17-7f83c4c7})

[comment]: # ({fc686620-1c93902f})
### Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget [*Misuratore*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge) nei metodi `dashboard.create` e `dashboard.update`.

::: noteimportant
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](/manual/web_interface/frontend_sections/dashboards/widgets) e creare [widget personalizzati](/devel/modules/tutorials/widget), 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.
:::

[comment]: # ({/fc686620-1c93902f})

[comment]: # ({a07c7b8d-2e17e0ed})
### Parametri

I seguenti parametri sono supportati per il widget *Gauge*.

|Parametro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|-----|-|-----|-------------------|
|*Intervallo di aggiornamento*|<|0|rf_rate|0 - Nessun aggiornamento;<br>10 - 10 secondi;<br>30 - 30 secondi;<br>60 - *(predefinito)* 1 minuto;<br>120 - 2 minuti;<br>600 - 10 minuti;<br>900 - 15 minuti.|
|*Item*|<|4|itemid.0|ID [item](/manual/api/reference/item/get).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Item (Widget)* non è impostato|
|<|*Item (Widget)*|1|itemid.\_reference|Invece dell'ID [item](/manual/api/reference/item/get):<br>`ABCDE._itemid` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il relativo parametro *Reference* impostato su "`ABCDE`") come origine dati per gli item.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Item* non è impostato|
|*Min*|<|1|min|Qualsiasi valore numerico. I [suffissi](/manual/appendix/suffixes) (ad es. "1d", "2w", "4K", "8G") sono supportati.<br><br>Predefinito: "0".|
|*Max*|<|1|max|Qualsiasi valore numerico. I [suffissi](/manual/appendix/suffixes) (ad es. "1d", "2w", "4K", "8G") sono supportati.<br><br>Predefinito: "100".|
|*Arco del valore*|<|1|value_arc_color|Codice colore esadecimale (ad es. `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|*Sfondo dell'arco*|<|1|empty_color|Codice colore esadecimale (ad es. `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|*Sfondo*|<|1|bg_color|Codice colore esadecimale (ad es. `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|*Mostra*|<|0|show.0|1 - Descrizione;<br>2 - Valore;<br>3 - Lancetta;<br>4 - Scala;<br>5 - Arco del valore.<br><br>Nota: per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementato nel nome della proprietà.<br><br>Predefinito: 1, 2, 4, 5.<br><br>I valori "Lancetta" e "Scala" non sono supportati se entrambe le condizioni seguenti sono vere:<br>- non è impostato alcun oggetto campo widget dashboard per *Mostra* con il valore "Arco del valore";<br>- il parametro di [configurazione avanzata](#advanced-configuration) *Show arc* è impostato su "Disabled".<br><br>I parametri di [configurazione avanzata](#advanced-configuration) 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](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il relativo parametro *Reference* impostato su "`ABCDE`") come origine dati per gli host;<br>`DASHBOARD._hostid` - imposta il [selettore host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) della dashboard come origine dati per gli host.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|

[comment]: # ({/a07c7b8d-2e17e0ed})

[comment]: # ({7886dec5-1db7caf7})
#### Configurazione avanzata

I seguenti parametri di configurazione avanzata sono supportati per il widget *Gauge*.

::: noteclassic
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](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Angolo*|0|angle|Valori possibili: 180 *(predefinito)* o 270.|
|***Descrizione***|<|<|<|
|*Descrizione*|1|description|Qualsiasi valore stringa, incluse le macro.<br>Macro supportate: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macro utente.<br><br>Predefinito: {ITEM.NAME}.|
|*Dimensione*|0|desc_size|Valori possibili nell'intervallo 1-100.<br><br>Predefinito: 15.|
|*Posizione verticale*|0|desc_v_pos|0 - In alto;<br>1 - *(predefinito)* In basso.|
|*Grassetto*|0|desc_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Colore*|1|desc_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|***Valore***|<|<|<|
|*Posizioni decimali*|0|decimal_places|Valori possibili nell'intervallo 1-10.<br><br>Predefinito: 2.|
|*Dimensione*|0|value_size|Valori possibili nell'intervallo 1-100.<br><br>Predefinito: 25.|
|*Grassetto*|0|value_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Colore*|1|value_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|***Unità***|<|<|<|
|*Unità* (casella di controllo)|0|units_show|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.|
|*Unità* (valore)|1|units|Qualsiasi valore stringa.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unità* (casella di controllo) è impostato su "Abilitato"|
|*Dimensione*|0|units_size|Valori possibili nell'intervallo 1-100.<br><br>Predefinito: 25.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unità* (casella di controllo) è impostato su "Abilitato"|
|*Grassetto*|0|units_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unità* (casella di controllo) è impostato su "Abilitato"|
|*Posizione*|0|units_pos|0 - Prima del valore;<br>1 - Sopra il valore;<br>2 - *(predefinito)* Dopo il valore;<br>3 - Sotto il valore.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unità* (casella di controllo) è impostato su "Abilitato"<br><br>Questo parametro viene ignorato se impostato su una delle seguenti [unità relative al tempo](/manual/config/items/item#configuration): unixtime, uptime, s.|
|*Colore*|1|units_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).|
|***Arco del valore***|<|<|<|
|*Dimensione arco*|0|value_arc_size|Valori possibili nell'intervallo 1-100.<br><br>Predefinito: 20.|
|***Ago***|<|<|<|
|*Colore*|1|needle_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: `""` (vuoto).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *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;<br>1 - *(predefinito)* Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *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.<br><br>Predefinito: 15.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *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.<br><br>Predefinito: 0.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *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](/manual/appendix/suffixes) (ad esempio "1d", "2w", "4K", "8G") sono supportati.|
|*Mostra etichette*|0|th_show_labels|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *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;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se le *Soglie* sono impostate|
|*Dimensione arco*|0|th_arc_size|Valori possibili nell'intervallo 1-100.<br><br>Predefinito: 5.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Show arc* è impostato su "Abilitato"|

[comment]: # ({/7886dec5-1db7caf7})

[comment]: # ({abd47a5b-f2849ab5})
### 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`](/manual/api/reference/dashboard/create).

[comment]: # ({/abd47a5b-f2849ab5})

[comment]: # ({17a49bae-f3687306})
#### 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.

[Richiesta](/manual/api#performing-requests):

```json
{
    "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:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/17a49bae-f3687306})

[comment]: # ({e9d30322-ced660a5})
### Vedi anche

- [Campo del widget della dashboard](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-ced660a5})