Documentation

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

4 Host prototypes

Host prototypes can be created with the low-level discovery rule. When matching entities are discovered, these prototypes become real hosts. Discovered hosts belong to an existing host and are prefixed with the discovery rule name.

Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates.

Host prototype configuration

To create a host prototype, press on the Host prototypes hyperlink for the required discovery rule, then press Create host prototype button in the upper right corner.

In the new window, specify host prototype parameters. Host prototypes have the same parameters as regular hosts, with the following exceptions:

  • Host name must contain at least one low-level discovery macro to ensure that hosts created from the prototype have unique host names.
  • Interfaces defines whether discovered hosts should inherit the IP of a host the discovery rule belongs to (default) or get custom interfaces.
  • Group prototypes allows specifying host group prototypes by using LLD macros.
  • Create enabled sets the status of discovered hosts, if the checkbox is unmarked the hosts will be created, but disabled.
  • Discover - if the checkbox is unmarked, the hosts will not be created from the host prototype, unless this setting is overridden in the discovery rule.
  • Value maps are not supported for host prototypes.

LLD macros can be used for host name, visible name, host group prototype, interfaces, tag values, or values of host prototype user macros.

Host interfaces

To add custom interfaces, switch the Interface selector from Inherit to Custom mode, then press add_link.png and select the required interface type from the menu.

A host prototype may have any of the supported interface types: Zabbix agent, SNMP, JMX, IPMI.

Low-level discovery macros and user macros are supported.

If several custom interfaces are specified, use the Default column to specify the primary interface.

Notes:

  • If Custom is selected, but no interfaces have been specified, the hosts will be created without interfaces.
  • If Inherit is selected for a host prototype that belongs to a template, discovered hosts will inherit the interface of a host to which the template is linked to.

A host will not be created, if a host interface contains incorrect data.

Discovered hosts

In the host list, discovered hosts are prefixed with the name of the discovery rule that created them.

The following discovered host parameters are customizable:

  • Templates - it is possible to link additional templates to these hosts or unlink manually added templates. Templates inherited from a host prototype cannot be unlinked.
  • Description
  • Status - a host can be manually enabled/disabled.
  • Tags - host tags can be added manually, alongside the tags inherited from the host prototype. Neither manual nor inherited tags can be duplicate, i.e. have the same name and value. If an inherited tag has the same name and value as a manual tag, it will replace the manual tag during discovery.
  • Macros - host macros can be added manually, alongside the macros inherited from the host prototype. For inherited macros, it is possible to change macro value and type on the host level.
  • Host inventory fields

Other parameters are inherited from the host prototype as read-only.

Discovered hosts can be deleted manually. Hosts that are no longer discovered, will be deleted automatically, based on the Keep lost resources period (in days) value of the discovery rule.