15 Историја предмета

Опис

Ови параметри и могуће вредности својстава за одговарајућа поља виџета на контролној табли омогућавају конфигурисање виџета Item history у методама dashboard.create и dashboard.update.

Својства виџета fields се не проверавају током креирања или ажурирања контролне табле. Ово омогућава корисницима да модификују built-in widgets и креирају custom widgets, али такође уводи ризик од некоректног креирања или ажурирања виџета. Да би се обезбедило успешно креирање или ажурирање виџета Историја ставке, молимо вас да се придржавате понашања параметара наведених у табелама испод.

Параметри

Следећи параметри су подржани за виџет Историја ставки.

Parameter type name value
Refresh interval 0 rf_rate 0 - Нема освежавања;
10 - 10 секунди;
30 - 30 секунди;
60 - (подразумевано) 1 минут;
120 - 2 минута;
600 - 10 минута;
900 - 15 минута.
Layout 0 layout 0 - (подразумевано) Хоризонтално;
1 - Вертикално.
Columns (see below)
Show lines 0 show_lines Могуће вредности су у распону од 1-100.

Подразумевано: 25.
Override host 1 override_hostid..\ _reference ABCDE._hostid - поставите compatible widget (са његовим параметром Референце постављеним на "ABCDE") као извор података за домаћине;
DASHBOARD._hostid - поставите контролну таблу Host selector као податке извор за домаћине.

Овај параметар није подржан ако се виџет конфигурише на template dashboard.
Advanced configuration (see below)
Reference 1 reference Било која вредност низа која се састоји од 5 карактера (нпр. ABCDE или JBPNL). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.

Parameter behavior:
- обавезно

Колоне

Колоне имају заједничке параметре и додатне параметре у зависности од конфигурације параметра Ставке.

За све параметре који се односе на колоне, број у називу својства (нпр., columns.0.name) упућује на колону за коју је параметар конфигурисан.

Следећи параметри су подржани за све колоне.

Parameter type name value
Name 1 columns.0.name Било која вредност стринга.

Parameter behavior:
- обавезно
Item 4 columns.0.itemid Item ID.

Када конфигуришете виџет на template dashboard, треба поставити само ставке конфигурисане у шаблону.

Parameter behavior:
- обавезно
Base color 1 columns.0.base_color Хексадецимални код боје (нпр. FF0000).

Подразумевано: "" (празно).

Следећи параметри колоне су подржани ако је конфигурисана Item ставка нумеричког типа.

Parameter type name value
Display 0 columns.0.display 1 - (подразумевано) Као што је;
2 - Bar;
3 - Индикатори.
Min 1 columns.0.min Било која нумеричка вредност.

Parameter behavior:
- подржано ако је Display подешен на "Bar" или "Indicators"
Max 1 columns.0.max Било која нумеричка вредност.

Parameter behavior:
- подржано ако је Display подешен на "Bar" или "Indicators"
Thresholds
Color 1 columns.0.thresholds.0.color Хексадецимални код боје (нпр. FF0000).
Threshold 1 columns.0.thresholds.0.threshold Било која нумеричка вредност. Suffixes (нпр., "1d", "2w", "4K", "8G") су подржани.
History data 0 columns.0.history 0 - (подразумевано) Аутоматски;<бр>1 - Историја;
2 - Трендови.

Следећи параметри колоне су подржани ако је конфигурисана Ставка типа карактера, текста или евиденције.

Parameter type name value
Highlights
Highlight 1 columns.0.highlights.0.color Хексадецимални код боје (нпр. `FF0000``).
Threshold 1 columns.0.highlights.0.pattern Било који регуларни израз.
Display 0 columns.0.display 1 - (default) Како јесте;
4 - HTML;
5 - Један ред.
Single line 0 columns.0.max_length Могуће вредности се крећу од 1-500.

Подразумевано: 100.

Parameter behavior:
- supported ако је Display постављен на "Single line"
Use monospace font 0 columns.0.monospace_font 0 - (подразумевано) Користи подразумевани фонт;
1 - Користи monospace фонт.
Display local time 0 columns.0.local_time 0(подразумевано) Прикажи временску ознаку;<бр>1 - Прикажи локално време.

Parameter behavior:
- подржано ако је Ставка постављена на ставку типа дневника, а Прикажи временску ознаку је подешено на "Омогућено"

Следећи параметри колоне су подржани ако је конфигурисанa Ставка ставка бинарног типа.

Parameter type name value
Show thumbnail 1 columns.0.show_thumbnail 0 - (default) Онемогућено;
1 - Омогућено.

Напредна конфигурација

Следећи напредни конфигурациони параметри су подржани за виџет Историја ставке.

Parameter type name value
New values 0 sortorder 0 - (подразумевано) Врх;
1 - Доле.
Show timestamp 0 show_timestamp 0 - (подразумевано) Онемогућено;
1 - Омогућено.
Show column header 0 show_column_header 0 - Искључено;
1 - Хоризонтално;
2 - (подразумевано) Вертикално.
Time period 1 time_period._reference DASHBOARD._timeperiod - поставите Time period selector као извор података;
ABCDE._timeperiod – поставите compatible widget (са параметром Reference постављеним на "ABCDE") као извор података.

Подразумевано: DASHBOARD._timeperiod

Алтернативно, можете подесити временски период само у параметрима Од и До.
From 1 time_period.from Важећи временски низ у апсолутној (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.).Parameter behavior:
- подржано ако Time period није подешен
To 1 time_period.to Важећи временски низ у апсолутној (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.).

Parameter behavior:
- подржано ако Time period није подешен

Примери

Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет Навигатор ставки. За више информација о конфигурисању контролне табле погледајте dashboard.create.

Конфигурисање виџета Историја ставки

Конфигуришите виџет Историја ставки који приказује најновије податке за две нумеричке ставке "42269" и "42270". Поред тога, конфигуришите колоне ставки да се приказују вертикално, са називима колона приказаним хоризонтално; ограничити приказ на 15 редова података и укључити засебну колону временске ознаке.

Request:

{
     "jsonrpc": "2.0",
     "method": "dashboard.create",
     "params": {
     "name": "My dashboard",
     "display_period": 30,
     "auto_start": 1,
     "pages": [
     {
     "widgets": [
     {
     "type": "itemhistory",
     "name": "Item history",
     "x": "0",
     "y": "0",
     "width": "18",
     "height": "6",
     "view_mode": "0",
     "fields": [
     {
     "type": "0",
     "name": "layout",
     "value": "1"
     },
     {
     "type": "1",
     "name": "columns.0.name",
     "value": "CPU utilization"
     },
     {
     "type": "4",
     "name": "columns.0.itemid",
     "value": "42269"
     },
     {
     "type": "1",
     "name": "columns.1.name",
     "value": "Memory utilization"
     },
     {
     "type": "4",
     "name": "columns.1.itemid",
     "value": "42270"
     },
     {
     "type": "0",
     "name": "show_lines",
     "value": "15"
     },
     {
     "type": "0",
     "name": "show_timestamp",
     "value": "1"
     },
     {
     "type": "0",
     "name": "show_column_header",
     "value": "1"
     },
     {
     "type": "1",
     "name": "reference",
     "value": "KIVKD"
     }
     ]
     }
     ]
     }
     ],
      "userGroups": [
     {
     "usrgrpid": 7,
     "permission": 2
     }
     ],
     "users": [
     {
     "userid": 1,
     "permission": 3
     }
     ]
     },
     "id": 1
}

Одговор:

{
     "jsonrpc": "2.0",
     "result": {
     "dashboardids": [
     "3"
     ]
     },
     "id": 1
}

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