[comment]: # translation:outdated

[comment]: # ({11ceac39-893a57b4})
# 21 Топ узлов сети

[comment]: # ({/11ceac39-893a57b4})

[comment]: # ({cf47196c-1b9f777d})
### Описание

Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Топ узлов сети*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) в методах `dashboard.create` и `dashboard.update`.

::: noteimportant
Свойства полей виджета не проверяются во время создания или обновления информационной панели.
Это позволяет пользователям изменять [встроенные виджеты](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) и создавать [пользовательские виджеты](/manual/modules#developing-modules), но также создает риск неправильного создания или обновления виджетов.
Чтобы обеспечить успешное создание или обновление виджета *Топ узлов сети*, ознакомьтесь с требованиями к параметрам, указанными в таблицах ниже.
:::

[comment]: # ({/cf47196c-1b9f777d})

[comment]: # ({new-342177fd})
### Parameters

The following parameters are supported for the *Top Hosts* widget.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.|
|*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.|
|*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.|
|*Host Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<|
|<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.|
|^|*Tag name*|1|tags.tag.0|Any string value.<br><br>Parameter *Tag name* required if configuring *Tags*.|
|^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Parameter *Operator* required if configuring *Tags*.|
|^|*Tag value*|1|tags.value.0|Any string value.<br><br>Parameter *Tag value* required if configuring *Tags*.|
|*Columns* (see below)|<|<|<|<|
|*Order*|<|0|order|2 - *(default)* Top N;<br>3 - Bottom N.|
|*Order column*|<|0|column|Column numeric value from the configured columns.|
|*Host count*|<|0|count|Valid values range from 1-100.<br><br>Default: 10.|

[comment]: # ({/new-342177fd})

[comment]: # ({ebf9b848-14b55db3})
#### Столбцы

Столбцы имеют общие параметры и дополнительные параметры в зависимости от настройки параметра *Данные*.

::: noteclassic
Для всех параметров, связанных со столбцами, число в имени свойства (например, columns.name.0) указывает на столбец, для которого настроен параметр.
:::

[comment]: # ({/ebf9b848-14b55db3})

[comment]: # ({4f32414f-5321700b})
Следующие параметры поддерживаются для всех столбцов.

|Параметр|[тип](/manual/api/reference/dashboard/object#поле-виджета-панели)|имя|значение|
|-----|-|-----|-------------------|
|*Name*|1|columns.name.0|Любое строковое значение.|
|***Data***<br>(обязательно)|0|columns.data.0|1 - Значение элемента;<br>2 - Имя хоста;<br>3 - Текст.|
|***Base color***<br>(обязательно)|1|columns.base_color.0|Шестнадцатеричный код цвета (например, `FF0000`).|

[comment]: # ({/4f32414f-5321700b})

[comment]: # ({fb080973-931aceef})
##### Значение элемента

Следующие параметры поддерживаются, если для параметра *Data* установлено значение «Значение элемента».

::: noteclassic
Первое число в имени свойства *Thresholds* (например, columnsthresholds.color.0.0) указывает на столбец, для которого настроены пороговые значения, а второе число указывает на пороговое место в списке, отсортированном по возрастанию.
Однако, если пороговые значения настроены в другом порядке, значения будут отсортированы по возрастанию после обновления конфигурации виджета в интерфейсе Zabbix.
(например, `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold. 1": "5"`).
:::

|Параметр|<|[тип](/manual/api/reference/dashboard/object#dashboard-widget-field)|имя|значение|
|-|--------|--|--------|-------------------------------|
|*Элемент*|<|1 |columns.item.0|Действительное имя элемента.|
|***Сдвиг по времени***<br>(обязательно)|<|1|columns.timeshift.0|Действительное числовое или строковое значение времени (например, `3600` или `1h`).<br>Вы можете использовать [суффиксы времени](/manual/appendix/suffixes#time-suffixes). Допускаются отрицательные значения.|
|*Функция агрегации*|<|0|columns.aggregate_function.0|0 - *(по умолчанию)* нет;<br>1 - мин;<br>2 - макс;<br>3 - среднее;<br>4 - счет;<br>5 - сумма;<br>6 - первый;<br>7 - последний.|
|*Интервал агрегации*|<|1|columns.aggregate_interval.0|Действительная строка времени (например, `3600`, `1h` и т. д.).<br>Вы можете использовать [суффиксы времени](/manual/appendix/suffixes #time-suffixes).<br><br>Параметр *Интервал агрегации* недоступен, если для *Функция агрегации* установлено значение *none*.<br><br>По умолчанию: `1h`.|
|*Отображение*|<|0|columns.display.0|1 - *(по умолчанию)* Как есть;<br>2 - Столбцы;<br>3 - Индикаторы.|
|*Min*|<|1|columns.min.0|Любое числовое значение.<br><br>Параметр *Min* недоступен, если для *Отображение* установлено значение «Как есть».|
|*Max*|<|1|columns.max.0|Любое числовое значение.<br><br>Параметр *Max* недоступен, если для *Отображение* установлено значение «Как есть».|
|*Данные истории*|<|0|columns.history.0|1 - *(по умолчанию)* Авто;<br>2 - История;<br>3 - Динамика изменений.|
|*Пороги*|<|<|<|<|
|<|*Цвет*|1|columnsthresholds.color.0.0|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>По умолчанию: `""` (пусто).|
|^|*Порог*|1|columnsthresholds.threshold.0.0|Любое строковое значение.|

[comment]: # ({/fb080973-931aceef})

[comment]: # ({9b7919cb-108ba0d5})
##### Текст

Следующие параметры поддерживаются, если для параметра *Data* установлено значение "Текст".

|Параметр|[тип](/manual/api/reference/dashboard/object#поле-виджета-панели)|имя|значение|
|-----|-|-----|-------------------|
|*Text*|1|columns.text.0|Любое строковое значение, включая макросы.<br>Поддерживаемые макросы: {HOST.\*}, {INVENTORY.\*}.<br><br>Параметр *Text* требуется, если для параметра *Data* установлено значение "Текст".|

[comment]: # ({/9b7919cb-108ba0d5})

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

Следующие примеры предназначены только для описания конфигурации объектов полей виджета информационной панели для виджета *Топ узлов сети*.
Для получения дополнительной информации о настройке информационной панели см. [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({new-f6735ae7})
#### Configuring a *Top hosts* widget

Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4".
In addition, configure the following custom columns: "Host name", "Utilization", "1m avg", "5m avg", "15m avg", "Processes".

Request:

```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": 12,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids",
                                "value": 4
                            },
                            {
                                "type": 1,
                                "name": "columns.name.0",
                                "value": ""
                            },
                            {
                                "type": 0,
                                "name": "columns.data.0",
                                "value": 2
                            },
                            {
                                "type": 1,
                                "name": "columns.base_color.0",
                                "value": "FFFFFF"
                            },
                            {
                                "type": 1,
                                "name": "columns.timeshift.0",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "columns.item.0",
                                "value": "System name"
                            },
                            {
                                "type": 1,
                                "name": "columns.name.1",
                                "value": "Utilization"
                            },
                            {
                                "type": 0,
                                "name": "columns.data.1",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "columns.base_color.1",
                                "value": "4CAF50"
                            },
                            {
                                "type": 1,
                                "name": "columns.timeshift.1",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "columns.item.1",
                                "value": "CPU utilization"
                            },
                            {
                                "type": 0,
                                "name": "columns.display.1",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "columns.min.1",
                                "value": "0"
                            },
                            {
                                "type": 1,
                                "name": "columns.max.1",
                                "value": "100"
                            },
                            {
                                "type": 1,
                                "name": "columnsthresholds.color.1.0",
                                "value": "FFFF00"
                            },
                            {
                                "type": 1,
                                "name": "columnsthresholds.threshold.1.0",
                                "value": "50"
                            },
                            {
                                "type": 1,
                                "name": "columnsthresholds.color.1.1",
                                "value": "FF8000"
                            },
                            {
                                "type": 1,
                                "name": "columnsthresholds.threshold.1.1",
                                "value": "80"
                            },
                            {
                                "type": 1,
                                "name": "columnsthresholds.color.1.2",
                                "value": "FF4000"
                            },
                            {
                                "type": 1,
                                "name": "columnsthresholds.threshold.1.2",
                                "value": "90"
                            },
                            {
                                "type": 1,
                                "name": "columns.name.2",
                                "value": "1m avg"
                            },
                            {
                                "type": 0,
                                "name": "columns.data.2",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "columns.base_color.2",
                                "value": "FFFFFF"
                            },
                            {
                                "type": 1,
                                "name": "columns.timeshift.2",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "columns.item.2",
                                "value": "Load average (1m avg)"
                            },
                            {
                                "type": 1,
                                "name": "columns.name.3",
                                "value": "5m avg"
                            },
                            {
                                "type": 0,
                                "name": "columns.data.3",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "columns.base_color.3",
                                "value": "FFFFFF"
                            },
                            {
                                "type": 1,
                                "name": "columns.timeshift.3",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "columns.item.3",
                                "value": "Load average (5m avg)"
                            },
                            {
                                "type": 1,
                                "name": "columns.name.4",
                                "value": "15m avg"
                            },
                            {
                                "type": 0,
                                "name": "columns.data.4",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "columns.base_color.4",
                                "value": "FFFFFF"
                            },
                            {
                                "type": 1,
                                "name": "columns.timeshift.4",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "columns.item.4",
                                "value": "Load average (15m avg)"
                            },
                            {
                                "type": 1,
                                "name": "columns.name.5",
                                "value": "Processes"
                            },
                            {
                                "type": 0,
                                "name": "columns.data.5",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "columns.base_color.5",
                                "value": "FFFFFF"
                            },
                            {
                                "type": 1,
                                "name": "columns.timeshift.5",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "columns.item.5",
                                "value": "Number of processes"
                            },
                            {
                                "type": 0,
                                "name": "column",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

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

[comment]: # ({/new-f6735ae7})

[comment]: # ({e9d30322-a8f0e2bb})
### Смотрите также

- [Поле виджета панели](/manual/api/reference/dashboard/object#поле-виджета-панели)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

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