[comment]: # ({7a3d2bf9-70237fe9})
# 11 Nido d'ape

[comment]: # ({/7a3d2bf9-70237fe9})

[comment]: # ({19fe6913-24cd2015})
### Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget [*Nido d'ape*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) 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 *Nido d'ape*, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
:::

[comment]: # ({/19fe6913-24cd2015})

[comment]: # ({082a0ee8-7a40ed57})
### Parametri

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

|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.|
|*Gruppi host*|<|2|groupids.0|ID del [gruppo host](/manual/api/reference/hostgroup/get).<br><br>Nota: Per configurare più gruppi host, creare un oggetto campo widget dashboard per ciascun gruppo host con un numero incrementale nel nome della proprietà.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|<|*Gruppi host (Widget)*|1|groupids.\_reference|Invece dell'ID del [gruppo host](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") come origine dati per i gruppi host.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Host*|<|3|hostids.0|ID dell'[host](/manual/api/reference/host/get).<br><br>Nota: Per configurare più host, creare un oggetto campo widget dashboard per ciascun host con un numero incrementale nel nome della proprietà. Per più host, il parametro *Gruppi host* non deve essere configurato oppure deve essere configurato con almeno un gruppo host a cui appartengono gli host configurati.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|<|*Host (Widget/Dashboard)*|1|hostids.\_reference|Invece dell'ID dell'[host](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - imposta il [selettore host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) della dashboard come origine dati per gli host;<br>`ABCDE._hostids` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") 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).|
|*Tag host*|<|<|<|<|
|<|*Tipo di valutazione*|0|evaltype_host|0 - *(predefinito)* And/Or;<br>2 - Or.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Nome tag*|1|host_tags.0.tag|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configura *Tag host*<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Operatore*|0|host_tags.0.operator|0 - Contiene;<br>1 - Uguale a;<br>2 - Non contiene;<br>3 - Diverso da;<br>4 - Esiste;<br>5 - Non esiste.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configura *Tag host*<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Valore tag*|1|host_tags.0.value|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configura *Tag host*<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Pattern item*|<|1|items.0|Nome o pattern dell'[item](/manual/api/reference/item/get).<br><br>Nota: Per configurare più pattern item, creare un oggetto campo widget dashboard per ciascun pattern item con un numero incrementale nel nome della proprietà.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio*|
|*Tag item*|<|<|<|<|
|<|*Tipo di valutazione*|0|evaltype_item|0 - *(predefinito)* And/Or;<br>2 - Or.|
|^|*Nome tag*|1|item_tags.0.tag|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configura *Tag item*|
|^|*Operatore*|0|item_tags.0.operator|0 - Contiene;<br>1 - Uguale a;<br>2 - Non contiene;<br>3 - Diverso da;<br>4 - Esiste;<br>5 - Non esiste.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configura *Tag item*|
|^|*Valore tag*|1|item_tags.0.value|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configura *Tag item*|
|*Mostra host in manutenzione*|<|0|maintenance|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Mostra*|<|0|show.0|1 - Etichetta primaria;<br>2 - Etichetta secondaria.<br><br>Nota: Per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementale nel nome della proprietà.<br><br>Predefinito: 1, 2.|
|*Reference*|<|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.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio*|

[comment]: # ({/082a0ee8-7a40ed57})

[comment]: # ({aaafe403-d25c8205})
#### Configurazione avanzata

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

::: 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"`).
:::

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|***Etichetta primaria***|<|<|<|
|*Tipo*|0|primary_label_type|0 - *(predefinito)* Testo;<br>1 - Valore.|
|*Testo*|1|primary_label|Qualsiasi valore stringa, incluse le macro.<br>Macro supportate: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macro utente.<br><br>Predefinito: {HOST.NAME}<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Testo"|
|*Posizioni decimali*|0|primary_label_decimal_places|I valori possibili vanno da 0 a 6.<br><br>Predefinito: 2.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore"|
|*Dimensione* (tipo)|0|primary_label_size_type|0 - *(predefinito)* Auto;<br>1 - Personalizzata.|
|*Dimensione*|0|primary_label_size|I valori possibili vanno da 1 a 100.<br><br>Predefinito: 20.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Dimensione* (tipo) è impostato su "Personalizzata"|
|*Grassetto*|0|primary_label_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Colore*|1|primary_label_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: in base a `theme` di [Settings object](/manual/api/reference/settings/object#settings) e [User object](/manual/api/reference/user/object#user):<br>`1F2C33` per "blue-theme", "blue-classic-theme" o "hc-light";<br>`EEEEEE` per "dark-theme", "dark-classic-theme" o "hc-dark".|
|*Unità* (casella di controllo)|0|primary_label_units_show|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore"|
|*Unità* (valore)|1|primary_label_units|Qualsiasi valore stringa.<br><br>`""` (vuoto)<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore" e *Unità* (casella di controllo) è impostato su "Abilitato"|
|*Posizione*|0|primary_label_units_pos|0 - Prima del valore;<br>1 - *(predefinito)* Dopo il valore.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore" e *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.|
|***Etichetta secondaria***|<|<|<|
|*Tipo*|0|secondary_label_type|0 - Testo;<br>1 - *(predefinito)* Valore.|
|*Testo*|1|secondary_label|Qualsiasi valore stringa, incluse le macro.<br>Macro supportate: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macro utente.<br><br>Predefinito: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Testo"|
|*Posizioni decimali*|0|secondary_label_decimal_places|I valori possibili vanno da 0 a 6.<br><br>Predefinito: 2.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore"|
|*Dimensione* (tipo)|0|secondary_label_size_type|0 - *(predefinito)* Auto;<br>1 - Personalizzata.|
|*Dimensione*|0|secondary_label_size|I valori possibili vanno da 1 a 100.<br><br>Predefinito: 30.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Dimensione* (tipo) è impostato su "Personalizzata"|
|*Grassetto*|0|secondary_label_bold|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.|
|*Colore*|1|secondary_label_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: in base a `theme` di [Settings object](/manual/api/reference/settings/object#settings) e [User object](/manual/api/reference/user/object#user):<br>`1F2C33` per "blue-theme", "blue-classic-theme" o "hc-light";<br>`EEEEEE` per "dark-theme", "dark-classic-theme" o "hc-dark".|
|*Unità* (casella di controllo)|0|secondary_label_units_show|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore"|
|*Unità* (valore)|1|secondary_label_units|Qualsiasi valore stringa.<br><br>`""` (vuoto)<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore" e *Unità* (casella di controllo) è impostato su "Abilitato"|
|*Posizione*|0|secondary_label_position|0 - Prima del valore;<br>1 - *(predefinito)* Dopo il valore.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo* è impostato su "Valore" e *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 di sfondo***|<|<|<|
|*Colore di sfondo*|1|bg_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>Predefinito: in base a `theme` di [Settings object](/manual/api/reference/settings/object#settings) e [User object](/manual/api/reference/user/object#user):<br>`D9E7ED` per "blue-theme" e "blue-classic-theme";<br>`3D5059` per "dark-theme" e "dark-classic-theme";<br>`AAD7E9` per "hc-light";<br>`335463` per "hc-dark".|
|***Soglie***|<|<|<|
|*Interpolazione del colore*|0|interpolation|0 - Disabilitata;<br>1 - *(predefinito)* Abilitata.|
|*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.|

[comment]: # ({/aaafe403-d25c8205})

[comment]: # ({05e301d7-c6f49883})
### Esempi

Gli esempi seguenti hanno lo scopo esclusivo di descrivere la configurazione degli oggetti campo del widget della dashboard per il widget *Honeycomb*.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/05e301d7-c6f49883})

[comment]: # ({18033898-0cace4a6})
#### Configurazione di un widget *Honeycomb*

Configurare un widget *Honeycomb* che visualizza l'utilizzo dei processi del server Zabbix.
Inoltre, modificare l'etichetta primaria delle celle honeycomb e ottimizzare visivamente il widget con le soglie.

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

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": "30",
        "auto_start": "1",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "honeycomb",
                        "name": "Honeycomb",
                        "x": "0",
                        "y": "0",
                        "width": "24",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "items.0",
                                "value": "Zabbix server: Utilization*"
                            },
                            {
                                "type": 1,
                                "name": "primary_label",
                                "value": "{ITEM.NAME}"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.color",
                                "value": "0EC9AC"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.threshold",
                                "value": "0"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.color",
                                "value": "FFD54F"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.threshold",
                                "value": "70"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.color",
                                "value": "FF465C"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.threshold",
                                "value": "90"
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "KSTMQ"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Risposta:

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

[comment]: # ({/18033898-0cace4a6})

[comment]: # ({e9d30322-b52eec61})
### 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-b52eec61})