[comment]: # ({7a3d2bf9-70237fe9})
# 11 Honeycomb
[comment]: # ({/7a3d2bf9-70237fe9})
[comment]: # ({19fe6913-24cd2015})
### Opis
Te parametry oraz możliwe wartości właściwości dla odpowiednich obiektów pól widgetu umożliwiają konfigurację
widgetu [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) w metodach `dashboard.create` i `dashboard.update`.
::: noteimportant
Właściwości `fields` widgetu nie są walidowane podczas tworzenia ani aktualizacji dashboardu.
Pozwala to użytkownikom modyfikować [wbudowane widgety](/manual/web_interface/frontend_sections/dashboards/widgets) i tworzyć [własne widgety](/devel/modules/tutorials/widget), ale jednocześnie wprowadza ryzyko nieprawidłowego tworzenia lub aktualizowania widgetów.
Aby zapewnić pomyślne utworzenie lub aktualizację widgetu *Honeycomb*, zapoznaj się z zachowaniem parametrów opisanym w poniższych tabelach.
:::
[comment]: # ({/19fe6913-24cd2015})
[comment]: # ({082a0ee8-7a40ed57})
### Parametry
Następujące parametry są obsługiwane dla widżetu *Honeycomb*.
|Parametr|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Interwał odświeżania*|<|0|rf_rate|0 - Bez odświeżania;
10 - 10 sekund;
30 - 30 sekund;
60 - *(domyślnie)* 1 minuta;
120 - 2 minuty;
600 - 10 minut;
900 - 15 minut.|
|*Grupy hostów*|<|2|groupids.0|ID [grupy hostów](/manual/api/reference/hostgroup/get).
Uwaga: Aby skonfigurować wiele grup hostów, utwórz obiekt pola widżetu pulpitu dla każdej grupy hostów z numerem zwiększanym w nazwie właściwości.
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|<|*Grupy hostów (Widżet)*|1|groupids.\_reference|Zamiast ID [grupy hostów](/manual/api/reference/hostgroup/get):
`ABCDE._hostgroupids` - ustaw [zgodny widżet](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (z parametrem *Reference* ustawionym na "`ABCDE`") jako źródło danych dla grup hostów.
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|*Hosty*|<|3|hostids.0|ID [hosta](/manual/api/reference/host/get).
Uwaga: Aby skonfigurować wiele hostów, utwórz obiekt pola widżetu pulpitu dla każdego hosta z numerem zwiększanym w nazwie właściwości. W przypadku wielu hostów parametr *Grupy hostów* nie może być w ogóle skonfigurowany albo musi być skonfigurowany z co najmniej jedną grupą hostów, do której należą skonfigurowane hosty.
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|<|*Hosty (Widżet/Pulpit)*|1|hostids.\_reference|Zamiast ID [hosta](/manual/api/reference/host/get):
`DASHBOARD.hostids` - ustaw [selektor hostów](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) pulpitu jako źródło danych dla hostów;
`ABCDE._hostids` - ustaw [zgodny widżet](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (z parametrem *Reference* ustawionym na "`ABCDE`") jako źródło danych dla hostów.
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|*Tagi hostów*|<|<|<|<|
|<|*Typ oceny*|0|evaltype_host|0 - *(domyślnie)* And/Or;
2 - Or.
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|^|*Nazwa tagu*|1|host_tags.0.tag|Dowolna wartość tekstowa.
Uwaga: Numer w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane* przy konfigurowaniu *Tagów hostów*
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|^|*Operator*|0|host_tags.0.operator|0 - Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.
Uwaga: Numer w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane* przy konfigurowaniu *Tagów hostów*
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|^|*Wartość tagu*|1|host_tags.0.value|Dowolna wartość tekstowa.
Uwaga: Numer w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane* przy konfigurowaniu *Tagów hostów*
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
|*Wzorce pozycji*|<|1|items.0|Nazwa lub wzorzec [pozycji](/manual/api/reference/item/get).
Uwaga: Aby skonfigurować wiele wzorców pozycji, utwórz obiekt pola widżetu pulpitu dla każdego wzorca pozycji z numerem zwiększanym w nazwie właściwości.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane*|
|*Tagi pozycji*|<|<|<|<|
|<|*Typ oceny*|0|evaltype_item|0 - *(domyślnie)* And/Or;
2 - Or.|
|^|*Nazwa tagu*|1|item_tags.0.tag|Dowolna wartość tekstowa.
Uwaga: Numer w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane* przy konfigurowaniu *Tagów pozycji*|
|^|*Operator*|0|item_tags.0.operator|0 - Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.
Uwaga: Numer w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane* przy konfigurowaniu *Tagów pozycji*|
|^|*Wartość tagu*|1|item_tags.0.value|Dowolna wartość tekstowa.
Uwaga: Numer w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane* przy konfigurowaniu *Tagów pozycji*|
|*Pokaż hosty w konserwacji*|<|0|maintenance|0 - *(domyślnie)* Wyłączone;
1 - Włączone.|
|*Pokaż*|<|0|show.0|1 - Etykieta podstawowa;
2 - Etykieta dodatkowa.
Uwaga: Aby skonfigurować wiele wartości, utwórz obiekt pola widżetu pulpitu dla każdej wartości z numerem zwiększanym w nazwie właściwości.
Domyślnie: 1, 2.|
|*Reference*|<|1|reference|Dowolna wartość tekstowa składająca się z 5 znaków (na przykład `ABCDE` lub `JBPNL`). Ta wartość musi być unikalna w obrębie pulpitu, do którego należy widżet.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *wymagane*|
[comment]: # ({/082a0ee8-7a40ed57})
[comment]: # ({aaafe403-d25c8205})
#### Konfiguracja zaawansowana
Dla widżetu *Honeycomb* obsługiwane są następujące zaawansowane parametry konfiguracji.
::: noteclassic
Liczba w nazwie właściwości *Thresholds* (np. thresholds.0.color) odnosi się do miejsca progu na liście posortowanej rosnąco.
Jeśli jednak progi zostaną skonfigurowane w innej kolejności, wartości zostaną posortowane rosnąco po zaktualizowaniu konfiguracji widżetu w frontendzie Zabbix
(np. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`).
:::
|Parametr|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|***Etykieta główna***|<|<|<|
|*Typ*|0|primary_label_type|0 - *(domyślnie)* Tekst;
1 - Wartość.|
|*Tekst*|1|primary_label|Dowolna wartość tekstowa, w tym makra.
Obsługiwane makra: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, makra użytkownika.
Domyślnie: {HOST.NAME}
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Tekst"|
|*Miejsca dziesiętne*|0|primary_label_decimal_places|Możliwe wartości mieszczą się w zakresie 0-6.
Domyślnie: 2.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość"|
|*Rozmiar* (typ)|0|primary_label_size_type|0 - *(domyślnie)* Auto;
1 - Niestandardowy.|
|*Rozmiar*|0|primary_label_size|Możliwe wartości mieszczą się w zakresie 1-100.
Domyślnie: 20.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Rozmiar* (typ) jest ustawiony na "Niestandardowy"|
|*Pogrubienie*|0|primary_label_bold|0 - *(domyślnie)* Wyłączone;
1 - Włączone.|
|*Kolor*|1|primary_label_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: na podstawie `theme` obiektu [Settings object](/manual/api/reference/settings/object#settings) i [User object](/manual/api/reference/user/object#user):
`1F2C33` dla "blue-theme", "blue-classic-theme" lub "hc-light";
`EEEEEE` dla "dark-theme", "dark-classic-theme" lub "hc-dark".|
|*Jednostki* (pole wyboru)|0|primary_label_units_show|0 - Wyłączone;
1 - *(domyślnie)* Włączone.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość"|
|*Jednostki* (wartość)|1|primary_label_units|Dowolna wartość tekstowa.
`""` (puste)
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość" i *Jednostki* (pole wyboru) są ustawione na "Włączone"|
|*Pozycja*|0|primary_label_units_pos|0 - Przed wartością;
1 - *(domyślnie)* Po wartości.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość" i *Jednostki* (pole wyboru) są ustawione na "Włączone"
Ten parametr jest ignorowany, jeśli ustawiono jedną z następujących [jednostek związanych z czasem](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Etykieta dodatkowa***|<|<|<|
|*Typ*|0|secondary_label_type|0 - Tekst;
1 - *(domyślnie)* Wartość.|
|*Tekst*|1|secondary_label|Dowolna wartość tekstowa, w tym makra.
Obsługiwane makra: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, makra użytkownika.
Domyślnie: {{ITEM.LASTVALUE}.fmtnum(2)}
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Tekst"|
|*Miejsca dziesiętne*|0|secondary_label_decimal_places|Możliwe wartości mieszczą się w zakresie 0-6.
Domyślnie: 2.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość"|
|*Rozmiar* (typ)|0|secondary_label_size_type|0 - *(domyślnie)* Auto;
1 - Niestandardowy.|
|*Rozmiar*|0|secondary_label_size|Możliwe wartości mieszczą się w zakresie 1-100.
Domyślnie: 30.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Rozmiar* (typ) jest ustawiony na "Niestandardowy"|
|*Pogrubienie*|0|secondary_label_bold|0 - Wyłączone;
1 - *(domyślnie)* Włączone.|
|*Kolor*|1|secondary_label_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: na podstawie `theme` obiektu [Settings object](/manual/api/reference/settings/object#settings) i [User object](/manual/api/reference/user/object#user):
`1F2C33` dla "blue-theme", "blue-classic-theme" lub "hc-light";
`EEEEEE` dla "dark-theme", "dark-classic-theme" lub "hc-dark".|
|*Jednostki* (pole wyboru)|0|secondary_label_units_show|0 - Wyłączone;
1 - *(domyślnie)* Włączone.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość"|
|*Jednostki* (wartość)|1|secondary_label_units|Dowolna wartość tekstowa.
`""` (puste)
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość" i *Jednostki* (pole wyboru) są ustawione na "Włączone"|
|*Pozycja*|0|secondary_label_position|0 - Przed wartością;
1 - *(domyślnie)* Po wartości.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Typ* jest ustawiony na "Wartość" i *Jednostki* (pole wyboru) są ustawione na "Włączone"
Ten parametr jest ignorowany, jeśli ustawiono jedną z następujących [jednostek związanych z czasem](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Kolor tła***|<|<|<|
|*Kolor tła*|1|bg_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: na podstawie `theme` obiektu [Settings object](/manual/api/reference/settings/object#settings) i [User object](/manual/api/reference/user/object#user):
`D9E7ED` dla "blue-theme" i "blue-classic-theme";
`3D5059` dla "dark-theme" i "dark-classic-theme";
`AAD7E9` dla "hc-light";
`335463` dla "hc-dark".|
|***Progi***|<|<|<|
|*Interpolacja kolorów*|0|interpolation|0 - Wyłączona;
1 - *(domyślnie)* Włączona.|
|*Kolor*|1|thresholds.0.color|Szesnastkowy kod koloru (np. `FF0000`).|
|*Próg*|1|thresholds.0.threshold|Dowolna wartość liczbowa. Obsługiwane są [sufiksy](/manual/appendix/suffixes) (np. "1d", "2w", "4K", "8G").|
[comment]: # ({/aaafe403-d25c8205})
[comment]: # ({05e301d7-c6f49883})
### Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu *Honeycomb*.
Więcej informacji na temat konfiguracji pulpitu można znaleźć w [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/05e301d7-c6f49883})
[comment]: # ({18033898-0cace4a6})
#### Konfigurowanie widżetu *Honeycomb*
Skonfiguruj widżet *Honeycomb*, który wyświetla wykorzystanie procesów serwera Zabbix.
Dodatkowo zmień główną etykietę komórek honeycomb i dostrój wizualnie widżet za pomocą progów.
[Żądanie](/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
}
```
Odpowiedź:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/18033898-0cace4a6})
[comment]: # ({e9d30322-b52eec61})
### Zobacz także
- [Pole widżetu pulpitu](/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})