Эти параметры и возможные значения свойств для соответствующих объектов полей виджета позволяют настраивать виджет Honeycomb в методах dashboard.create и dashboard.update.

Свойства fields виджета не проверяются при создании или обновлении панели. Это позволяет пользователям изменять встроенные виджеты и создавать пользовательские виджеты, но также создает риск некорректного создания или обновления виджетов. Чтобы обеспечить успешное создание или обновление виджета Honeycomb, ознакомьтесь с поведением параметров, описанным в таблицах ниже.

Параметры

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

Параметр		type	name	value
Интервал обновления		0	rf_rate	0 - Без обновления; 10 - 10 секунд; 30 - 30 секунд; 60 - (по умолчанию) 1 минута; 120 - 2 минуты; 600 - 10 минут; 900 - 15 минут.
Группы узлов сети		2	groupids.0	ID группы узлов сети. Примечание: Чтобы настроить несколько групп узлов сети, создайте объект поля виджета панели с увеличивающимся номером в имени свойства для каждой группы узлов сети. Этот параметр не поддерживается при настройке виджета на панели шаблона.
	Группы узлов сети (Виджет)	1	groupids._reference	Вместо ID группы узлов сети: `ABCDE._hostgroupids` — укажите совместимый виджет (с параметром Reference, установленным в "`ABCDE`") в качестве источника данных для групп узлов сети. Этот параметр не поддерживается при настройке виджета на панели шаблона.
Узлы сети		3	hostids.0	ID узла сети. Примечание: Чтобы настроить несколько узлов сети, создайте объект поля виджета панели с увеличивающимся номером в имени свойства для каждого узла сети. Для нескольких узлов сети параметр Группы узлов сети либо не должен быть настроен вовсе, либо должен быть настроен как минимум с одной группой узлов сети, к которой принадлежат настроенные узлы сети. Этот параметр не поддерживается при настройке виджета на панели шаблона.
	Узлы сети (Виджет/Панель)	1	hostids._reference	Вместо ID узла сети: `DASHBOARD.hostids` — укажите селектор узлов сети панели в качестве источника данных для узлов сети; `ABCDE._hostids` — укажите совместимый виджет (с параметром Reference, установленным в "`ABCDE`") в качестве источника данных для узлов сети. Этот параметр не поддерживается при настройке виджета на панели шаблона.
Теги узлов сети
	Тип вычисления	0	evaltype_host	0 - (по умолчанию) И/Или; 2 - Или. Этот параметр не поддерживается при настройке виджета на панели шаблона.
	Имя тега	1	host_tags.0.tag	Любое строковое значение. Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов. Поведение параметра: - обязательно при настройке Тегов узлов сети Этот параметр не поддерживается при настройке виджета на панели шаблона.
	Оператор	0	host_tags.0.operator	0 - Содержит; 1 - Равно; 2 - Не содержит; 3 - Не равно; 4 - Существует; 5 - Не существует. Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов. Поведение параметра: - обязательно при настройке Тегов узлов сети Этот параметр не поддерживается при настройке виджета на панели шаблона.
	Значение тега	1	host_tags.0.value	Любое строковое значение. Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов. Поведение параметра: - обязательно при настройке Тегов узлов сети Этот параметр не поддерживается при настройке виджета на панели шаблона.
Шаблоны элементов данных		1	items.0	Имя или шаблон элемента данных. Примечание: Чтобы настроить несколько шаблонов элементов данных, создайте объект поля виджета панели с увеличивающимся номером в имени свойства для каждого шаблона элемента данных. Поведение параметра: - обязательно
Теги элементов данных
	Тип вычисления	0	evaltype_item	0 - (по умолчанию) И/Или; 2 - Или.
	Имя тега	1	item_tags.0.tag	Любое строковое значение. Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов. Поведение параметра: - обязательно при настройке Тегов элементов данных
	Оператор	0	item_tags.0.operator	0 - Содержит; 1 - Равно; 2 - Не содержит; 3 - Не равно; 4 - Существует; 5 - Не существует. Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов. Поведение параметра: - обязательно при настройке Тегов элементов данных
	Значение тега	1	item_tags.0.value	Любое строковое значение. Примечание: Число в имени свойства указывает порядок тега в списке вычисления тегов. Поведение параметра: - обязательно при настройке Тегов элементов данных
Показывать узлы сети в обслуживании		0	maintenance	0 - (по умолчанию) Отключено; 1 - Включено.
Показывать		0	show.0	1 - Основная метка; 2 - Дополнительная метка. Примечание: Чтобы настроить несколько значений, создайте объект поля виджета панели с увеличивающимся номером в имени свойства для каждого значения. По умолчанию: 1, 2.
Reference		1	reference	Любое строковое значение, состоящее из 5 символов (например, `ABCDE` или `JBPNL`). Это значение должно быть уникальным в пределах панели, к которой принадлежит виджет. Поведение параметра: - обязательно

Расширенная конфигурация

Для виджета Honeycomb поддерживаются следующие параметры расширенной конфигурации.

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

