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

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

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

Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) in den Methoden `dashboard.create` und `dashboard.update`.

::: noteimportant
Die Eigenschaften von Widget-`fields` werden beim Erstellen oder Aktualisieren eines Dashboards nicht validiert.
Dadurch können Benutzer [integrierte Widgets](/manual/web_interface/frontend_sections/dashboards/widgets) ändern und [benutzerdefinierte Widgets](/devel/modules/tutorials/widget) erstellen, es besteht jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets *Honeycomb* sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
:::

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

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

Die folgenden Parameter werden für das *Honeycomb*-Widget unterstützt.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Aktualisierungsintervall*|<|0|rf_rate|0 - Keine Aktualisierung;<br>10 - 10 Sekunden;<br>30 - 30 Sekunden;<br>60 - *(Standard)* 1 Minute;<br>120 - 2 Minuten;<br>600 - 10 Minuten;<br>900 - 15 Minuten.|
|*Host-Gruppen*|<|2|groupids.0|ID der [Host-Gruppe](/manual/api/reference/hostgroup/get).<br><br>Hinweis: Um mehrere Host-Gruppen zu konfigurieren, erstellen Sie für jede Host-Gruppe ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|<|*Host-Gruppen (Widget)*|1|groupids.\_reference|Anstelle der ID der [Host-Gruppe](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - ein [kompatibles Widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (mit dem Parameter *Referenz* auf "`ABCDE`" gesetzt) als Datenquelle für Host-Gruppen festlegen.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|*Hosts*|<|3|hostids.0|ID des [Hosts](/manual/api/reference/host/get).<br><br>Hinweis: Um mehrere Hosts zu konfigurieren, erstellen Sie für jeden Host ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen. Bei mehreren Hosts darf der Parameter *Host-Gruppen* entweder gar nicht konfiguriert sein oder muss mit mindestens einer Host-Gruppe konfiguriert sein, zu der die konfigurierten Hosts gehören.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Anstelle der ID des [Hosts](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - die [Host-Auswahl](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) des Dashboards als Datenquelle für Hosts festlegen;<br>`ABCDE._hostids` - ein [kompatibles Widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (mit dem Parameter *Referenz* auf "`ABCDE`" gesetzt) als Datenquelle für Hosts festlegen.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|*Host-Tags*|<|<|<|<|
|<|*Auswertungstyp*|0|evaltype_host|0 - *(Standard)* Und/Oder;<br>2 - Oder.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|^|*Tag-Name*|1|host_tags.0.tag|Beliebiger Zeichenfolgenwert.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei Konfiguration von *Host-Tags*<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|^|*Operator*|0|host_tags.0.operator|0 - Enthält;<br>1 - Entspricht;<br>2 - Enthält nicht;<br>3 - Entspricht nicht;<br>4 - Existiert;<br>5 - Existiert nicht.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei Konfiguration von *Host-Tags*<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|^|*Tag-Wert*|1|host_tags.0.value|Beliebiger Zeichenfolgenwert.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei Konfiguration von *Host-Tags*<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|*Datenpunkt-Muster*|<|1|items.0|Name oder Muster des [Datenpunkts](/manual/api/reference/item/get).<br><br>Hinweis: Um mehrere Datenpunkt-Muster zu konfigurieren, erstellen Sie für jedes Datenpunkt-Muster ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|*Datenpunkt-Tags*|<|<|<|<|
|<|*Auswertungstyp*|0|evaltype_item|0 - *(Standard)* Und/Oder;<br>2 - Oder.|
|^|*Tag-Name*|1|item_tags.0.tag|Beliebiger Zeichenfolgenwert.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei Konfiguration von *Datenpunkt-Tags*|
|^|*Operator*|0|item_tags.0.operator|0 - Enthält;<br>1 - Entspricht;<br>2 - Enthält nicht;<br>3 - Entspricht nicht;<br>4 - Existiert;<br>5 - Existiert nicht.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei Konfiguration von *Datenpunkt-Tags*|
|^|*Tag-Wert*|1|item_tags.0.value|Beliebiger Zeichenfolgenwert.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei Konfiguration von *Datenpunkt-Tags*|
|*Hosts in Wartung anzeigen*|<|0|maintenance|0 - *(Standard)* Deaktiviert;<br>1 - Aktiviert.|
|*Anzeigen*|<|0|show.0|1 - Primäre Beschriftung;<br>2 - Sekundäre Beschriftung.<br><br>Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.<br><br>Standard: 1, 2.|
|*Referenz*|<|1|reference|Beliebiger Zeichenfolgenwert mit 5 Zeichen (z. B. `ABCDE` oder `JBPNL`). Dieser Wert muss innerhalb des Dashboards, zu dem das Widget gehört, eindeutig sein.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|

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

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

Die folgenden erweiterten Konfigurationsparameter werden für das Widget *Honeycomb* unterstützt.

::: noteclassic
Die Zahl im Eigenschaftsnamen *Thresholds* (z. B. thresholds.0.color) verweist auf die Position des Schwellenwerts in einer Liste, die in aufsteigender Reihenfolge sortiert ist.
Wenn Schwellenwerte jedoch in einer anderen Reihenfolge konfiguriert werden, werden die Werte nach dem Aktualisieren der Widget-Konfiguration im Zabbix Frontend in aufsteigender Reihenfolge sortiert
(z. B. `"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|
|-----|-|-----|-------------------|
|***Primäre Beschriftung***|<|<|<|
|*Typ*|0|primary_label_type|0 - *(Standard)* Text;<br>1 - Wert.|
|*Text*|1|primary_label|Beliebiger Zeichenfolgenwert, einschließlich Makros.<br>Unterstützte Makros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, Benutzermakros.<br><br>Standard: {HOST.NAME}<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Text" gesetzt ist|
|*Dezimalstellen*|0|primary_label_decimal_places|Mögliche Werte liegen im Bereich 0–6.<br><br>Standard: 2.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist|
|*Größe* (Typ)|0|primary_label_size_type|0 - *(Standard)* Automatisch;<br>1 - Benutzerdefiniert.|
|*Größe*|0|primary_label_size|Mögliche Werte liegen im Bereich 1–100.<br><br>Standard: 20.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Größe* (Typ) auf "Benutzerdefiniert" gesetzt ist|
|*Fett*|0|primary_label_bold|0 - *(Standard)* Deaktiviert;<br>1 - Aktiviert.|
|*Farbe*|1|primary_label_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: basierend auf `theme` von [Settings object](/manual/api/reference/settings/object#settings) und [User object](/manual/api/reference/user/object#user):<br>`1F2C33` für "blue-theme", "blue-classic-theme" oder "hc-light";<br>`EEEEEE` für "dark-theme", "dark-classic-theme" oder "hc-dark".|
|*Einheiten* (Kontrollkästchen)|0|primary_label_units_show|0 - Deaktiviert;<br>1 - *(Standard)* Aktiviert.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist|
|*Einheiten* (Wert)|1|primary_label_units|Beliebiger Zeichenfolgenwert.<br><br>`""` (leer)<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist und *Einheiten* (Kontrollkästchen) auf "Aktiviert" gesetzt ist|
|*Position*|0|primary_label_units_pos|0 - Vor dem Wert;<br>1 - *(Standard)* Nach dem Wert.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist und *Einheiten* (Kontrollkästchen) auf "Aktiviert" gesetzt ist<br><br>Dieser Parameter wird ignoriert, wenn er auf eine der folgenden [zeitbezogenen Einheiten](/manual/config/items/item#configuration) gesetzt ist: unixtime, uptime, s.|
|***Sekundäre Beschriftung***|<|<|<|
|*Typ*|0|secondary_label_type|0 - Text;<br>1 - *(Standard)* Wert.|
|*Text*|1|secondary_label|Beliebiger Zeichenfolgenwert, einschließlich Makros.<br>Unterstützte Makros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, Benutzermakros.<br><br>Standard: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Text" gesetzt ist|
|*Dezimalstellen*|0|secondary_label_decimal_places|Mögliche Werte liegen im Bereich 0–6.<br><br>Standard: 2.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist|
|*Größe* (Typ)|0|secondary_label_size_type|0 - *(Standard)* Automatisch;<br>1 - Benutzerdefiniert.|
|*Größe*|0|secondary_label_size|Mögliche Werte liegen im Bereich 1–100.<br><br>Standard: 30.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Größe* (Typ) auf "Benutzerdefiniert" gesetzt ist|
|*Fett*|0|secondary_label_bold|0 - Deaktiviert;<br>1 - *(Standard)* Aktiviert.|
|*Farbe*|1|secondary_label_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: basierend auf `theme` von [Settings object](/manual/api/reference/settings/object#settings) und [User object](/manual/api/reference/user/object#user):<br>`1F2C33` für "blue-theme", "blue-classic-theme" oder "hc-light";<br>`EEEEEE` für "dark-theme", "dark-classic-theme" oder "hc-dark".|
|*Einheiten* (Kontrollkästchen)|0|secondary_label_units_show|0 - Deaktiviert;<br>1 - *(Standard)* Aktiviert.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist|
|*Einheiten* (Wert)|1|secondary_label_units|Beliebiger Zeichenfolgenwert.<br><br>`""` (leer)<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist und *Einheiten* (Kontrollkästchen) auf "Aktiviert" gesetzt ist|
|*Position*|0|secondary_label_position|0 - Vor dem Wert;<br>1 - *(Standard)* Nach dem Wert.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Typ* auf "Wert" gesetzt ist und *Einheiten* (Kontrollkästchen) auf "Aktiviert" gesetzt ist<br><br>Dieser Parameter wird ignoriert, wenn er auf eine der folgenden [zeitbezogenen Einheiten](/manual/config/items/item#configuration) gesetzt ist: unixtime, uptime, s.|
|***Hintergrundfarbe***|<|<|<|
|*Hintergrundfarbe*|1|bg_color|Hexadezimaler Farbcode (z. B. `FF0000`).<br><br>Standard: basierend auf `theme` von [Settings object](/manual/api/reference/settings/object#settings) und [User object](/manual/api/reference/user/object#user):<br>`D9E7ED` für "blue-theme" und "blue-classic-theme";<br>`3D5059` für "dark-theme" und "dark-classic-theme";<br>`AAD7E9` für "hc-light";<br>`335463` für "hc-dark".|
|***Schwellenwerte***|<|<|<|
|*Farbinterpolation*|0|interpolation|0 - Deaktiviert;<br>1 - *(Standard)* Aktiviert.|
|*Farbe*|1|thresholds.0.color|Hexadezimaler Farbcode (z. B. `FF0000`).|
|*Schwellenwert*|1|thresholds.0.threshold|Beliebiger numerischer Wert. [Suffixe](/manual/appendix/suffixes) (z. B. "1d", "2w", "4K", "8G") werden unterstützt.|

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

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

Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das *Honeycomb* -Widget.
Für weitere Informationen zur Konfiguration eines Dashboards siehe [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({18033898-0cace4a6})
#### Konfigurieren eines *Honeycomb*-Widgets

Konfigurieren Sie ein *Honeycomb*-Widget, das die Auslastung von Zabbix-Serverprozessen anzeigt.
Ändern Sie außerdem die primäre Beschriftung der Honeycomb-Zellen und passen Sie das Widget visuell mit Schwellenwerten an.

[Anfrage](/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
}
```

Antwort:

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

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

[comment]: # ({e9d30322-b52eec61})
### Siehe auch

-   [Dashboard Widget Feld](/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})