Documentation
Table of Contents
26 Top hosts
Опис
Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање виџета Top hosts у методама dashboard.create и dashboard.update.
Својства fields виџета се не проверавају током прављења или ажурирања контролне табле. Ово омогућава корисницима да модификују built-in widgets и креирају custom widgets, али такође уводи ризик од неправилног креирања или ажурирања виџета. Да бисте осигурали успешно креирање или ажурирање виџета * Top hosts*, погледајте понашање параметара наведено у табелама испод.
Параметри
Следећи параметри су подржани за виџет Top hosts.
|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|Host group ID.
Напомена: Да бисте конфигурисали више група домаћина, креирајте виџет контролне табле објекат поља за сваку групу домаћина са повећаним бројем у имену својства.
Овај параметар није подржан ако се конфигурише виџет на template dashboard.| |<|Host groups (Widget)|1|groupids._reference|Уместо Host group ID:ABCDE._hostgroupids - поставите compatible widget (са параметром * Reference* постављеним на "ABCDE") као извор података за групе домаћина.
Овај параметар није подржано ако се виџет конфигурише на template dashboard.| |Hosts|<|3|hostids.0|Host ID.
Напомена: Да бисте конфигурисали више домаћина, креирајте објекат поља виџета контролне табле за сваког домаћина са повећаним бројем у имену својства. За више домаћина, параметар Host groups уопште не мора бити конфигурисан или мора бити конфигурисан са најмање једном групом домаћина којој припадају конфигурисани домаћини.
Овај параметар није подржан ако се виџет конфигурише на template dashboard.| |<|Hosts (Widget/Dashboard)|1|hostids._reference|Уместо Host ID:DASHBOARD.hostids - поставите Host selector као извор података за домаћине;ABCDE._hostids - поставите compatible widget (са параметром * Reference* постављеним на "ABCDE") као извор података за домаћине.
Овај параметар није подржан ако се виџет конфигурише на template dashboard.| |Host tags|<|<|<|<| |<|Evaluation type|0|evaltype|0 - (подразумевано) И/Или;
2 - Или.
Овај параметар није подржан ако се конфигурише виџет на template dashboard.| |^|Tag name|1|tags.0.tag|Било која вредност стринга.
Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.
Parameter behavior:
- обавезно ако се конфигуришу Host tags
Овај параметар није подржан ако се виџет конфигурише на template dashboard.| |^|Operator|0|tags.0.operator|0 – Садржи;
1 – Једнако;
2 – Не садржи;
3 – Није једнако;
4 – Постоји ;
5 – Не постоји.
Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака.
Parameter behavior:
- обавезно ако се конфигуришу Host tags
Овај параметар није подржан ако се виџет конфигурише на template dashboard.| |^|Tag value|1|tags.0.value|Било која вредност стринга.
Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.
Parameter behavior:
- обавезно ако се конфигуришу Host tags
Овај параметар није подржан ако се виџет конфигурише наtemplate dashboard.| |Show hosts in maintenance|<|0|maintenance|0 - (подразумевано) Онемогућено;
1 - Омогућено.| |* Columns* (see below)|<|<|<|<| |Order by|<|0|колона|Нумеричка вредност колоне из конфигурисаних колона.| |Order|<|0|ред|2 - (подразумевано) Top N;
3 - Bottom N.| |Host limit|<|0|show_lines|Могуће вредности се крећу од 1-100.
Подразумевано: 10.
Овај параметар није подржан ако се виџет конфигурише на template dashboard.|
Колоне
Колоне имају заједничке параметре и додатне параметре у зависности од конфигурације параметра Data.
За све параметре који се односе на колоне, број у називу својства (нпр., columns.0.name) упућује на колону за коју је параметар конфигурисан.
Следећи параметри су подржани за све колоне.
| Parameter | type | name | value |
|---|---|---|---|
| Name | 1 | columns.0.name | Било која вредност стринга. Parameter behavior: - обавезно |
| Data | 0 | columns.0.data | 1 – Вредност ставке; 2 – Име домаћина; 3 – Текст. Parameter behavior: - обавезно |
| Base color | 1 | columns.0.base_color | Хексадецимални код боје (нпр. FF0000).Parameter behavior: -обавезно |
Вредност ставке
Следећи параметри су подржани ако је Подаци постављени на "Вредност ставке".
Први број у називу својства * Thresholds* (нпр.columnsthresholds.0.color.0) упућује на колону за коју су конфигурисани прагови, док други број упућује на гранично место на листи, сортирано у растућем редоследу. Међутим, ако су прагови конфигурисани другим редоследом, вредности ће бити сортиране у растућем редоследу након ажурирања конфигурације виџета у Zabbix корисничком интерфејсу (нпр. "threshold.0.threshold":"5" → "threshold.0.threshold":"1"; "threshold.1.threshold":"1" → "threshold.1.threshold": "5").
|Parameter|<|type|name|value| |-|--------|--|--------------------------------- -----| |Item|<|1 |columns.0.item|Важећи назив ставке.
Када конфигуришете виџет на template dashboard, само ставке конфигурисане на шаблону треба поставити.| |Display|<|0|columns.0.display|1 - (подразумевано) As is;
2 - Bar;
3 - Indicators.| |Min|<|1|columns.0.min|Било која нумеричка вредност.
Parameter behavior:
- подржано ако Display је подешен на "Bar" или "Indicators"| |Max|<|1|columns.0.max|Било која нумеричка вредност.
Parameter behavior:
- подржано ако је Display подешен на "Bar" или "Indicators"| |Decimal places|<|0|columns.0.decimal_places|Могуће вредности се крећу од 0-10.
Подразумевано: 2.| |Thresholds|<|<|<|<| |<|Color|1|columnsthresholds.0.color.0|Хексадецимални код боје (нпр. FF0000).
Подразумевано: "" (празно).| |^|Threshold|1|columnsthresholds.0.threshold.0|Било која вредност стринга.| |Aggregation function|<|0|columns.0.aggregate_function|0 - (подразумевано) се не користи;
1 - мин;
2 - максимално;
3 - просечно;
4 - број;
5 - сума;
6 - први;
7 - последњи.| |Time period|<|1|columns.0.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|columns.0.time_period.from|Важећи временски низ у апсолутном (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.).
Parameter behavior:
- supported ако Time period није подешен и Функција агрегације је подешена на "min", "max", "avg", "count", "sum", "first", "last"| |^|To|1|columns.0.time_period.to|Важећи временски низ у апсолутном (YYYY-MM-DD hh:mm:ss) или relative временска синтакса (now, now/d, now/w-1w, итд.).
Parameter behavior:
- supported ако Time period није подешен и Фунцкија агрегације је подешена на "min", "max", "avg", "count", "sum", "first", "last"| |History data|<|0|columns.0.history|0 |0 - (подразумевано) Аутоматски;
1 - Историја;
2 - Трендови.| |Reference|<|1|reference|Било која вредност стринга која се састоји од 5 карактера (нпр. ABCDE или JBPNL). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.
Parameter behavior:
- обавезно|
Текст
Следећи параметри су подржани ако је Подаци постављени на "Текст".
| Parameter | type | name | value |
|---|---|---|---|
| Text | 1 | columns.0.text | Било која вредност стринга, укључујући макрое. Подржани макрои: {HOST.*}, {INVENTORY.*}. Parameter behavior: - required ако је Data подешен на "Text" |
Примери
Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет Top hosts. За више информација о конфигурисању контролне табле погледајте dashboard.create.
Конфигурисање виџета Top hosts
Конфигуришите виџет Top hosts који приказује врхунске домаћине према коришћењу CPU-а у групи домаћина "4". Поред тога, конфигуришите следеће прилагођене колоне: "Host name", "CPU utilization in %", "1m avg", "5m avg", "15m avg", "Processes".
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "columns.0.name",
"value": "Host"
},
{
"type": 0,
"name": "columns.0.data",
"value": 2
},
{
"type": 1,
"name": "columns.0.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.1.name",
"value": "CPU utilization in %"
},
{
"type": 0,
"name": "columns.1.data",
"value": 1
},
{
"type": 1,
"name": "columns.1.base_color",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.1.item",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.1.display",
"value": 3
},
{
"type": 1,
"name": "columns.1.min",
"value": "0"
},
{
"type": 1,
"name": "columns.1.max",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.1.color.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.1.color.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.1.color.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.2",
"value": "90"
},
{
"type": 1,
"name": "columns.2.name",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.2.data",
"value": 1
},
{
"type": 1,
"name": "columns.2.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.2.item",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.3.name",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.3.data",
"value": 1
},
{
"type": 1,
"name": "columns.3.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.3.item",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.4.name",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.4.data",
"value": 1
},
{
"type": 1,
"name": "columns.4.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.4.item",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.5.name",
"value": "Processes"
},
{
"type": 0,
"name": "columns.5.data",
"value": 1
},
{
"type": 1,
"name": "columns.5.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.5.item",
"value": "Number of processes"
},
{
"type": 0,
"name": "columns.5.decimal_places",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1}Одговор: