You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

1 Service tree

The service tree is configured in the Services -> Services menu section. In the upper right corner, switch from View to the Edit mode.

To configure a new service, click on the Create service button in the top right-hand corner.

To quickly add a child service, you can alternatively press a plus icon next to the parent service. This will open the same service configuration form, but the Parent services parameter will be pre-filled.

Service configuration

In the Service tab, specify required service parameters:

All mandatory input fields are marked with a red asterisk.

Parameter Description
Name Service name.
Parent services Parent services the service belongs to.
Leave this field empty if you are adding the service of highest level.
One service may have multiple parent services. In this case, it will be displayed in the service tree under each of the parent services.
Problem tags Specify tags to map problem data to the service:
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)
Tag name matching is always case-sensitive.
Sort order Sort order for display, lowest comes first.
Status calculation rule Rule for calculating service status:
Most critical if all children have problems - the most critical problem in the child services is used to color the service status, if all children have problems
Most critical of child services - the most critical problem in the child services is used to color the service status
Set status to OK - do not calculate service status
Additional status calculation rules can be configured in the advanced configuration options.
Description Service description.
Created at The time when the service was created; displayed when editing an existing service.
Advanced configuration Click on the Advanced configuration label to display advanced configuration options.

Advanced configuration

Parameter Description
Additional rules Click on Add to configure additional status calculation rules.
Set status to Set service status to either OK (default), Not classified, Information, Warning, Average, High or Disaster in case of a condition match.
Condition Select the condition for direct child services:
if at least (N) child services have (Status) status or above
if at least (N%) of child services have (Status) status or above
if less than (N) child services have (Status) status or below
if less than (N%) of child services have (Status) status or below
if weight of child services with (Status) status or above is at least (W)
if weight of child services with (Status) status or above is at least (N%)
if weight of child services with (Status) status or below is less than (W)
if weight of child services with (Status) status or below is less than (N%)

If several conditions are specified and the situation matches more than one condition, the highest severity will be set.
N (W) Set the value of N or W (1-100000), or N% (1-100) in the condition.
Status Select the value of Status in the condition: OK (default), Not classified, Information, Warning, Average, High or Disaster.
Status propagation rule Rule for propagating the service status to the parent service:
As is - the status is propagated without change
Increase by - you may increase the propagated status by 1 to 5 severities
Decrease by - you may decrease the propagated status by 1 to 5 severities
Ignore this service - the status is not propagated to the parent service at all
Fixed status - the status is propagated statically, i.e. as always the same
Weight Weight of the service (integer in the range from 0 (default) to 1000000).

Additional status calculation rules can only be used to increase severity level over the level calculated according to the main Status calculation rule parameter. If according to additional rules the status should be Warning, but according to the Status calculation rule the status is Disaster - the service will have status Disaster.

The Tags tab contains service-level tags. Service-level tags are used to identify a service. Tags of this type are not used to map problems to the service (for that, use Problem tags from the first tab).

The Child services tab allows to specify dependant services. Click on Add to add a service from the list of existing services. If you want to add a new child service, save this service first, then click on a plus icon next to the service that you have just created.

Tags

There are two different types of tags in services:

  • Service tags
  • Problem tags

Service tags

Service tags are used to match services with service actions and SLAs. These tags are specified at the Tags service configuration tab. For mapping SLAs, OR logic is used: a service will be mapped to an SLA if it has at least one matching tag. In service actions, mapping rules are configurable and can use either AND, OR, or AND/OR logic.

Problem tags

Problem tags are used to match problems and services. These tags are specified at the primary service configuration tab.

Only child services of the lowest hierarchy level may have problem tags defined and be directly correlated to problems. If problem tags match, the service status will change to the same status as the problem has. In case of several problems, a service will have the status of the most severe one. Status of a parent service is then calculated based on child services statuses according to Status calculation rules.

If several tags are specified, AND logic is used: a problem must have all tags specified in the service configuration to be mapped to the service.

A problem in Zabbix inherits tags from the whole chain of templates, hosts, items, web scenarios, and triggers. Any of these tags can be used for matching problems to services.

Example:

Problem Web camera 3 is down has tags type:video surveillance, floor:1st and name:webcam 3 and status Warning

The service Web camera 3 has the only problem tag specified: name:webcam 3

Service status will change from OK to Warning when this problem is detected.

If the service Web camera 3 had problem tags name:webcam 3 and floor:2nd, its status would not be changed, when the problem is detected, because the conditions are only partially met.

Modifying existing services

The buttons described below are visible only when Services section is in the Edit mode.

To edit an existing service, press the pencil icon next to the service.

To clone an existing service, press the pencil icon to open its configuration and then press Clone button. When a service is cloned, its parent links are preserved, while the child links are not.

To delete a service, press on the x icon next to it. When you delete a parent service, its child services will not be deleted and will move one level higher in the service tree (1st level children will get the same level as the deleted parent service).

Two buttons below the list of services offer some mass-editing options:

  • Mass update - mass update service properties
  • Delete - delete the services

To use these options, mark the checkboxes before the respective services, then click on the required button.