17 Вредност ставке

Опис

Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају да се конфигурише виџет 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 агента.

Request:

{
            "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
       }

Погледајте такође