Documentation
Table of Contents
14 Host navigator
Overview
The host navigator widget displays hosts based on various filtering and grouping options.
The widget also allows to control the information displayed in other widgets based on the selected host.
Groups by which hosts are organized can be expanded or collapsed.
For groups, problems, and hosts in maintenance, additional details are accessible by mouseover hints.
Configuration
To configure, select Host navigator as type:
In addition to the parameters that are common for all widgets, you may set the following specific options:
| Host groups | Select host groups. This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups. Selecting a parent host group implicitly selects all nested host groups; if no host groups are selected, the widget will display all hosts from all host groups. Alternatively, click the dropdown arrow (next to the Select button) to select a compatible widget (Host navigator) as the data source for host groups. This parameter is not available when configuring the widget on a template dashboard. |
| Hosts | Select hosts. This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts. If no hosts are selected, the widget will display all hosts. This parameter is not available when configuring the widget on a template dashboard. |
| Host status | Filter which hosts to display based on their status (any, enabled, disabled). This parameter is not available when configuring the widget on a template dashboard. |
| Host tags | Specify tags to limit the number of hosts 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. This parameter is not available when configuring the widget on a template dashboard. |
| Severity | Mark which problem severities to display with the hosts in the widget. If no severities are marked, the widget will display all severities. |
| Show hosts in maintenance | Mark this checkbox to display hosts in maintenance (in this case, maintenance icon will be shown next to the host name). This parameter is labeled Show data in maintenance when configuring the widget on a template dashboard. |
| Show problems | Filter which problems to display with the hosts in the widget based on their status (all, unsuppressed, none). |
| Group by | Add a grouping attribute by which to group the selected hosts: Host group - group hosts by their host group; hosts belonging to multiple host groups will be displayed in all of them; Tag value - enter a tag name to group hosts by the values of this tag (for example, enter "City" to group hosts by values "Riga", "Tokyo", etc.); hosts without the specified tag will be displayed in the Uncategorized group; Severity - group hosts by their problem severities; for each severity group, only corresponding severity count is displayed; however, for each host, all its severity counts are displayed; hosts without problems will be displayed in the Uncategorized group. Grouping attributes can be reordered by dragging up or down by the handle before the group name. Note that grouping attribute order determines group nesting order. For example, specifying multiple tag names - 1: Color, 2: City - will result in hosts being grouped by color (Red, Blue, etc.) and then by city (Riga, Tokyo, etc.). Up to 10 grouping attributes can be specified, and all must be unique. If no grouping attributes are specified, hosts will not be grouped. |
| Host limit | Enter the maximum number of hosts to be displayed. Possible values range from 1-9999. When more hosts are available for displaying than the set limit, a corresponding message is shown below the displayed hosts (for example, "100 of 100+ hosts are shown"). This parameter is not affected by the Limit for search and filter results parameter in Administration → General → GUI. This parameter is not available when configuring the widget on a template dashboard. |