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