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 as the data source for host groups. This parameter is not available when configuring the widget on a template dashboard. |
| Hosts | Enter host patterns or select existing hosts as host patterns. Hosts that match the specified patterns will be displayed on the host navigator. 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. Wildcard patterns may be used for selection (for example, * will return hosts that match zero or more characters; Zabbix* will return hosts that start with "Zabbix").To specify a wildcard pattern, enter the string manually and press Enter. When you start typing, a dropdown list will show matching hosts limited to those belonging to hosts within selected Host groups, if any. 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 problem severities to filter hosts with problems to be displayed in the widget. If no severities are marked, all hosts with all problems will be displayed. |
| 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 the corresponding problem count is displayed; for each host, all its problem counts are displayed. Hosts without problems will be displayed in the Uncategorized group. Note that if the Severity parameter contains marked problem severities, hosts will be grouped only by those severities. 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. |