18 Вредност ставке
Опис
Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају да се конфигурише виџет Item value уdashboard.createиdashboard.update методе.
Својства виџета fields се не проверавају током креирања или ажурирања контролне табле.
Ово омогућава корисницима да модификују built-in widgets и креирају [custom widgets]
(/devel/modules/tutorials/widget), али такође уводи ризик од некоректног креирања или ажурирања виџета.
Да би се обезбедило успешно креирање или ажурирање виџета Item value, молимо Вас да се придржавате понашања параметара наведених у табелама испод.
Параметри
Следећи параметри су подржани за виџет Вредност ставке.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Интервал освежавања | 0 | rf_rate | 0 - Нема освежавања; 10 - 10 секунди; 30 - 30 секунди; 60 - (подразумевано) 1 минут; 120 - 2 минута; 600 - 10 минута; 900 - 15 минута. |
|
| Ставка | 4 | itemid.0 | Ставка ID. Понашање својства: - обавезно ako Ставка (Виџет) није подешена. |
|
| Ставка (Виџет) | 1 | itemid._reference | Уместо Ставке ID:ABCDE._itemid- поставите компатибилни виџет (са параметром Референца постављеним на "ABCDE") као извор података за ставке.Понашање параметра: - обавезно ако Ставка није подешена |
|
| Приказ | 0 | show.0 | 1 - Опис; 2 - Вредност; 3 - Време; 4 - Индикатор промене; 5 - Sparkline. Подразумевано: 1, 2 , 3, 4. Напомена: Да бисте конфигурисали више вредности, креирајте објекат поља виџета контролне табле за сваку вредност са повећаним бројем у називу својства. |
|
| Замена домаћина | 1 | override_hostid._reference | ABCDE._hostid - поставите компатибилни виџет (са његовим параметром Референца постављеним на "ABCDE") као извор података за домаћине;DASHBOARD._hostid - подесите контролну таблу Host селектор као извор података за домаћине.Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
Напредна конфигурација
Следећи напредни конфигурациони параметри су подржани за виџет Item value.
Број у називу својства 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 | |
|---|---|---|---|---|
| Background color | 1 | bg_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
|
| Thresholds | ||||
| Color | 1 | thresholds.0.color | Хексадецимални код боје (нпр. FF0000). |
|
| Threshold | 1 | thresholds.0.threshold | Било која вредност стринга. | |
| Aggregation function | 0 | aggregate_function | 0 - (подразумевано) не користи се; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
| Time period | 1 | time_period._reference | DASHBOARD._timeperiod- поставите Time period selector као извор података;ABCDE._timeperiod – поставите compatible widget (са његовим параметром reference једнаким ABCDE) као извор података.Подразумевано: DASHBOARD._timeperiodАлтернативно, можете да подесите временски период само у параметрима Од и До. Parameter behavior: - подржано ако је функција агрегације постављена на "min", "max", "avg", "count", "sum", "first", "last" |
|
| From | 1 | time_period.from | Важећи временски низ у апсолутној (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.)..Parameter behavior: - подржано ако Временски период није подешен и функција агрегације је подешена на "min", "max", "avg", "count", "sum", "first", "last" |
|
| To | 1 | time_period.to | Важећи временски низ у апсолутној (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.).Parameter behavior: - подржано ако Time period није подешен и Aggregation function је подешена на "min", "max", "avg", "count", "sum", "first", "last" |
|
| History data | 0 | history | 0 - (подразумевано) Аутоматски; 1 - Историја; 2 - Трендови. |
|
Опис
Следећи напредни параметри конфигурације су подржани ако је Прикажи постављено на "Опис".
| Parameter | type | name | value |
|---|---|---|---|
| Description | 1 | description | Било која вредност стринга, укључујући макрое. Подржани макрои: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Макрои корисника. < br>Подразумевано: {ITEM.NAME}. |
| Horizontal position | 0 | desc_h_pos | 0 - лево; 1 - (подразумевано) Центар; 2 - десно. Два или више елемената (опис, вредност, време) не могу да деле исту Хоризонталну позицију и Вертикалну позицију. |
| Vertical position | 0 | desc_v_pos | 0 - Врх; 1 - Средина; 2 - (подразумевано) Доле. Два или више елемената (опис, вредност, време) не могу да деле исту Хоризонталну позицију и Вертикалну позицију. |
| Size | 0 | desc_size | Могуће вредности се крећу од 1-100. Подразумевано: 15. |
| Bold | 0 | desc_bold | 0 - (подразумевано) Онемогућено; 1 - Омогућено. |
| Color | 1 | desc_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
Вредност
Следећи напредни параметри конфигурације су подржани ако је Прикажи постављено на "Вредност".
| Parameter | type | name | value | |
|---|---|---|---|---|
| Decimal places | ||||
| Decimal places | 0 | decimal_places | Могуће вредности се крећу од 1-10. Подразумевано: 2. |
|
| Size | 0 | decimal_size | Могуће вредности се крећу од 1-100. Подразумевано: 35. |
|
| Position | ||||
| Horizontal position | 0 | value_h_pos | 0 - Лево; 1 - (подразумевано) Центар; 2 - Десно. Два или више елемената (Опис, Вредност, Време) не могу да деле исту Хоризонталну позицију и Вертикалну позицију. |
|
| Vertical position | 0 | value_v_pos | 0 - Врх; 1 - (подразумевано) Средња; 2 - Доле. Два или више елемената (Опис, Вредност, Време) не могу да деле исту Хоризонталну позицију и Вертикалну позицију. |
|
| Size | 0 | value_size | Могуће вредности у распону од 1-100. Подразумевано: 45. |
|
| Bold | 0 | value_bold | 0 - Онемогућено; 1 - (подразумевано) Омогућено. |
|
| Color | 1 | value_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
|
| Units | ||||
| Units (checkbox) | 0 | units_show | 0 - Онемогућено; 1 - (подразумевано) Омогућено. |
|
| Units (value) | 1 | units | Било која вредност стринга. | |
| Position | 0 | units_pos | 0 - Пре вредности; 1 - Изнад вредности; 2 - (подразумевано) После вредности; 3 - Испод вредности. |
|
| Size | 0 | units_size | Могуће вредности у распону од 1-100. Подразумевано: 35. |
|
| Bold | 0 | units_bold | 0 - Онемогућено; 1 - (подразумевано) Омогућено. |
|
| Color | 1 | units_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
|
Време
Следећи напредни параметри конфигурације су подржани ако је Прикажи постављено на "Време".
| Parameter | type | name | value |
|---|---|---|---|
| Horizontal position | 0 | time_h_pos | 0 - Лево; 1 - (подразумевано) Центар; 2 - Десно. Два или више елемената (Опис, Вредност, Време) не могу да деле исту Хоризонталну позицију и Вертикалну позицију. |
| Vertical position | 0 | time_v_pos | 0 - (подразумевано) Врх; 1 - Средња; 2 - Доле. Два или више елемената (Опис, Вредност, Време) не могу да деле исту Хоризонталну позицију и Вертикалну позицију. |
| Size | 0 | time_size | Могуће вредности у распону од 1-100. Подразумевано: 15. |
| Bold | 0 | time_bold | 0 - (подразумевано) Онемогућено; 1 - Омогућено. |
| Color | 1 | time_color | Хексадецимални код боје (нпр., FF0000).Подразумевано: "" (празно). |
Индикатор промене
Следећи напредни конфигурациони параметри су подржани ако је Прикажи постављено на "Индикатор промене".
| Parameter | type | name | value |
|---|---|---|---|
| Change indicator ↑ color | 1 | up_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
| Change indicator ↓ color | 1 | down_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
| Change indicator ↕ color | 1 | updown_color | Хексадецимални код боје (нпр. FF0000).Подразумевано: "" (празно). |
Sparkline
Следећи напредни параметри конфигурације су подржани ако је Приказ постављен на "Sparkline".
| Parameter | type | name | value | |
|---|---|---|---|---|
| Width | 0 | sparkline.width | Могуће вредности се крећу од 0-10. Подразумевано: 1. |
|
| Fill | 0 | sparkline.fill | Могуће вредности се крећу од 0-10. Подразумевано: 3. |
|
| Color | 1 | sparkline.color | Хексадецимални код боје (нпр. FF0000).Подразумевано: 42A5F5. |
|
| Time period | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod - поставите Селектор временског периода као извор података;ABCDE._timeperiod - поставите компатибилни виџет (са његовим параметром reference једнаким ABCDE) као извором података.Подразумевано: DASHBOARD._timeperiodАлтернативно, можете подесити само на Од и До параметре*. |
|
| From | 1 | sparkline.time_period.from | Важећи временски стринг у апсолутној (YYYY-MM-DD hh:mm:ss) или релативној временској синтакси (now, now/d, now/w-1w, итд.). |
|
| То | 1 | sparkline.time_period.to | Важећи временски стринг у апсолутној (YYYY-MM-DD hh:mm:ss) или релативној временској синтакси (now, now/d, now/w-1w, итд.). |
|
| History data | 0 | sparkline.history | 0 - (подразумевано) Аутоматски; 1 - Историја; 2 - Трендови. |
|
Примери
Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет Вредност ставке.
За више информација о конфигурисању контролне табле, погледајте dashboard.create.
Конфигурисање виџета Вредност ставке
Конфигуришите виџет Вредност ставке који приказује вредност ставке за ставку "42266" (доступност Zabbix агента). Поред тога, визуелно фино подесите виџет са више напредних опција, укључујући динамичку боју позадинето се мења на основу статуса доступности Zabbix агента.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 12,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 42266
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "E1E1E1"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D1C4E9"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": 1"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Одговор:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}