Documentation
Table of Contents
12 Item value
Overview
This widget is useful for displaying the value of a single item prominently.
Besides the value itself, additional elements can be displayed, if desired:
- time of the metric
- item description
- change indicator for the value
- item unit
The widget can display numeric and string values. String values are displayed on a single line and truncated, if needed. "No data" is displayed, if there is no value for the item.
Clicking on the value leads to an ad-hoc graph for numeric items or latest data for string items.
The widget and all elements in it can be visually fine-tuned using advanced configuration options, allowing to create a wide variety of visual styles:
Configuration
To configure, select Item value as the widget type:
In addition to the parameters that are common for all widgets, you may set the following specific options:
| Item | Select the item. |
| Show | Mark the checkbox to display the respective element (description, value, time, change indicator). Unmark to hide. At least one element must be selected. |
| Advanced configuration | Mark the checkbox to display advanced configuration options. |
| Dynamic item | Mark the checkbox to display a different value depending on the selected host. |
Advanced configuration
Advanced configuration options become available if the Advanced configuration checkbox is marked (see screenshot) and only for those elements that are selected in the Show field (see above).
Additionally, advanced configuration allows to change the background color for the whole widget.
| 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. |
| Horizontal position | Select horizontal position of the item description - left, right or center. |
| Vertical position | Select vertical position of the item description - top, bottom or middle. |
| Size | Enter font size height for the item description (in percent relative to total widget height). |
| Bold | Mark the checkbox to display item description in bold type. |
| Color | Select the item description color from the color picker.D stands for default color (depends on the frontend theme). To return to the default value, click the Use default button in the color picker. |
| Value | |
| Decimal places | Select how many decimal places will be displayed with the value. This value will affect only float items. |
| Size | Enter font size height for the decimal places (in percent relative to total widget height). |
| Horizontal position | Select horizontal position of the item value - left, right or center. |
| Vertical position | Select vertical position of the item value - top, bottom or middle. |
| Size | Enter font size height for the item value (in percent relative to total widget height). Note that the size of item value is prioritised; other elements have to concede space for the value. With the change indicator though, if the value is too large, it will be truncated to show the change indicator. |
| Bold | Mark the checkbox to display item value in bold type. |
| Color | Select the item value color from the color picker.D stands for default color (depends on the frontend theme). To return to the default value, click the Use default button in the color picker. |
| Units | Mark the checkbox to display units with the item value. If you enter a unit name, it will override the unit from item configuration. |
| Position | Select the item unit position - above, below, before or after the value. |
| Size | Enter font size height for the item unit (in percent relative to total widget height). |
| Bold | Mark the checkbox to display item unit in bold type. |
| Color | Select the item unit color from the color picker.D stands for default color (depends on the frontend theme). To return to the default value, click the Use default button in the color picker. |
| Time | Time is the clock value from item history. |
| Horizontal position | Select horizontal position of the time - left, right or center. |
| Vertical position | Select vertical position of the time - top, bottom or middle. |
| Size | Enter font size height for the time (in percent relative to total widget height). |
| Bold | Mark the checkbox to display time in bold type. |
| Color | Select the time color from the color picker.D stands for default color (depends on the frontend theme). To return to the default value, click the Use default button in the color picker. |
| Change indicator | Select the color of change indicators from the color picker. The change indicators are as follows: ↑ - item value is up (for numeric items) ↓ - item value is down (for numeric items) ↕ - item value has changed (for string items and items with value mapping) D stands for default color (depends on the frontend theme). To return to the default value, click the Use default button in the color picker.Vertical size of the change indicator is equal to the size of the value (integer part of the value for numeric items). Note that up and down indicators are not shown with just one value. |
| Background color | Select the background color for the whole widget from the color picker.D stands for default color (depends on the frontend theme). To return to the default value, click the Use default button in the color picker. |
Note that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed.