[comment]: # translation:outdated

[comment]: # ({95e690e3-978cbb20})
# 26 Top hosts

[comment]: # ({/95e690e3-978cbb20})

[comment]: # ({50a91710-c5138763})
### Опис

Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање
виџета [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts)  у методама `dashboard.create` и `dashboard.update`.

::: noteimportant
Својства `fields` виџета се не проверавају током прављења или ажурирања контролне табле.
Ово омогућава корисницима да модификују [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) и креирају [custom widgets](/devel/modules/tutorials/widget), али такође уводи ризик од неправилног креирања или ажурирања виџета.
Да бисте осигурали успешно креирање или ажурирање виџета * Top hosts*, погледајте понашање параметара наведено у табелама испод.
:::

[comment]: # ({/50a91710-c5138763})

[comment]: # ({b9d84b38-a3febace})
### Параметри

Следећи параметри су подржани за виџет *Top hosts*.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------------------------------- -----|
|*Refresh interval*|<|0|rf_rate|0 - Нема освежавања;<br>10 - 10 секунди;<br>30 - 30 секунди;<br>60 - *(подразумевано)* 1 минут;<br>120 - 2 минута;<br>600 - 10 минута;<br>900 - 15 минута.|
|*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Напомена: Да бисте конфигурисали више група домаћина, креирајте виџет контролне табле објекат поља за сваку групу домаћина са повећаним бројем у имену својства.<br><br>Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Host groups (Widget)*|1|groupids.\_reference|Уместо [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - поставите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са параметром * Reference* постављеним на "`ABCDE `") као извор података за групе домаћина.<br><br>Овај параметар није подржано ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Напомена: Да бисте конфигурисали више домаћина, креирајте објекат поља виџета контролне табле за сваког домаћина са повећаним бројем у имену својства. За више домаћина, параметар *Host groups* уопште не мора бити конфигурисан или мора бити конфигурисан са најмање једном групом домаћина којој припадају конфигурисани домаћини.<br><br>Овај параметар није подржан ако се виџет конфигурише на  [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Уместо [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - поставите [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) као извор података за домаћине;<br>`ABCDE._hostids` - поставите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са параметром * Reference* постављеним на "`ABCDE `") као извор података за домаћине.<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Host tags*|<|<|<|<|
|<|*Evaluation type*|0|evaltype|0 - *(подразумевано)* И/Или;<br>2 - Или.<br><br>Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag name*|1|tags.0.tag|Било која вредност стринга.<br><br>Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигуришу *Host tags*<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Operator*|0|tags.0.operator|0 – Садржи;<br>1 – Једнако;<br>2 – Не садржи;<br>3 – Није једнако;<br>4 – Постоји ;<br>5 – Не постоји.<br><br>Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигуришу *Host tags*<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag value*|1|tags.0.value|Било која вредност стринга.<br><br>Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигуришу *Host tags*<br><br>Овај параметар није подржан ако се виџет конфигурише на[template dashboard](/manual/api/reference/templatedashboard/object).|
|*Show hosts in maintenance*|<|0|maintenance|0 - *(подразумевано)* Онемогућено;<br>1 - Омогућено.|
|* Columns* (see below)|<|<|<|<|
|*Order by*|<|0|колона|Нумеричка вредност колоне из конфигурисаних колона.|
|*Order*|<|0|ред|2 - *(подразумевано)* Top N;<br>3 - Bottom N.|
|*Host limit*|<|0|show_lines|Могуће вредности се крећу од 1-100.<br><br>Подразумевано: 10.<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|

[comment]: # ({/b9d84b38-a3febace})

[comment]: # ({e8e68707-8266fc04})
#### Колоне

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

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

[comment]: # ({/e8e68707-8266fc04})

[comment]: # ({e35e7f37-bba2be85})
Следећи параметри су подржани за све колоне.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Name*|1|columns.0.name|Било која вредност стринга.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|
|*Data*|0|columns.0.data|1 – Вредност ставке;<br>2 – Име домаћина;<br>3 – Текст.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|
|*Base color*|1|columns.0.base_color|Хексадецимални код боје (нпр. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>-*обавезно*|

[comment]: # ({/e35e7f37-bba2be85})

[comment]: # ({2ad267bb-e8b395eb})
##### Вредност ставке

Следећи параметри су подржани ако је *Подаци* постављени на "Вредност ставке".

::: noteclassic
Први број у називу својства * Thresholds* (нпр.columnsthresholds.0.color.0) упућује на колону за коју су конфигурисани прагови,
док други број упућује на гранично место на листи, сортирано у растућем редоследу.
Међутим, ако су прагови конфигурисани другим редоследом, вредности ће бити сортиране у растућем редоследу након ажурирања конфигурације виџета у Zabbix корисничком интерфејсу
(нпр. `"threshold.0.threshold":"5"` → `"threshold.0.threshold":"1"`; `"threshold.1.threshold":"1"` → `"threshold.1.threshold": "5"`).
:::

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------------------------------- -----|
|*Item*|<|1 |columns.0.item|Важећи назив ставке.<br><br>Када конфигуришете виџет на [template dashboard](/manual/api/reference/templatedashboard/object), само ставке конфигурисане на шаблону треба поставити.|
|*Display*|<|0|columns.0.display|1 - *(подразумевано)* As is;<br>2 - Bar;<br>3 - Indicators.|
|*Min*|<|1|columns.0.min|Било која нумеричка вредност.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *подржано* ако *Display* је подешен на "Bar" или "Indicators"|
|*Max*|<|1|columns.0.max|Било која нумеричка вредност.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *подржано* ако је *Display* подешен на "Bar" или "Indicators"|
|*Decimal places*|<|0|columns.0.decimal_places|Могуће вредности се крећу од 0-10.<br><br>Подразумевано: 2.|
|*Thresholds*|<|<|<|<|
|<|*Color*|1|columnsthresholds.0.color.0|Хексадецимални код боје (нпр. `FF0000`).<br><br>Подразумевано: `""` (празно).|
|^|*Threshold*|1|columnsthresholds.0.threshold.0|Било која вредност стринга.|
|*Aggregation function*|<|0|columns.0.aggregate_function|0 - *(подразумевано)* се не користи;<br>1 - мин;<br>2 - максимално;<br>3 - просечно;<br> 4 - број;<br>5 - сума;<br>6 - први;<br>7 - последњи.|
|*Time period*|<|1|columns.0.time_period.\_reference|`DASHBOARD._timeperiod` - подесите [*Time period* selector](/manual/web_interface/time_period_selector) као извор података;<br>`ABCDE._timeperiod` - поставите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са његовим параметром `reference ` једнаким `ABCDE `) као извор података.<br><br>Подразумевано: `DASHBOARD._timeperiod`<br><br>Алтернативно, можете да подесите временски период само у параметрима *Од* и *До*<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *подржано* ако је *Функција агрегације* постављена на "min", "max", "avg", "count", "sum", "first", "last"|
|<|*From*|1|columns.0.time_period.from|Важећи временски низ у апсолутном (`YYYY-MM-DD hh:mm:ss`) или [relative](/manual/web_interface/time_period_selector) временској синтакси (`now`, `now/d`, `now/w-1w`, итд.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* ако *Time period* није подешен и *Функција агрегације* је подешена на "min", "max", "avg", "count", "sum", "first", "last"|
|^|*To*|1|columns.0.time_period.to|Важећи временски низ у апсолутном (`YYYY-MM-DD hh:mm:ss`) или [relative](/manual/web_interface/time_period_selector) временска синтакса (`now`, `now/d`, `now/w-1w`, итд.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* ако *Time period* није подешен и *Фунцкија агрегације* је подешена на "min", "max", "avg", "count", "sum", "first", "last"|
|*History data*|<|0|columns.0.history|0 |0 - *(подразумевано)* Аутоматски;<br>1 - Историја;<br>2 - Трендови.|
|*Reference*|<|1|reference|Било која вредност стринга која се састоји од 5 карактера (нпр. `ABCDE ` или `JBPNL `). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|

[comment]: # ({/2ad267bb-e8b395eb})

[comment]: # ({55d0acdb-18fd738d})
##### Текст

Следећи параметри су подржани ако је *Подаци* постављени на "Текст".

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Text*|1|columns.0.text|Било која вредност стринга, укључујући макрое.<br>Подржани макрои:  {HOST.\*}, {INVENTORY.\*}.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* ако је *Data* подешен на "Text"|

[comment]: # ({/55d0acdb-18fd738d})

[comment]: # ({e7eaa526-c274247c})
### Примери

Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет *Top hosts*.
За више информација о конфигурисању контролне табле погледајте [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/e7eaa526-c274247c})

[comment]: # ({ec72cf7d-2e9b79c3})
#### Конфигурисање виџета *Top hosts*

Конфигуришите виџет *Top hosts* који приказује врхунске домаћине према коришћењу CPU-а у групи домаћина "4". Поред тога, конфигуришите следеће прилагођене колоне: "Host name", "CPU utilization in %", "1m avg", "5m avg", "15m avg", "Processes".

[Request](/manual/api#performing-requests):

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

Одговор:

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

[comment]: # ({/ec72cf7d-2e9b79c3})

[comment]: # ({e9d30322-d8c32fe2})
### Погледајте такође

- [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-d8c32fe2})