[comment]: # ({093ad1f3-522e6f46})
# 3. Обзор данных

[comment]: # ({/093ad1f3-522e6f46})

[comment]: # ({77f1ca42-ae03fe60})
:::noteimportant
Этот виджет устарел и будет удалён в предстоящем крупном выпуске.
Рассмотрите возможность использования вместо него виджета [*Топ узлов сети*](/manual/api/reference/dashboard/widget_fields/top_hosts).
:::

[comment]: # ({/77f1ca42-ae03fe60})

[comment]: # ({4d8585e6-10fd6f8e})
### Описание

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

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

[comment]: # ({/4d8585e6-10fd6f8e})

[comment]: # ({e34a2a70-d1871136})
### Параметры

Следующие параметры поддерживаются для виджета *Data overview*.

|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|ID [группы узлов сети](/manual/api/reference/hostgroup/get).<br><br>Примечание: чтобы настроить несколько групп узлов сети, создайте объект поля виджета панели для каждой группы узлов сети, увеличивая номер в имени свойства.<br><br>Этот параметр не поддерживается при настройке виджета на [шаблонной панели](/manual/api/reference/templatedashboard/object).|
|<|*Host groups (Widget)*|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).|
|*Hosts*|<|3|hostids.0|ID [узла сети](/manual/api/reference/host/get).<br><br>Примечание: чтобы настроить несколько узлов сети, создайте объект поля виджета панели для каждого узла сети, увеличивая номер в имени свойства. Для нескольких узлов сети параметр *Host groups* должен либо не быть настроен вовсе, либо быть настроен как минимум с одной группой узлов сети, к которой принадлежат настроенные узлы сети.<br><br>Этот параметр не поддерживается при настройке виджета на [шаблонной панели](/manual/api/reference/templatedashboard/object).|
|<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Вместо ID [узла сети](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - задайте [селектор *Host*](/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).|
|*Item tags*|<|<|<|<|
|<|*Evaluation type*|0|evaltype|0 - *(по умолчанию)* И/ИЛИ;<br>2 - ИЛИ.|
|^|*Tag name*|1|tags.0.tag|Любое строковое значение.<br><br>Примечание: номер в имени свойства соответствует порядку тега в списке оценки тегов.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если настраивается *Item tags*|
|^|*Operator*|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>- *required* если настраивается *Item tags*|
|^|*Tag value*|1|tags.0.value|Любое строковое значение.<br><br>Примечание: номер в имени свойства соответствует порядку тега в списке оценки тегов.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если настраивается *Item tags*|
|*Show suppressed problems*|<|0|show_suppressed|0 - *(по умолчанию)* Отключено;<br>1 - Включено.|
|*Hosts location*|<|0|style|0 - *(по умолчанию)* Слева;<br>1 - Сверху.|

[comment]: # ({/e34a2a70-d1871136})

[comment]: # ({7663ef93-9f13be38})
### Примеры

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

[comment]: # ({/7663ef93-9f13be38})

[comment]: # ({01f5fe22-afab3ffb})
#### Настройка виджета *Data overview*

Настройте виджет *Data overview*, который отображает данные для узла сети "10084" и только для элементов данных, у которых тег с именем "component" содержит значение "cpu".
Кроме того, отображайте данные с узлами сети в верхней части.

[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": "dataover",
                        "name": "Data overview",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "cpu"
                            },
                            {
                                "type": 0,
                                "name": "style",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Response:

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

[comment]: # ({/01f5fe22-afab3ffb})

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

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

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