Documentation
Table of Contents
7. Радиальный датчик
Обзор
Радиальный датчик отображает значение отдельного элемента данных в виде шкалы спидометра.
После настройки виджет может состоять из следующих элементов:
- Описание элемента данных (например, «Утилизация процессора (CPU utilization)» или «Скорость (Speed)»)
- Значение элемента данных (например, «30.70» или «19.80»)
- Единицы измерения элемента данных (например, «%» или «км/ч (km/h)»)
- Масштаб шкалы (например, «0%/100%» или «0/100/180/200»)
- Дуга шкалы (дуга значения и дуга пороговых значений датчика)
- Стрелка шкалы
Визуальную настройку виджета можно выполнить с помощью параметров расширенной настройки, что позволяет создавать самые разнообразные визуальные стили:
Радиальный датчик может отображать только числовые значения. Отображение бинарных значений не поддерживается.
Нажатие на виджет радиального датчика приводит к отображению графика для соответствующего элемента данных.
Настройка
Для настройки выберите Радиальный датчик (Gauge) в качестве типа:
В дополнение к параметрам, которые являются общими для всех виджетов, вы можете выставить следующие специфичные опции:
| Элемент данных (Item) |
Выберите элемент данных. В качестве альтернативы выберите для элементов данных в качестве источника данных совместимый виджет. Это поле с функцией автодополнения; таким образом, после начала ввода имени элемента данных будет автоматически предложен список совпадающих элементов данных в выпадающем меню. Обратите внимание, что вы можете выбрать только элементы данных, которые возвращают числовые значения. |
| Мин (Min) |
Введите минимальное значение шкалы. Поддерживаются суффиксы (например, «1d», «2w», «4K», «8G»). Поддерживаются преобразования значений. |
| Макс (Max) |
Введите максимальное значение шкалы. Поддерживаются суффиксы (например, «1d», «2w», «4K», «8G»). Поддерживаются преобразования значений. |
| Цвета (Colors) |
Выберите цвет из палитры: Значение дуги (Value arc) — выберите цвет дуги значений радиального датчика; Фон дуги (Arc background) — выберите цвет фона дуги значений и дуги пороговых значений радиального датчика; Фон (Background) — выберите цвет фона радиального датчика. «D» обозначает цвет по умолчанию, который зависит от темы веб-интерфейса. Если заданы Пороги (Thresholds), цвет по умолчанию для Значения дуги (Value arc) зависит от цвета порога. Чтобы вернуться к цвету по умолчанию, нажмите кнопку Использовать умолчание (Use default) в палитре. |
| Показать (Show) |
Отметьте флажок для отображения соответствующего элемента радиального датчика — описание (description), значение (value), дага значений (value arc), стрелка (needle), шкала (scale) (минимальное и максимальное значение радиального датчика в начале и в конце дуги значений). Снимите флажок, чтобы скрыть. Должен быть выбран хотя бы один элемент. Обратите внимание, что стрелка и шкала радиального датчика могут отображаться, если отображается дуга значений или дуга пороговых значений (смотрите опции расширенной настройки). Также обратите внимание, что если отображается стрелка радиального датчика, значение располагается под стрелкой; если же стрелка скрыта, значение выравнивается по нижнему краю дуги. |
| Переопределение узла сети (Override host) |
Выберите для узла сети в качестве источника данных совместимый виджет или панель. Этот параметр недоступен при настройке виджета на панели шаблона. |
| Расширенная настройка (Advanced configuration) |
Нажмите на надпись Расширенная настройка (Advanced configuration) для отображения опций расширенной настройки. Здесь же вы сможете настроить элементы радиального датчика, выбранные в поле Показать (Show). |
Advanced configuration
Advanced configuration options are available in the collapsible Advanced configuration section.
| Angle | Select the gauge angle (180° or 270°). |
| Description | |
| Description | Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible. {HOST.*}, {ITEM.*}, {INVENTORY.*} and user macros are supported. |
| Size | Enter the font size height for the item description (in percent, relative to the total widget height). |
| Vertical position | Select the vertical position of the item description (top or bottom, relative to the gauge arc). |
| Bold | Mark the checkbox to display the item description in bold. |
| Color | Select the item description color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Value | |
| Decimal places | Enter the number of decimal places to display with the value. This option affects only items that return numeric (float) data. |
| Size | Enter the font size height for the value (in percent, relative to the gauge arc height). |
| Bold | Mark the checkbox to display the value in bold. |
| Color | Select the value color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Arc | Mark the checkbox to display the gauge value arc. |
| Arc size | Enter the size height of the gauge value arc (in percent, relative to the gauge arc radius). |
| Units | |
| Units | Mark the checkbox to display units with the item value. If you enter a unit name, it will override the units set in the item configuration. |
| Size | Enter the font size height for the item units (in percent, relative to the gauge arc height). |
| Bold | Mark the checkbox to display item units in bold. |
| Position | Select the position of the item units (above, below, before or after, relative to the item value). This option is ignored for the following time-related units: unixtime, uptime, s. |
| Color | Select the item units color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Needle | |
| Needle | Mark the checkbox to display the gauge needle. If the needle is displayed, the value is placed under the needle; if the needle is hidden, the value is aligned with the bottom of the gauge arc. |
| Color | Select the gauge needle color from the color picker. "D" stands for the default color; if Thresholds are not set, the default color depends on the frontend theme; if Thresholds are set, the default color depends on the threshold color. To return to the default value, click the Use default button in the color picker. |
| Scale | |
| Scale | Mark the checkbox to display the minimum and maximum value of the gauge at the beginning and end of the gauge scale. |
| Show units | Mark the checkbox to display units with the minimum and maximum value of the gauge. |
| Size | Enter the font size height for the minimum and maximum value of the gauge (in percent, relative to the gauge arc height). |
| Decimal places | Enter the number of decimal places to display with the minimum and maximum value of the gauge. This option affects only items that return numeric (float) data. |
| Thresholds | |
| Thresholds | Click Add to add a threshold, select a threshold color from the color picker, and specify a numeric value. The thresholds list will be sorted in ascending order when saved. Note that the colors configured as thresholds will be displayed correctly only for numeric items. Suffixes (for example, "1d", "2w", "4K", "8G") are supported. Value mappings are supported. |
| Show labels | Mark the checkbox to display threshold values as labels on the gauge scale. |
| Show arc | Mark the checkbox to display the gauge thresholds arc. |
| Arc size | Enter the size height of the gauge thresholds arc (in percent, relative to the gauge arc radius). |
The information displayed by the gauge widget can be downloaded as a .png image using the widget menu.
A screenshot of the widget will be saved to the Downloads folder.