Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају да се конфигурише виџет Item value уdashboard.create
иdashboard.update
методе.
Својства виџета fields
се не проверавају током креирања или ажурирања контролне табле. Ово омогућава корисницима да модификују built-in widgets и креирају [custom widgets] (/devel/modules/tutorials/widget), али такође уводи ризик од некоректног креирања или ажурирања виџета. Да би се обезбедило успешно креирање или ажурирање виџета Item value, молимо Вас да се придржавате понашања параметара наведених у табелама испод.
Следећи параметри су подржани за виџет Вредност ставке.
Parameter | type | name | value | |
---|---|---|---|---|
Refresh interval | 0 | rf_rate | 0 - Нема освежавања; 10 - 10 секунди; 30 - 30 секунди; 60 - (подразумевано) 1 минут; 120 - 2 минута; 600 - 10 минута; 900 - 15 минута. |
|
Item | 4 | itemid.0 | Item ID. Parameter behavior: - required ako Item (Widget) није подешен. |
|
Item (Widget) | 1 | itemid._reference | Уместо Item ID:ABCDE._itemid - поставите compatible widget (са параметром * Reference* постављеним на "ABCDE ") као извор података за ставке.Parameter behavior: - обавезно ако Ставка није подешена |
|
Show | 0 | show.0 | 1 - Опис; 2 - Вредност; 3 - Време; 4 - Индикатор промене. Подразумевано: 1, 2 , 3, 4 (све омогућено). Напомена: Да бисте конфигурисали више вредности, креирајте објекат поља виџета контролне табле за сваку вредност са повећаним бројем у називу својства. |
|
Override host | 1 | override_hostid._reference | ABCDE._hostid - поставите compatible widget (са његовим параметром * Reference* постављен на "ABCDE ") као извор података за домаћине;DASHBOARD._hostid - подесите контролну таблу Host selector као извор података за домаћине.Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
Следећи напредни конфигурациони параметри су подржани за виџет 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 ).Подразумевано: "" (празно). |
Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет Вредност ставке. За више информација о конфигурисању контролне табле, погледајте 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
}
Одговор: