Documentation
Table of Contents
3 Hosts
Overview
In the Data collection → Hosts section users can configure and maintain hosts.
A listing of existing hosts with their details is displayed.
Displayed data:
| Column | Description |
|---|---|
| Name | Name of the host. Clicking on the host name opens the host configuration form. |
| Entities (Items, Triggers, Graphs, Discovery, Web) | Clicking on the entity name will display items, triggers etc. of the host. The number of the respective entities is displayed in gray. |
| Interface | The main interface of the host is displayed. |
| Proxy | Proxy name is displayed, if the host is monitored by a proxy. This column is only displayed if the Monitored by filter option is set to 'Any' or 'Proxy'. |
| Templates | The templates linked to the host are displayed. If other templates are contained in the linked template, those are displayed in parentheses, separated by a comma. Clicking on a template name will open its configuration form. |
| Status | Host status is displayed - Enabled or Disabled. By clicking on the status you can change it. An orange wrench icon  before the host status indicates that this host is in maintenance. Maintenance details are displayed when the mouse pointer is positioned on the icon. |
| Availability | Host availability per configured interface is displayed. Availability icons represent only those interface types (Zabbix agent, SNMP, IPMI, JMX) that are configured. If you position the mouse pointer on the icon, a pop-up list appears listing all interfaces of this type with details, status and errors (for the agent interface, availability of active checks is also listed). The column is empty for hosts with no interfaces. The current status of all interfaces of one type is displayed by the respective icon color: Green - all interfaces are available; Yellow - at least one interface is available and at least one is unavailable; others can have any status, including 'unknown'; Red - no interfaces are available; Gray - at least one interface is unknown (none unavailable). Active check availability. Since Zabbix 6.2 active checks also affect host availability, if there is at least one enabled active check on the host. To determine active check availability, heartbeat messages are sent in the agent active check thread. The frequency of the heartbeat messages is set by the HeartbeatFrequency parameter in Zabbix agent and agent 2 configurations (60 seconds by default, 0-3600 range). Active checks are considered unavailable when the active check heartbeat is older than 2 x HeartbeatFrequency seconds.Note: If Zabbix agents older than 6.2.x are used, they are not sending any active check heartbeats, so the availability of their hosts will remain unknown. Active agent availability is counted towards the total Zabbix agent availability in the same way as a passive interface is. For example, if a passive interface is available while the active checks are unknown, the total agent availability is set to gray (unknown). |
| Agent encryption | Encryption status for connections to the host is displayed: None - no encryption; PSK - using pre-shared key; Cert - using certificate. |
| Info | Error information (if any) regarding the host is displayed. |
| Tags | Tags of the host with macros unresolved. |
To configure a new host, click on the Create host button in the top right-hand corner. To import a host from a YAML, XML, or JSON file, click on the Import button in the top right-hand corner.
Mass editing options
Buttons below the list offer some mass editing options:
- Enable - change host status to Monitored;
- Disable - change host status to Not monitored;
- Export - export the hosts to a YAML, XML or JSON file;
- Mass update - update several properties for a number of hosts at once;
- Delete - delete the hosts.
To use these options, mark the checkboxes before the respective hosts, then click on the required button.
Using filter
You can use the filter to display only the hosts you are interested in. For better search performance, data is searched with macros unresolved.
The Filter icon is available at the top right corner. Clicking on it will open a filter where you can specify the desired filtering criteria.
| Parameter | Description |
|---|---|
| Host groups | Filter by one or more host groups. Specifying a parent host group implicitly selects all nested host groups. |
| Templates | Filter by linked templates. |
| Name | Filter by visible host name. |
| DNS | Filter by DNS name. |
| IP | Filter by IP address. |
| Port | Filter by port number. |
| Status | Filter by host status. |
| Monitored by | Filter hosts that are monitored by server only, proxy only or both. |
| Proxy | Filter hosts that are monitored by the proxy specified here. |
| Tags | Filter by host tag name and value. 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. |
Unknown interface status
Zabbix server determines an 'unknown' status for the corresponding agent interface (Zabbix, SNMP, IPMI, JMX) in the following cases:
- There are no enabled items on the interface (they were removed or disabled).
- There are only active Zabbix agent items.
- There are no pollers for that type of the interface (e.g. StartPollers=0).
- Host is disabled.
- Host is set to be monitored by proxy, a different proxy or by server if it was monitored by proxy.
- Host is monitored by a proxy that appears to be offline (no updates received from the proxy during the maximum heartbeat interval - 1 hour).
Setting interface availability to 'unknown' is done after server configuration cache synchronization. Restoring interface availability (available/unavailable) on hosts monitored by proxies is done after proxy configuration cache synchronization.
For more details about host interface unreachability, see Unreachable/unavailable host interface settings.