[comment]: # ({8c8dd5c7-978cbb20})
# 28 Популярные узлы сети

[comment]: # ({/8c8dd5c7-978cbb20})

[comment]: # ({4e99026f-c5138763})
### Описание

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

::: noteimportant
Свойства `fields` виджета не проверяются при создании или обновлении панели.
Это позволяет пользователям изменять [встроенные виджеты](/manual/web_interface/frontend_sections/dashboards/widgets) и создавать [пользовательские виджеты](/devel/modules/tutorials/widget), но также создает риск некорректного создания или обновления виджетов.
Чтобы обеспечить успешное создание или обновление виджета *Top hosts*, ознакомьтесь с поведением параметров, описанным в таблицах ниже.
:::

[comment]: # ({/4e99026f-c5138763})

[comment]: # ({6c1cb502-224c01f4})
### Параметры

Для виджета *Топ узлов сети* поддерживаются следующие параметры.

|Параметр|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Интервал обновления*|<|0|rf_rate|0 - Без обновления;<br>10 - 10 секунд;<br>30 - 30 секунд;<br>60 - *(по умолчанию)* 1 минута;<br>120 - 2 минуты;<br>600 - 10 минут;<br>900 - 15 минут.|
|*Группы узлов сети*|<|2|groupids.0|ID [группы узлов сети](/manual/api/reference/hostgroup/get).<br><br>Примечание: Чтобы настроить несколько групп узлов сети, создайте объект поля виджета панели с увеличивающимся номером в имени свойства для каждой группы узлов сети.<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|<|*Группы узлов сети (Виджет)*|1|groupids.\_reference|Вместо ID [группы узлов сети](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` — укажите [совместимый виджет](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (с параметром *Reference*, установленным в "`ABCDE`") в качестве источника данных для групп узлов сети.<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|*Узлы сети*|<|3|hostids.0|ID [узла сети](/manual/api/reference/host/get).<br><br>Примечание: Чтобы настроить несколько узлов сети, создайте объект поля виджета панели с увеличивающимся номером в имени свойства для каждого узла сети. Для нескольких узлов сети параметр *Группы узлов сети* либо не должен быть настроен вовсе, либо должен быть настроен как минимум с одной группой узлов сети, к которой принадлежат указанные узлы сети.<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|<|*Узлы сети (Виджет/Панель)*|1|hostids.\_reference|Вместо ID [узла сети](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` — укажите [селектор узлов сети](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) панели в качестве источника данных для узлов сети;<br>`ABCDE._hostids` — укажите [совместимый виджет](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (с параметром *Reference*, установленным в "`ABCDE`") в качестве источника данных для узлов сети.<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|*Теги узлов сети*|<|<|<|<|
|<|*Тип вычисления*|0|evaltype|0 - *(по умолчанию)* И/Или;<br>2 - Или.<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|^|*Имя тега*|1|tags.0.tag|Любое строковое значение.<br><br>Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязательно* при настройке *Тегов узлов сети*<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|^|*Оператор*|0|tags.0.operator|0 - Содержит;<br>1 - Равно;<br>2 - Не содержит;<br>3 - Не равно;<br>4 - Существует;<br>5 - Не существует.<br><br>Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязательно* при настройке *Тегов узлов сети*<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|^|*Значение тега*|1|tags.0.value|Любое строковое значение.<br><br>Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязательно* при настройке *Тегов узлов сети*<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|
|*Показывать узлы сети на обслуживании*|<|0|maintenance|0 - *(по умолчанию)* Отключено;<br>1 - Включено.|
|*Столбцы* (см. ниже)|<|<|<|<|
|*Сортировать по*|<|0|column|Числовое значение столбца из настроенных столбцов.|
|*Порядок*|<|0|order|2 - *(по умолчанию)* Топ N;<br>3 - Нижние N.|
|*Лимит узлов сети*|<|0|show_lines|Возможные значения: от 1 до 1000.<br><br>По умолчанию: 10.<br><br>Этот параметр не поддерживается при настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object).|

[comment]: # ({/6c1cb502-224c01f4})

[comment]: # ({e8e68707-8266fc04})
#### Столбцы

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

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

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

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

|Параметр|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Имя*|1|columns.0.name|Любое строковое значение.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязательный*|
|*Данные*|0|columns.0.data|1 - Значение элемента данных;<br>2 - Имя узла сети;<br>3 - Текст.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязательный*|
|*Базовый цвет*|1|columns.0.base_color|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязательный*|

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

[comment]: # ({02077e27-5843843c})
##### Значение элемента данных

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

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

|Параметр|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Элемент данных*|<|1 |columns.0.item|Допустимое имя элемента данных.<br><br>При настройке виджета на [панели шаблона](/manual/api/reference/templatedashboard/object) следует указывать только элементы данных, настроенные в шаблоне.|
|*Отображать значение элемента данных как*|<|0|columns.0.display_value_as|0 - *(по умолчанию)* Числовое;<br>1 - Текст;<br>2 - Двоичное.|
|*Отображение*|<|0|columns.0.display|1 - *(по умолчанию)* Как есть;<br>2 - Полоса;<br>3 - Индикаторы;<br>6 - Спарклайн.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric"|
|*Мин*|<|1|columns.0.min|Любое числовое значение.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Bar" или "Indicators"|
|*Макс*|<|1|columns.0.max|Любое числовое значение.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Bar" или "Indicators"|
|*Десятичные знаки*|<|0|columns.0.decimal_places|Допустимые значения: 0-10.<br><br>По умолчанию: 2.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric"|
|*Спарклайн*|<|<|<|<|
|<|*Ширина*|0|columns.0.sparkline.width|Допустимые значения: 0-10.<br><br>По умолчанию: 1.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"|
|^|*Заполнение*|0|columns.0.sparkline.fill|Допустимые значения: 0-10.<br><br>По умолчанию: 3.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"|
|^|*Цвет*|1|columns.0.sparkline.color|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>По умолчанию: `42A5F5`.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"|
|^|*Период времени*|1|columns.0.sparkline.time_period.\_reference|`DASHBOARD._timeperiod` - использовать [селектор периода времени](/manual/web_interface/time_period_selector) панели как источник данных;<br>`ABCDE._timeperiod` - использовать [совместимый виджет](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (с параметром `reference`, равным `ABCDE`) как источник данных.<br><br>По умолчанию: `DASHBOARD._timeperiod`<br><br>В качестве альтернативы можно задать период времени только в параметрах *От* и *До*.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"|
|^|*От*|1|columns.0.sparkline.time_period.from|Допустимая строка времени в абсолютном (`YYYY-MM-DD hh:mm:ss`) или [относительном](/manual/web_interface/time_period_selector) формате времени (`now`, `now/d`, `now/w-1w` и т. д.).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"<br>- *обязателен*, если задан `columns.0.sparkline.time_period.to`|
|^|*До*|1|columns.0.sparkline.time_period.to|Допустимая строка времени в абсолютном (`YYYY-MM-DD hh:mm:ss`) или [относительном](/manual/web_interface/time_period_selector) формате времени (`now`, `now/d`, `now/w-1w` и т. д.).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"<br>- *обязателен*, если задан `columns.0.sparkline.time_period.from`|
|^|*Исторические данные*|0|columns.0.sparkline.history|0 - *(по умолчанию)* Авто;<br>1 - History;<br>2 - Trends.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric" и для *Отображение* установлено значение "Sparkline"|
|*Пороги*|<|<|<|<|
|<|*Цвет*|1|columnsthresholds.0.color.0|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric"|
|^|*Порог*|1|columnsthresholds.0.threshold.0|Любое строковое значение.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric"|
|*Подсветка*|<|<|<|<|
|<|*Цвет*|1|columns.0.highlights.0.color|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Text"|
|^|*Шаблон*|1|columns.0.highlights.0.pattern|Любое строковое значение.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Text"|
|*Показывать миниатюру*|<|0|columns.0.show_thumbnail|0 - *(по умолчанию)* Отключено;<br>1 - Включено.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Binary"|
|*Функция агрегации*|<|0|columns.0.aggregate_function|0 - *(по умолчанию)* не используется;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.|
|*Период времени*|<|1|columns.0.time_period.\_reference|`DASHBOARD._timeperiod` - использовать [селектор периода времени](/manual/web_interface/time_period_selector) панели как источник данных;<br>`ABCDE._timeperiod` - использовать [совместимый виджет](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (с параметром `reference`, равным `ABCDE`) как источник данных.<br><br>По умолчанию: `DASHBOARD._timeperiod`<br><br>В качестве альтернативы можно задать период времени только в параметрах *От* и *До*.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Функция агрегации* установлено значение "min", "max", "avg", "count", "sum", "first", "last"|
|<|*От*|1|columns.0.time_period.from|Допустимая строка времени в абсолютном (`YYYY-MM-DD hh:mm:ss`) или [относительном](/manual/web_interface/time_period_selector) формате времени (`now`, `now/d`, `now/w-1w` и т. д.).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если *Период времени* не задан и для *Функция агрегации* установлено значение "min", "max", "avg", "count", "sum", "first", "last"<br>- *обязателен*, если задан `columns.0.time_period.to`|
|^|*До*|1|columns.0.time_period.to|Допустимая строка времени в абсолютном (`YYYY-MM-DD hh:mm:ss`) или [относительном](/manual/web_interface/time_period_selector) формате времени (`now`, `now/d`, `now/w-1w` и т. д.).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если *Период времени* не задан и для *Функция агрегации* установлено значение "min", "max", "avg", "count", "sum", "first", "last"<br>- *обязателен*, если задан `columns.0.time_period.from`|
|*Исторические данные*|<|0|columns.0.history|0 - *(по умолчанию)* Авто;<br>1 - History;<br>2 - Trends.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *поддерживается*, если для *Отображать значение элемента данных как* установлено значение "Numeric"|
|*Ссылка*|<|1|reference|Любое строковое значение, состоящее из 5 символов (например, `ABCDE` или `JBPNL`). Это значение должно быть уникальным в пределах панели, к которой принадлежит виджет.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обязателен*|

[comment]: # ({/02077e27-5843843c})

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

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

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

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

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

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

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

[comment]: # ({ec72cf7d-2e9b79c3})
#### Настройка виджета *Top hosts*

Настройте виджет *Top hosts*, который отображает верхние узлы сети по загрузке CPU в группе узлов сети "4".
Кроме того, настройте следующие пользовательские столбцы: "Имя узла сети", "Загрузка CPU в %", "Среднее за 1 мин", "Среднее за 5 мин", "Среднее за 15 мин", "Процессы".

[Запрос](/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})
### Смотрите также

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

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