Table of Contents
1 Configuring a template
Overview
Configuring a template requires that you first create a template by defining its general parameters and then you add entities (items, triggers, graphs, etc.) to it.
Creating a template
To create a template, do the following:
- Go to Configuration → Templates
- Click on Create template
- Edit template attributes
The Template tab contains general template attributes.
All mandatory input fields are marked with a red asterisk.
Template attributes:
| Parameter | Description |
|---|---|
| Template name | Unique template name. Alphanumerics, spaces, dots, dashes, and underscores are allowed. However, leading and trailing spaces are disallowed. |
| Visible name | If you set this name, it will be the one visible in lists, maps, etc. |
| Templates | Link one or more "nested" templates to this template. All entities (items, triggers, graphs, etc.) will be inherited from the linked templates. To link a new template, start typing the template name in the Templates field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on Select next to the Templates field; then, first select the host group by clicking on Select next to the Host groups field; mark the checkbox in front of one or multiple templates from the list displayed below; click on Select. The template(s) that are selected in the Templates field will be linked to the host when the host configuration form is saved or updated. To unlink a template, use one of the two options in the Templates block: Unlink - unlink the template, but preserve its items, triggers, and graphs Unlink and clear - unlink the template and remove all its items, triggers, and graphs |
| Groups | Host/template groups the template belongs to. |
| Description | Enter the template description. |
The Tags tab allows you to define template-level tags. All problems of hosts linked to this template will be tagged with the values entered here.
User macros, {INVENTORY.*} macros, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros are supported in tags.
The Macros tab allows you to define template-level user macros as a name-value pairs. Note that macro values can be kept as plain text, secret text, or Vault secret. Adding a description is also supported.
You may also view here macros from linked templates and global macros if you select the Inherited and template macros option. That is where all defined user macros for the template are displayed with the value they resolve to as well as their origin.
For convenience, links to respective templates and global macro configuration are provided. It is also possible to edit a nested template/global macro on the template level, effectively creating a copy of the macro on the template.
The Value mapping tab allows to configure human-friendly representation of item data in value mappings.
Buttons:
 |
Add the template. The added template should appear in the list. |
 |
Update the properties of an existing template. |
 |
Create another template based on the properties of the current template, including the entities (items, triggers, etc) inherited from linked templates. |
 |
Create another template based on the properties of the current template, including the entities (items, triggers, etc) both inherited from linked templates and directly attached to the current template. |
 |
Delete the template; entities of the template (items, triggers, etc) remain with the linked hosts. |
 |
Delete the template and all its entities from linked hosts. |
 |
Cancel the editing of template properties. |
With a template created, it is time to add some entities to it.
Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item.
Adding items, triggers, graphs
There are two ways to add items to the template:
To create new items, follow the guidelines for Creating an item.
To add existing items to the template:
- Go to Configuration → Hosts (or Templates).
- Click on Items in the row of the required host/template.
- Mark the checkboxes of items you want to add to the template.
- Click on Copy below the item list.
- Select the template (or group of templates) the items should be copied to and click on Copy.
All the selected items should be copied to the template.
Adding triggers and graphs is done in a similar fashion (from the list of triggers and graphs respectively), again, keeping in mind that they can only be added if the required items are added first.
Adding dashboards
To add dashboards to a template in Configuration → Templates, do the following:
- Click on Dashboards in the row of the template
- Configure a dashboard following the guidelines of configuring dashboards
The widgets that can be included in a template dashboard are: Clock, Graph (classic), Graph prototype, Item value, Plain text, URL.
For details on accessing host dashboards that are created from template dashboards, see the host dashboard section.
Configuring low-level discovery rules
See the low-level discovery section of the manual.
Adding web scenarios
To add web scenarios to a template in Configuration → Templates, do the following:
- Click on Web in the row of the template
- Configure a web scenario following the usual method of configuring web scenarios