Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање виџета Најважније ставке у методама dashboard.create
и dashboard.update
.
Својства поља
виџета се не валидирају током креирања или ажурирања контролне табле.Ово омогућава корисницима да мењају уграђене виџете и креирају прилагођене виџете, али такође уводи ризик од погрешног креирања или ажурирања виџета. Да бисте осигурали успешно креирање или ажурирање виџета Најважније ставке, погледајте понашање параметара наведено у табелама испод.
Следећи параметри су подржани за виџет Најважније ставке.
Parameter | type | name | value | |
---|---|---|---|---|
Refresh interval | 0 | rf_rate | 0 - Без освежавања; 10 - 10 секунди; 30 - 30 секунди; 60 - (подразумевано) 1 минут; 120 - 2 минута; 600 - 10 минута; 900 - 15 минута. |
|
Host groups | 2 | groupids.0 | Група домаћина ID. Напомена: Да бисте конфигурисали више група домаћина, креирајте објекат поља виџета контролне табле за сваку групу домаћина са повећаним бројем у називу својства. Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
Host groups (Widget) | 1 | groupids._reference | Уместо Група домаћина ID:ABCDE._hostgroupids - подесите компатибилни виџет (са параметром Reference подешеним на "ABCDE ") као извор података за групе домаћина.Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
Hosts | 3 | hostids.0 | Домаћин ID. Напомена: Да бисте конфигурисали више домаћина, креирајте објекат поља виџета контролне табле за сваког домаћина са увећаним бројем у називу својства. За више домаћина, параметар Групе домаћина мора или уопште да не буде конфигурисан или конфигурисан са најмање једном групом домаћина којој конфигурисани домаћини припадају. Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
Hosts (Widget/Dashboard) | 1 | hostids._reference | Уместо Домаћина ID:DASHBOARD.hostids - подесите Домаћин селектор као извор података за домаћине;ABCDE._hostids - подесите компатибилни виџет (са параметром Референца подешеним на „ABCDE “) као извор података за домаћине.Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
*Host tags** | ||||
Evaluation type | 0 | host_tags_evaltype | 0 - (подразумевано) И/Или; 2 - Или. Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
Tag name | 1 | host_tags.0.tag | Било која вредност стринга. Напомена: Број у називу својства упућује на редослед ознака на листи евалуације ознака. Понашање параметра: - обавезно ако се конфигуришу Ознаке домаћина Овај параметар није подржано ако се виџет конфигурише на шаблон контролне табле. |
|
* Operator* | 0 | host_tags.0.operator | 0 - Садржи; 1 - Једнако је; 2 - Не садржи; 3 - Није једнако; 4 - Постоји; 5 - Не постоји. Напомена: Број у називу својства референцира редослед ознака на листи за процену ознака. Понашање параметра: - обавезно ако се конфигуришу Ознаке домачина Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле. |
|
Tag value | 1 | host_tags.0.value | Било која вредност стринга. Напомена: Број у називу својства референцира редослед ознака у ознаци листа за евалуацију. Понашање параметра: - обавезно ако се конфигуришу Ознаке домаћина Овај параметар није подржан ако се конфигурише виџет на шаблон контролне табле. |
|
* Layout* | 0 | распоред | 0 - (подразумевано) Хоризонтално; 1 - Вертикално. |
|
Show problems | 0 | show_problems | 0 - Све; 1 - (подразумевано) Није потиснуто; 2 - Ниједан. |
|
Items (видети доле) |
Следећи напредни параметри конфигурације су подржани за виџет Најбоље ставке.
Parameter | type | name | value | |
---|---|---|---|---|
Host ordering* | ||||
*Order by** | 0 | host_ordering_order_by | 0 - (подразумевано) Име хоста; 3 - Вредност ставке. |
|
Item patterns | 1 | host_ordering_item.0 | Ставка назив или образац (нпр., "*: Број обрађених *вредности у секунди"). Напомена: Да бисте конфигурисали више образаца ставки, креирајте објекат поља виџета контролне табле за сваки образац ставке са увећани број у називу својства. Приликом конфигурисања виџета на шаблон контролне табле, треба подесити само обрасце за ставке конфигурисане на шаблону. Понашање параметра: - обавезно ако је Ордер по подешено на "Вредност ставке" |
|
* Order* | 0 | host_ordering_order | 2 - (подразумевано) Горњи N; 3 - Доњи N. |
|
* Limit* | 0 | host_ordering_limit | Могуће вредности се крећу од 1-100. Подразумевано: 10. |
|
Item ordering | ||||
*Order by** | 0 | item_ordering_order_by | 1 - Хост; 2 - Назив ставке; 3 - (подразумевано) Ставка вредност. |
|
Host patterns | 1 | item_ordering_host.0 | Домаћин име или образац. Напомена: Да бисте конфигурисали више образаца домаћина, креирајте објекат поља виџета контролне табле за сваки образац домаћина са увећаним бројем у називу својства. Понашање параметра: - обавезно ако је Поређај по подешено на "Домаћин" |
|
* Order* | 0 | item_ordering_order | 2 - (подразумевано) Горњи N; 3 - Доњи N. |
|
* Limit* | 0 | item_ordering_limit | Могуће вредности се крећу од 1-100. Подразумевано: 10. |
Први број у називу својства (нпр. columns.0.items.0, columns.0.item_tags_evaltype) представља одређену колону, док други број, ако је присутан, представља конфигурисани ентитет (нпр. шаблон ставке, ознаку).
Parameter | type | name | value | |
---|---|---|---|---|
Item patterns | 1 | columns.0.items.0 | Ставка назив или шаблон (нпр., "*: Број обрађених *вредности у секунди"). Напомена: Да бисте конфигурисали више шаблона ставки, креирајте објекат поља виџета контролне табле за сваку ставку образац са повећаним другим бројем у називу својства. Приликом конфигурисања виџета на шаблон контролне табле, треба подесити само обрасце за ставке конфигурисане на шаблону. Понашање параметра: - обавезно |
|
Item tags | ||||
Evaluation type | 0 | columns.0.item_tags_evaltype | 0 - (подразумевано) И/Или; 2 - Или. |
|
Tag name | 1 | columns.0.item_tags.0.tag | Било која вредност стринга. Напомена: Други број у називу својства упућује на редослед ознака на листи евалуације ознака. Понашање параметра: - обавезно ако се конфигурише Ознаке ставки |
|^|* Operator|0|columns.0.item_tags.0.operator|0 - Садржи;
1 - Једнако;
2 - Не садржи;
3 - Није једнако;
4 - Постоји;
5 - Не постоји.
Напомена: Други број у називу својства упућује на редослед ознака на листи за процену ознака.
Понашање параметра:
- обавезно* ако се конфигурише Ознаке ставки| |^|Tag value|1|columns.0.item_tags.0.value|Било која вредност стринга.
Напомена: Други број у називу својства упућује на редослед ознака на листи за процену ознака.
Понашање параметра:
- обавезно ако се конфигурише Ознаке ставки|
|Base color|<|1|columns.0.base_color|Хексадецимални код боје (нпр. FF0000
).| |*Display value as**|<|0|columns.0.display_value_as|1 - (подразумевано) Нумеричко;
2 - Текст. ||* Display|<|0|columns.0.display|1 - (подразумевано)* Као што јесте;
2 - Трака;
3 - Индикатори;
6 - Sparkline.| |* Min|<|1|columns.0.min|Било која нумеричка вредност. Суфикси (нпр. "1d", "2w", "4K", "8G") су подржани.
Понашање параметра:
- подржано* ако је Прикажи вредност као подешено на „Нумеричко“ и Приказ је подешено на "Странични" или "Индикатори"| |* Max|<|1|columns.0.max|Било која нумеричка вредност. Суфикси (нпр. "1d", "2w", "4K", "8G") су подржани.
Понашање параметра:
- подржано* ако је Прикажи вредност као подешено на "Нумеричко" и Приказ је подешено на "Странично" или "Индикатори"| |* Sparkline|<|<|<| |<| Width|0|columns.0.sparkline.width|Могуће вредности се крећу од 0-10.
Подразумевано: 1.
Понашање параметра:
- подржано* ако је Приказ подешено на "Sparkline"| |^|Fill|0|columns.0.sparkline.fill|Могуће вредности се крећу од 0-10.
Подразумевано: 3.
Понашање параметра:
- подржано ако је Display подешено на "Sparkline"| |^|* Color|1|columns.0.sparkline.color|Хексадецимални код боје (нпр. FF0000
).
Подразумевано: 42A5F5
.
Понашање параметра:
- подржано* ако је Приказ подешено на „Sparkline“| |^|Time period|1|columns.0.sparkline.time_period._reference|DASHBOARD._timeperiod
- подесите селектор Временског периода као извор података;ABCDE._timeperiod
- подесите компатибилни виџет (са параметром reference
једнаким ABCDE
) као податке извор.
Подразумевано: DASHBOARD._timeperiod
Алтернативно, временски период можете подесити само у параметрима From и To.
Понашање параметра:
- подржано ако је Display подешено на "Sparkline"| |^|From|1|columns.0.sparkline.time_period.from|Важећи временски стринг у апсолутној (YYYY-MM-DD hh:mm:ss
) или релативној синтакси времена (now
, now/d
, now/w-1w
, итд.).
Понашање параметра:
- подржано ако је Display подешено на "Sparkline"| |^|* To|1|columns.0.sparkline.time_period.to|Важећи временски стринг у апсолутној (ГГГГ-ММ-ДД хх:мм:сс
) или релативној синтакси времена (now
, now/d
, now/w-1w
, итд.).
Понашање параметра:
- подржано* ако је Приказ подешено на "Sparkline"| |^|History data|0|columns.0.sparkline.history|0 - (подразумевано) Аутоматски;
1 - Историја;
2 - Трендови.
Понашање параметра:
- подржано ако је Приказ подешено на "Спарклајн"| |* Thresholds|<|<|<| |<| Color|1|columns.0.thresholds.0.color|Хексадецимални код боје (нпр. FF0000
).
Понашање параметра:
- подржано* ако је Прикажи вредност као подешено на "Нумеричко"| |^|* Threshold|1|columns.0.thresholds.0.threshold|Било која нумеричка вредност. Суфикси (нпр. "1d", "2w", "4K", "8G") су подржани.
Понашање параметра:
- подржано* ако је Прикажи вредност као подешено на "Нумеричко"| |* Highlights|<|<|<| |<| Highlight|1|columns.0.highlights.0.color|Хексадецимални код боје (нпр. FF0000
).
Понашање параметра:
- подржано* ако је Прикажи вредност као подешено на "Текст"| |^|* Threshold|1|columns.0.highlights.0.pattern|Било који регуларни израз.
Понашање параметра:
- подржано* ако је Прикажи вредност као подешено на „Текст“| |Decimal places|<|0|columns.0.decimal_places|Могуће вредности се крећу од 0-10.
Подразумевано: 2.|
|dvanced configuration|<|<|<|<| |Aggregation function|<|0|columns.0.aggregate_function|Ако је Прикажи вредност као подешено на "Нумеричко ":
0 - (подразумевано) се не користи;
1 - мин;
2 - макс;
3 - просек;
4 - број;
5 - збир;
6 - први;
7 - последњи.
Ако је Прикажи вредност као подешено на "Текст ":
0 - (подразумевано) се не користи;
4 - број;
6 - први;
7 - последњи.| |Time period|<|1|columns.0.time_period._reference|DASHBOARD._timeperiod
- подесите селектор Временски период као извор података;ABCDE._timeperiod
- подесите компатибилни виџет (са параметром reference
једнаким ABCDE
) као извор података.
Подразумевано: DASHBOARD._timeperiod
Алтернативно, можете подесити временски период само у параметрима From и To.
Понашање параметра:
- подржано ако је Функција агрегације подешена на "min", "max", "avg", "count", "sum", "first", "last"| |<|From|1|columns.0.time_period.from|Важећи временски стринг у апсолутној (YYYY-MM-DD hh:mm:ss
) или релативној синтакси времена (now
, now/d
, now/w-1w
, итд.).
Понашање параметра:
- подржано ако Временски период није подешен и Функција агрегације је подешена на "min", "max", "avg", "count", "sum", "first", "last"| |^|* To|1|columns.0.time_period.to|Важећи временски стринг у апсолутној (YYYY-MM-DD hh:mm:ss
) или релативној синтакси времена (now
, now/d
, now/w-1w
, итд.).
Понашање параметра:
- подржано* ако Временски период није подешен и Функција агрегације је подешена на "мин", "макс", "просек", "број", "сум", "први", "последњи"| |History data|<|0|columns.0.history|0 - (подразумевано) Аутоматски;
1 - Историја;
2 - Трендови.
Понашање параметра:
- подржано ако је Прикажи вредност као подешено на "Нумеричко"|
Следећи примери имају за циљ да опишу само конфигурацију објеката поља виџета контролне табле за виџет Најважније ставке. За више информација о конфигурисању контролне табле, погледајте dashboard.create
.
Конфигуришите виџет Најважније ставке који приказује податке за домаћина "10084" и само за ставке за које ознака са називом "компонента" садржи вредност "cpu". Поред тога, прикажите податке са домаћинима који се налазе на врху и користите обојену траку за представљање ћелија.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "topitems",
"name": "Top items",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "columns.0.items.0",
"value": "*"
},
{
"type": 1,
"name": "columns.0.item_tags.0.tag",
"value": "component"
},
{
"type": 0,
"name": "columns.0.item_tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "columns.0.item_tags.0.value",
"value": "cpu"
},
{
"type": 0,
"name": "columns.0.display",
"value": 2
},
{
"type": 0,
"name": "layout",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Resposta: