[comment]: # ({bc57ee5e-d7fd49df})
# 29 Top items
[comment]: # ({/bc57ee5e-d7fd49df})
[comment]: # ({7e91dd99-1f72116e})
#### Overview
The *Top items* widget displays the top/bottom values for selected items, providing a quick overview of their performance.
{width="600"}
By default, the widget displays values from the last 24 hours.
This period can be changed in *Administration > General > [GUI](/manual/web_interface/frontend_sections/administration/general#gui)* (*Max history display period*).
Clicking the item value opens the [item menu](/manual/web_interface/menu/item_menu).
[comment]: # ({/7e91dd99-1f72116e})
[comment]: # ({18ae7ed4-6022ae25})
#### Configuration
To configure, select *Top items* as type:
{width="600"}
In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)
for all widgets, you may set the following specific options:
| | | |
|-|----------|--------------------------------------|
|*Host groups*|<|Select host groups.
Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.
This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.
This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).|
|*Hosts*|<|Select hosts.
Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.
This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts.
This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).|
|*Host tags*|<|Specify tags to limit the number of host data displayed in the widget.
It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.
There are several operators available for each condition:
**Exists** - include the specified tag names;
**Equals** - include the specified tag names and values (case-sensitive);
**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);
**Does not exist** - exclude the specified tag names;
**Does not equal** - exclude the specified tag names and values (case-sensitive);
**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).
There are two calculation types for conditions:
**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;
**Or** - enough if one condition is met.|
|*Layout*|<|Select the layout option:
**Horizontal** - host names will be displayed on the left;
**Vertical** - host names will be displayed at the top.|
|*Show problems*|<|Filter which problems to display based on their status (all, unsuppressed, none).
Problems are indicated with colored item values, overriding the item column display settings. Colors are based on problem severity, which can be customized in *Administration* > *General* > [*Trigger displaying options*](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options). Problem severities can be changed when [updating problems](/manual/acknowledgment#updating-problems).|
|*Items*|<|Add item patterns or specific items for display (see [Column configuration](#column-configuration)).|
|***Advanced configuration***|<|<|
|*Host ordering*|<|Select ordering options for the host column/row. |
| |*Order by*|Order hosts by:
**Host name** - hosts will be ordered by host name;
**Item value** - hosts will be ordered by the value of selected items. |
|^|*Order*|Select whether to display the highest or lowest values:
**TopN** - top N values;
**BottomN** - bottom N values.
The value of N is selected in the *Limit* field.|
|^|*Limit*|Enter limit for displayable hosts (range 1-1000; default 10).
This value will become the value of N in the *Order* field.|
|*Item ordering*|<|Select ordering options for the item column/row. |
| |*Order by*|Order items by:
**Item value** - items will be ordered by item value;
**Item name** - items will be ordered by item name;
**Host** - items will be ordered by the selected host pattern. |
|^|*Order*|Select whether to display the highest or lowest values:
**TopN** - top N values;
**BottomN** - bottom N values.
The value of N is selected in the *Limit* field.|
|^|*Limit*|Enter limit for displayable items (range 1-1000; default 10).
This value will become the value of N in the *Order* field.|
|*Show column header*|<|Select column header display options:
**Off** - do not display column header;
**Horizontal** - display text horizontally in the header;
**Vertical** - display text vertically in the header.|
[comment]: # ({/18ae7ed4-6022ae25})
[comment]: # ({6d82af06-d43c2a65})
#### Column configuration
To configure item columns, click *Add* in the *Items* parameter:
{width="600"}
Common column parameters:
| | |
|--|--------|
|*Item patterns*|Specify one or several item patterns, using the wildcard character.
Alternatively, select the items.
When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), only [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs) can be selected.|
|*Item tags*|Specify tags to limit the number of item data displayed in the widget.
It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.
There are several operators available for each condition:
**Exists** - include the specified tag names;
**Equals** - include the specified tag names and values (case-sensitive);
**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);
**Does not exist** - exclude the specified tag names;
**Does not equal** - exclude the specified tag names and values (case-sensitive);
**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).
There are two calculation types for conditions:
**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;
**Or** - enough if one condition is met.|
|*Base color*|Select the column's background color or fill color if *Display* is set to "Bar" or "Indicators".
Note that the base color can be overridden by threshold or highlight colors.|
|*Display value as*|Format for displaying the item value: **Numeric** or **Text**.
The selected option determines which additional parameters will be available. Refer to the parameter list for each format below. |
[comment]: # ({/6d82af06-d43c2a65})
[comment]: # ({6b911079-735d6d7c})
Column parameters for numeric values:
| | |
|--|--------|
|*Display*|Define how the value should be displayed:
**As is** - as regular text;
**Bar** - as solid, color-filled bar;
**Indicators** - as segmented, color-filled bar;
**Sparkline** - mini line graph.|
|*Min*|Minimum value for bar/indicators display.|
|*Max*|Maximum value for bar/indicators display.|
|*Width*|Set the graph line thickness by using the slider or manually entering a value in the range from 0 to 10.
This parameter is for sparkline display only.|
|*Fill*|Set fill color transparency level by using the slider or manually entering a value in the range from 0 to 10.
This parameter is for sparkline display only.|
|*Color*|Select line and fill color.
This parameter is for sparkline display only.|
|See *Advanced configuration* for description of fields related to time period and history data selection.|<|
|*Thresholds*|Specify threshold values when the background/fill color should change.
The list will be sorted in ascending order when saved.
For sparklines, thresholds are applied only to the item last value.|
|*Decimal places*|Specify how many decimal places will be displayed with the value.|
|***Advanced configuration***|<|
|*History data*|Take data from history or trends:
**Auto** - automatic selection;
**History** - take history data;
**Trends** - take trend data.
This parameter is available only for numeric item values. For text values data will always be taken from history.|
|*Aggregation function*|Specify which aggregation function to use within the selected *Time period*:
**min** - display the smallest value;
**max** - display the largest value;
**avg** - display the average value;
**count** - display the count of values;
**sum** - display the sum of values;
**first** - display the first value;
**last** - display the last value.
If **not used** is selected, the most recent value is displayed (no aggregation).
Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of the most recent value.
Only numeric data can be displayed for *min*, *max*, *avg* and *sum*. For *count*, non-numeric data will be changed to numeric.|
|*Time period*|Specify the time period to use for aggregating values. Select the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for the time period:
**Dashboard** - use the dashboard [time period selector](/manual/web_interface/time_period_selector);
**Widget** - use a compatible widget (set in the *Widget* parameter);
**Custom** - use a custom time period set in the *From* and *To* parameters; if set, a clock icon will be displayed in the upper-right corner of the widget, indicating the set time on mouseover.
Note that regardless of the widget's *Time period* configuration, compatible widgets can still use it as a data source for the time period.
This parameter is not available if *Aggregation function* is set to "not used".|
|*Widget*|Enter or select a compatible widget as the data source for the time period.
This parameter is available if *Time period* is set to "Widget".|
|*From*|Enter or select the start of the time period.
[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.
This parameter is available if *Time period* is set to "Custom".|
|*To*|Enter or select the end of the time period.
[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.
This parameter is available if *Time period* is set to "Custom".|
|*Aggregate columns*|When checked, group all items that match the column's item patterns into a single combined column/row. Values from matching items will be aggregated using the selected *Column aggregation function* and displayed under the *Combined column name*. Default: off (unchecked).This parameter is shown only when *Display value as* is **Numeric**.|
|*Column aggregation function*|Choose how values from the grouped item patterns are combined. Available options: **min**, **max**, **avg**, **count**, **sum** (default). This parameter is shown only when *Aggregate columns* is checked.|
|*Combined column name*|Enter the display name for the aggregated column. This field is mandatory when *Aggregate columns* is checked and becomes the column header for the combined values.|
Column parameters for text values:
| | |
|--|--------|
|*Highlights*|Specify the regular expressions upon matching which the background/fill color should change.|
[comment]: # ({/6b911079-735d6d7c})