[comment]: # translation:outdated [comment]: # ({new-d7fd49df}) # 27 Top items [comment]: # ({/new-d7fd49df}) [comment]: # ({new-1f72116e}) #### Overview In the *Top items* widget, you can display top (or bottom) values for a group of items. ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/top_items.png){width="600"} It is possible to select items directly or by pattern, customize column ordering and highlighting. The color of problem items is based on the problem severity color, which can be adjusted in the [problem update](/manual/acknowledgment#updating_problems) screen. By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of latest data. This limit is configurable in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, using the *Max history display period* option. Clicking on item value opens the [item menu](/manual/web_interface/menu/item_menu). [comment]: # ({/new-1f72116e}) [comment]: # ({new-6022ae25}) #### Configuration To configure, select *Top items* as type: ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/top_items_conf.png){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*|<|Select how to display problems:
**All** - display all problems;
**Unsuppressed** - only display problems that are not suppressed due to host mainteneance;
**None** - do not display problems at all.
*Note* that when a problem state is represented, it overrides the display style settings from item column configuration.| |*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-100; 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-100; 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]: # ({/new-6022ae25}) [comment]: # ({new-d43c2a65}) #### Column configuration To configure item columns, click *Add* in the *Items* parameter: ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/top_items_column.png){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]: # ({/new-d43c2a65}) [comment]: # ({new-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***|<| |*Aggregation function*|Specify which aggregation function to use:
**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;
**not used** - display the most recent value (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:
**Dashboard** - use time period of the dashboard;
**Widget** - use time period of the specified widget;
**Custom** - use a custom time period.
This parameter will not be displayed if *Aggregation function* is set to "not used". | |*Widget*|Select the widget.
This parameter will only be displayed if *Time period* is set to "Widget".| |*From*|Select the time period from (default value `now-1h`). See [relative time syntax](/manual/web_interface/time_period_selector).
This parameter will only be displayed if *Time period* is set to "Custom".| |*To*|Select the time period to (default value `now`). See [relative time syntax](/manual/web_interface/time_period_selector).
This parameter will only be displayed if *Time period* is set to "Custom".| |*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.| Column parameters for text values: | | | |--|--------| |*Highlights*|Specify the regular expressions upon matching which the background/fill color should change.| [comment]: # ({/new-735d6d7c})