Documentation
Table of Contents
12 Honeycomb
Опис
Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање виџета Honeycomb у методама dashboard.create и dashboard.update.
Својства fields виџета се не проверавају током прављења или ажурирања контролне табле. Ово омогућава корисницима да модификују built-in widgets и креирају custom widgets, али такође уводи ризик од неправилног креирања или ажурирања виџета. Да бисте осигурали успешно креирање или ажурирање виџета Honeycomb, погледајте понашање параметара наведено у табелама испод.
Параметери
Следећи параметри су подржани за виџет Honeycomb.
| Parameter | type | 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 ID. Напомена: Да бисте конфигурисали више група домаћина, креирајте објекат поља виџета контролне табле за сваку групу домаћина са повећаним бројем у имену својства. Овај параметар није подржан ако се конфигурише виџет на template dashboard. |
|
| Host groups (Widget) | 1 | groupids._reference | Уместо Host group ID:ABCDE._hostgroupids - поставите compatible widget (са параметром Референца постављеним на "ABCDE") као извор података за групе домаћина.Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
| Hosts | 3 | hostids.0 | Host ID. Напомена: Да бисте конфигурисали више домаћина, креирајте објекат поља виџета контролне табле за сваког домаћина са повећаним бројем у имену својства. За више домаћина, параметар Групе домаћина уопште не мора бити конфигурисан или мора бити конфигурисан са најмање једном групом домаћина којој припадају конфигурисани домаћини. Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | Уместо Host ID:DASHBOARD.hostids- поставите Host selector као извор података за домаћине;ABCDE._hostids - поставите compatible widget (са параметром Референца постављеним на "ABCDE") као извор података за домаћине.Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
| Host tags | ||||
| Evaluation type | 0 | evaltype_host | 0 - (подразумевано) И/Или; 2 - Или. Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
| Tag name | 1 | host_tags.0.tag | Било која вредност стринга. Напомена: Број у имену својства упућује на редослед ознака у листи за процену ознака. Parameter behavior: - обавезно ако се конфигуришу Ознаке домаћина Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
| Operator | 0 | host_tags.0.operator | 0 - Садржи; 1 - Једнако; 2 - Не садржи; 3 - Није једнако; 4 - Постоји ; 5 – Не постоји. Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака. Parameter behavior: - обавезно ако се конфигуришу ознаке домаћина Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
| Tag value | 1 | host_tags.0.value | Било која вредност стринга. Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака. Parameter behavior: - обавезно ако се конфигуришу ознаке домаћина Овај параметар није подржан ако се виџет конфигурише на [template dashboard] (/manual/api/reference/templatedashboard/object). |
|
| Item patterns | 1 | items.0 | Item име или образац. Напомена: Да бисте конфигурисали више образаца ставки, направите контролну таблу објекат поља виџета за сваки образац ставке са повећаним бројем у називу својства. Parameter behavior: - обавезно |
|
| Item tags | ||||
| Evaluation type | 0 | evaltype_item | 0 - (подразумевано) И/Или; 2 - Или. |
|
| Tag name | 1 | item_tags.0.tag | Било која вредност стринга. Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака. Parameter behavior: - обавезно ако се конфигуришу ознаке ставки |
|
| Operator | 0 | tem_tags.0.operator | 0 – Садржи; 1 – Једнако; 2 – Не садржи; 3 – Није једнако; 4 – Постоји ; 5 – Не постоји. Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака. Parameter behavior: - обавезно ако конфигуришете ознаке ставки |
|
| Tag value | 1 | item_tags.0.value | Било која вредност стринга. Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака. 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: - обавезно |
|
Напредна конфигурација
Следећи напредни конфигурациони параметри су подржани за виџет Honeycomb.
Број у називу својства Thresholds (нпр. thresholds.0.color) упућује на место прага на листи, сортирано по растућем редоследу. Међутим, ако су прагови конфигурисани другим редоследом, вредности ће бити сортиране у растућем редоследу након ажурирања конфигурације виџета у Zabbix корисничком интерфејсу (нпр. "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parameter | type | name | value |
|---|---|---|---|
| Primary label | |||
| Type | 0 | primary_label_type | 0 - (подразумевано) Текст; 1 - Вредност. |
| Text | 1 | primary_label | Било која вредност стринга, укључујући макрое. Подржани макрои: {HOST.*}, {ITEM.*}, {INVENTORY.*}, кориснички макрои. < br>Подразумевано: {HOST.NAME} Parameter behavior: - подржано ако је Тип подешен на "Текст" |
| Decimal places | 0 | primary_label_decimal_places | Могуће вредности се крећу од 0-6. Подразумевано: 2. Parameter behavior : - подржано ако је Тип постављен на "Вредност" |
| Size (type) | 0 | primary_label_size_type | 0 - (подразумевано) Ауто; 1 - Прилагођено. |
| Size | 0 | primary_label_size | Могуће вредности се крећу од 1-100. Подразумевано: 20. Parameter behavior: - подржано ако је Величина (тип) постављена на "Прилагођено" |
| Bold | 0 | primary_label_bold | 0 - (подразумевано) Онемогућено; 1 - Омогућено. |
| Color | 1 | primary_label_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: засновано на theme Settings object и User object:1F2C33 за "плава-тема" или "hc-light";EEEEEE за "тамна-тема" или "hc-dark". |
| Units (checkbox) | 0 | primary_label_units_show | 0 – Онемогућено; 1 – (подразумевано) Омогућено. Parameter behavior : - подржано ако је Тип постављен на "Вредност" |
| Units (value) | 1 | primary_label_units | Било која вредност стринга."" (празно)Понашање параметра: - подржано ако је Тип постављен на "Вредност" и Јединице (checkbox) је постављено на "Омогућено" |
| Position | 0 | primary_label_units_pos | 0 - Пре вредности; 1 - (подразумевано) После вредности. Parameter behavior: - подржано ако је Тип постављен на "Вредност" и Јединице (checkbox) је постављено на "Омогућено" Овај параметар се игнорише ако је подешен на једно од следећих time-related units: 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: - подржано ако Тип је постављен на "Текст" |
| Decimal places | 0 | secondary_label_decimal_places | Могуће вредности се крећу од 0-6. Подразумевано: 2. Parameter behavior : - подржано ако је Тип постављен на "Вредност" |
| Size (type) | 0 | secondary_label_size_type | 0 - (подразумевано) Ауто; 1 - Прилагођен. |
| Size | 0 | secondary_label_size | Могуће вредности се крећу од 1-100. Подразумевано: 30. Parameter behavior: - подржано ако је Величина (тип) постављена на "Прилагођено" |
| Подебљано | 0 | secondary_label_bold | 0 - Онемогућено; 1 - (подразумевано) Омогућено. |
| Bold | 1 | secondary_label_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: засновано на theme од Settings object и User object:1F2C33 за "плаву-тему" или "hc-light";EEEEEE за "тамну-тему" или "hc-dark". |
| Units (checkbox) | 0 | secondary_label_units_show | 0 – Онемогућено; 1 – (подразумевано) Омогућено. Parameter behavior : - подржано ако је Тип постављен на "Вредност" |
| Units (value) | 1 | secondary_label_units | Било која вредност стринга."" (празно)Parameter behavior: - подржано ако је Тип постављен на "Вредност" и Јединице (checkbox) је постављено на "Омогућено" |
| Position | 0 | secondary_label_position | 0 - Пре вредности; 1 - (подразумевано) После вредности. Parameter behavior: - подржано ако је Тип постављен на "Вредност" и Јединице (checkbox) је постављено на "Омогућено" Овај параметар се игнорише ако је подешен на једно од следећих time-related units: unixtime, uptime, s. |
| Background color | |||
| Background color | 1 | bg_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: засновано на theme од Settings object и User object: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 (нпр. "1d", "2w", "4K", "8G") су подржани. |
Примери
Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет Honeycomb. За више информација о конфигурисању контролне табле погледајте dashboard.create.
Конфигурисање виџета Honeycomb
Конфигурисање виџета Honeycomb који приказује коришћење процеса Zabbix сервера. Поред тога, промените примарну ознаку honeycomb ћелија и визуелно лепо подесите виџет са праговима .
{
"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
}Одговор: