[comment]: # ({d8592bb6-70237fe9})
# 12 Honeycomb
[comment]: # ({/d8592bb6-70237fe9})
[comment]: # ({19fe6913-24cd2015})
### Опис
Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање
виџета [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) у методама `dashboard.create` и `dashboard.update`.
::: noteimportant
Својства `fields` виџета се не проверавају током прављења или ажурирања контролне табле.
Ово омогућава корисницима да модификују [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) и креирају [custom widgets](/devel/modules/tutorials/widget), али такође уводи ризик од неправилног креирања или ажурирања виџета.
Да бисте осигурали успешно креирање или ажурирање виџета *Honeycomb*, погледајте понашање параметара наведено у табелама испод.
:::
[comment]: # ({/19fe6913-24cd2015})
[comment]: # ({03089a26-7a40ed57})
### Параметери
Следећи параметри су подржани за виџет *Honeycomb*.
|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Refresh interval*|<|0|rf_rate|0 - Нема освежавања;
10 - 10 секунди;
30 - 30 секунди;
60 - *(подразумевано)* 1 минут;
120 - 2 минута;
600 - 10 минута;
900 - 15 минута.|
|*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.
Напомена: Да бисте конфигурисали више група домаћина, креирајте објекат поља виџета контролне табле за сваку групу домаћина са повећаним бројем у имену својства.
Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Host groups (Widget)*|1|groupids.\_reference|Уместо [Host group](/manual/api/reference/hostgroup/get) ID:
`ABCDE._hostgroupids` - поставите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са параметром *Референца* постављеним на "`ABCDE`") као извор података за групе домаћина.
Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.
Напомена: Да бисте конфигурисали више домаћина, креирајте објекат поља виџета контролне табле за сваког домаћина са повећаним бројем у имену својства. За више домаћина, параметар *Групе домаћина* уопште не мора бити конфигурисан или мора бити конфигурисан са најмање једном групом домаћина којој припадају конфигурисани домаћини.
Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Уместо [Host](/manual/api/reference/host/get) ID:
`DASHBOARD.hostids`- поставите [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) као извор података за домаћине;
`ABCDE._hostids` - поставите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са параметром *Референца* постављеним на "`ABCDE`") као извор података за домаћине.
Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Host tags*|<|<|<|<|
|<|*Evaluation type*|0|evaltype_host|0 - *(подразумевано)* И/Или;
2 - Или.
Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag name*|1|host_tags.0.tag|Било која вредност стринга.
Напомена: Број у имену својства упућује на редослед ознака у листи за процену ознака.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно* ако се конфигуришу *Ознаке домаћина*
Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Operator*|0|host_tags.0.operator|0 - Садржи;
1 - Једнако;
2 - Не садржи;
3 - Није једнако;
4 - Постоји ;
5 – Не постоји.
Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно* ако се конфигуришу *ознаке домаћина*
Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag value*|1|host_tags.0.value|Било која вредност стринга.
Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно* ако се конфигуришу *ознаке домаћина*
Овај параметар није подржан ако се виџет конфигурише на [template dashboard] (/manual/api/reference/templatedashboard/object).|
|*Item patterns*|<|1|items.0|[Item](/manual/api/reference/item/get) име или образац.
Напомена: Да бисте конфигурисали више образаца ставки, направите контролну таблу објекат поља виџета за сваки образац ставке са повећаним бројем у називу својства.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно*|
|*Item tags*|<|<|<|<|
|<|*Evaluation type*|0|evaltype_item|0 - *(подразумевано)* И/Или;
2 - Или.|
|^|*Tag name*|1|item_tags.0.tag|Било која вредност стринга.
Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно* ако се конфигуришу *ознаке ставки*|
|^|*Operator*|0|tem_tags.0.operator|0 – Садржи;
1 – Једнако;
2 – Не садржи;
3 – Није једнако;
4 – Постоји ;
5 – Не постоји.
Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно* ако конфигуришете *ознаке ставки*|
|^|*Tag value*|1|item_tags.0.value|Било која вредност стринга.
Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно* ако се конфигуришу *ознаке ставки*|
|*Show hosts in maintenance*|<|0|одржавање|0 - *(подразумевано)* Онемогућено;
1 - Омогућено.|
|*Show*|<|0|show.0|1 – Примарна ознака;
2 – Секундарна ознака.
Напомена: Да бисте конфигурисали више вредности, креирајте објекат поља виџета контролне табле за сваку вредност са увећаним бројем у називу својства.
Подразумевано: 1, 2.|
|*Reference*|<|1| reference |Било која вредност стринга која се састоји од 5 карактера (нпр., `ABCDE` или `JBPNL`). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно*|
[comment]: # ({/03089a26-7a40ed57})
[comment]: # ({57afca55-d25c8205})
#### Напредна конфигурација
Следећи напредни конфигурациони параметри су подржани за виџет *Honeycomb*.
::: noteclassic
Број у називу својства *Thresholds* (нпр. thresholds.0.color) упућује на место прага на листи, сортирано по растућем редоследу.
Међутим, ако су прагови конфигурисани другим редоследом, вредности ће бити сортиране у растућем редоследу након ажурирања конфигурације виџета у Zabbix корисничком интерфејсу
(нпр. `"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|
|-----|-|-----|-------------------|
|***Primary label***|<|<|<|
|*Type*|0|primary_label_type|0 - *(подразумевано)* Текст;
1 - Вредност.|
|*Text*|1|primary_label|Било која вредност стринга, укључујући макрое.
Подржани макрои: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, кориснички макрои.
< br>Подразумевано: {HOST.NAME}
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Тип* подешен на "Текст"|
|*Decimal places*|0|primary_label_decimal_places|Могуће вредности се крећу од 0-6.
Подразумевано: 2.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior) :
- *подржано* ако је *Тип* постављен на "Вредност"|
|*Size* (type)|0|primary_label_size_type|0 - *(подразумевано)* Ауто;
1 - Прилагођено.|
|*Size*|0|primary_label_size|Могуће вредности се крећу од 1-100.
Подразумевано: 20.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Величина* (тип) постављена на "Прилагођено"|
|*Bold*|0|primary_label_bold|0 - *(подразумевано)* Онемогућено;
1 - Омогућено.|
|*Color*|1|primary_label_color|Хексадецимални код боје (нпр. `FF0000`).
Подразумевано: засновано на `theme` [Settings object](/manual/api/reference/settings/object#settings ) и [User object](/manual/api/reference/user/object#user):
`1F2C33` за "плава-тема" или "hc-light";
`EEEEEE` за "тамна-тема" или "hc-dark".|
|*Units* (checkbox)|0|primary_label_units_show|0 – Онемогућено;
1 – *(подразумевано)* Омогућено.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior) :
- *подржано* ако је *Тип* постављен на "Вредност"|
|*Units* (value)|1|primary_label_units|Било која вредност стринга.
`""` (празно)
[Понашање параметра](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Тип* постављен на "Вредност" и *Јединице* (checkbox) је постављено на "Омогућено"|
|*Position*|0|primary_label_units_pos|0 - Пре вредности;
1 - *(подразумевано)* После вредности.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Тип* постављен на "Вредност" и *Јединице* (checkbox) је постављено на "Омогућено"
Овај параметар се игнорише ако је подешен на једно од следећих [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Secondary label***|<|<|<|
|*Type*|0|secondary_label_type|0 - Текст;
1 - *(подразумевано)* Вредност.|
|*Text*|1|secondary_label|Било која вредност стринга, укључујући макрое.
Подржани макрои: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, кориснички макрои.
< br>Подразумевано: {{ITEM.LASTVALUE}.fmtnum(2)}
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако *Тип* је постављен на "Текст"|
|*Decimal places*|0|secondary_label_decimal_places|Могуће вредности се крећу од 0-6.
Подразумевано: 2.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior) :
- *подржано* ако је *Тип* постављен на "Вредност"|
|*Size* (type)|0|secondary_label_size_type|0 - *(подразумевано)* Ауто;
1 - Прилагођен.|
|*Size*|0|secondary_label_size|Могуће вредности се крећу од 1-100.
Подразумевано: 30.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Величина* (тип) постављена на "Прилагођено"|
|*Подебљано*|0|secondary_label_bold|0 - Онемогућено;
1 - *(подразумевано)* Омогућено.|
|*Bold*|1|secondary_label_color|Хексадецимални код боје (нпр. `FF0000`).
Подразумевано: засновано на `theme` од [Settings object](/manual/api/reference/settings/object#settings) и [User object](/manual/api/reference/user/object#user):
`1F2C33` за "плаву-тему" или "hc-light";
`EEEEEE` за "тамну-тему" или "hc-dark".|
|*Units* (checkbox)|0|secondary_label_units_show|0 – Онемогућено;
1 – *(подразумевано)* Омогућено.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior) :
- *подржано* ако је *Тип* постављен на "Вредност"|
|*Units* (value)|1|secondary_label_units|Било која вредност стринга.
`""` (празно)
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Тип* постављен на "Вредност" и *Јединице* (checkbox) је постављено на "Омогућено"|
|*Position*|0|secondary_label_position|0 - Пре вредности;
1 - *(подразумевано)* После вредности.
[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *подржано* ако је *Тип* постављен на "Вредност" и *Јединице* (checkbox) је постављено на "Омогућено"
Овај параметар се игнорише ако је подешен на једно од следећих [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Background color***|<|<|<|
|*Background color*|1|bg_color|Хексадецимални код боје (нпр. `FF0000`).
Подразумевано: засновано на `theme` од [Settings object](/manual/api/reference/settings/object#settings) и [User object](/manual/api/reference/user/object#user):
`D9E7ED` за "плава-тема";
`3D5059` за "тамна-тема";
`AAD7E9` за "hc-light";
`335463` за "hc-dark".|
|***Thresholds***|<|<|<|
|*Color interpolation*|0|interpolation|0 - Онемогућено;
1 - *(подразумевано)* Омогућено.|
|*Color*|1|thresholds.0.color|Хексадецимални код боје (нпр. `FF0000`).|
|*Threshold*|1|thresholds.0.threshold|Било која нумеричка вредност. [Suffixes](/manual/appendix/suffixes) (нпр. "1d", "2w", "4K", "8G") су подржани.|
[comment]: # ({/57afca55-d25c8205})
[comment]: # ({05e301d7-c6f49883})
### Примери
Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет *Honeycomb*.
За више информација о конфигурисању контролне табле погледајте [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/05e301d7-c6f49883})
[comment]: # ({18033898-0cace4a6})
#### Конфигурисање виџета *Honeycomb*
Конфигурисање виџета *Honeycomb* који приказује коришћење процеса Zabbix сервера.
Поред тога, промените примарну ознаку honeycomb ћелија и визуелно лепо подесите виџет са праговима .
[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
}
```
Одговор:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/18033898-0cace4a6})
[comment]: # ({e9d30322-b52eec61})
### Погледајте такође
- [Dashboard widget field](/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})