Параметр	type	name	value
*Основная метка*
Тип	0	primary_label_type	0 - (по умолчанию) Текст; 1 - Значение.
Текст	1	primary_label	Любое строковое значение, включая макросы. Поддерживаемые макросы: {HOST.}, {ITEM.}, {INVENTORY.}, пользовательские макросы. По умолчанию: {HOST.NAME} Поведение параметра: - поддерживается, если Тип* установлен в "Текст"
Десятичные знаки	0	primary_label_decimal_places	Допустимые значения: от 0 до 6. По умолчанию: 2. Поведение параметра: - поддерживается, если Тип установлен в "Значение"
Размер (тип)	0	primary_label_size_type	0 - (по умолчанию) Авто; 1 - Пользовательский.
Размер	0	primary_label_size	Допустимые значения: от 1 до 100. По умолчанию: 20. Поведение параметра: - поддерживается, если Размер (тип) установлен в "Пользовательский"
Жирный	0	primary_label_bold	0 - (по умолчанию) Отключено; 1 - Включено.
Цвет	1	primary_label_color	Шестнадцатеричный код цвета (например, `FF0000`). По умолчанию: зависит от `theme` объекта Settings object и User object: `1F2C33` для "blue-theme", "blue-classic-theme" или "hc-light"; `EEEEEE` для "dark-theme", "dark-classic-theme" или "hc-dark".
Единицы (флажок)	0	primary_label_units_show	0 - Отключено; 1 - (по умолчанию) Включено. Поведение параметра: - поддерживается, если Тип установлен в "Значение"
Единицы (значение)	1	primary_label_units	Любое строковое значение. `""` (пусто) Поведение параметра: - поддерживается, если Тип установлен в "Значение" и Единицы (флажок) установлены в "Включено"
Положение	0	primary_label_units_pos	0 - Перед значением; 1 - (по умолчанию) После значения. Поведение параметра: - поддерживается, если Тип установлен в "Значение" и Единицы (флажок) установлены в "Включено" Этот параметр игнорируется, если задана одна из следующих единиц измерения, связанных со временем: unixtime, uptime, s.
*Дополнительная метка*
Тип	0	secondary_label_type	0 - Текст; 1 - (по умолчанию) Значение.
Текст	1	secondary_label	Любое строковое значение, включая макросы. Поддерживаемые макросы: {HOST.}, {ITEM.}, {INVENTORY.}, пользовательские макросы. По умолчанию: {{ITEM.LASTVALUE}.fmtnum(2)} Поведение параметра: - поддерживается, если Тип* установлен в "Текст"
Десятичные знаки	0	secondary_label_decimal_places	Допустимые значения: от 0 до 6. По умолчанию: 2. Поведение параметра: - поддерживается, если Тип установлен в "Значение"
Размер (тип)	0	secondary_label_size_type	0 - (по умолчанию) Авто; 1 - Пользовательский.
Размер	0	secondary_label_size	Допустимые значения: от 1 до 100. По умолчанию: 30. Поведение параметра: - поддерживается, если Размер (тип) установлен в "Пользовательский"
Жирный	0	secondary_label_bold	0 - Отключено; 1 - (по умолчанию) Включено.
Цвет	1	secondary_label_color	Шестнадцатеричный код цвета (например, `FF0000`). По умолчанию: зависит от `theme` объекта Settings object и User object: `1F2C33` для "blue-theme", "blue-classic-theme" или "hc-light"; `EEEEEE` для "dark-theme", "dark-classic-theme" или "hc-dark".
Единицы (флажок)	0	secondary_label_units_show	0 - Отключено; 1 - (по умолчанию) Включено. Поведение параметра: - поддерживается, если Тип установлен в "Значение"
Единицы (значение)	1	secondary_label_units	Любое строковое значение. `""` (пусто) Поведение параметра: - поддерживается, если Тип установлен в "Значение" и Единицы (флажок) установлены в "Включено"
Положение	0	secondary_label_position	0 - Перед значением; 1 - (по умолчанию) После значения. Поведение параметра: - поддерживается, если Тип установлен в "Значение" и Единицы (флажок) установлены в "Включено" Этот параметр игнорируется, если задана одна из следующих единиц измерения, связанных со временем: unixtime, uptime, s.
*Цвет фона*
Цвет фона	1	bg_color	Шестнадцатеричный код цвета (например, `FF0000`). По умолчанию: зависит от `theme` объекта Settings object и User object: `D9E7ED` для "blue-theme" и "blue-classic-theme"; `3D5059` для "dark-theme" и "dark-classic-theme"; `AAD7E9` для "hc-light"; `335463` для "hc-dark".
*Пороги*
Интерполяция цвета	0	interpolation	0 - Отключено; 1 - (по умолчанию) Включено.
Цвет	1	thresholds.0.color	Шестнадцатеричный код цвета (например, `FF0000`).
Порог	1	thresholds.0.threshold	Любое числовое значение. Поддерживаются суффиксы (например, "1d", "2w", "4K", "8G").

Примеры

Следующие примеры предназначены только для описания конфигурации объектов полей виджета панели мониторинга для виджета Honeycomb. Для получения дополнительной информации о настройке панели мониторинга см. dashboard.create.

Настройка виджета Honeycomb

Настройте виджет Honeycomb, отображающий использование процессов сервера Zabbix. Кроме того, измените основную метку ячеек honeycomb и визуально донастройте виджет с помощью порогов.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": "30",
        "auto_start": "1",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "honeycomb",
                        "name": "Honeycomb",
                        "x": "0",
                        "y": "0",
                        "width": "24",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "items.0",
                                "value": "Zabbix server: Utilization*"
                            },
                            {
                                "type": 1,
                                "name": "primary_label",
                                "value": "{ITEM.NAME}"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.color",
                                "value": "0EC9AC"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.threshold",
                                "value": "0"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.color",
                                "value": "FFD54F"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.threshold",
                                "value": "70"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.color",
                                "value": "FF465C"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.threshold",
                                "value": "90"
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "KSTMQ"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Ответ:

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

Смотрите также

What’s next?

12. Доступность узла сети

Docs

11. Ячеистая диаграмма

Описание

Параметры

Расширенная конфигурация

Примеры

Настройка виджета Honeycomb

Смотрите также

What’s next?

Suggest edit

Suggest an example

Thank you!