Documentation
Table of Contents
1 Service tree
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 (equals to "Problem, if all children have problems" in Zabbix versions before 6.0)- the most critical problem in the child nodes is used to color the service status, if all children have problems Most critical of child nodes (equals to "Problem, if one child has a problem" in Zabbix versions before 6.0) - the most critical problem in the child nodes is used to color the service status Set status to OK - do not calculate service status Mark the Advanced configuration checkbox below to configure additional status calculation rules. |
| Description | Service description. |
| Advanced configuration | Mark the checkbox to access advanced configuration options. |
Advanced configuration
| Parameter | Description |
|---|---|
| Additional rules | Click on Add to define 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. Service-level tags are not used to map problems to the service (for that, see Problem tags in 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 Tabs service configuration tab.
Problem tags
Problem tags are used to match problems and services. These tags are specified in the primary service configuration tab.
Zabbix checks problem tags to find out whether they match problem tag matching rules of any of the services. A service may have several Problem tag rules defined. In this case, the problem tags must meet all of the conditions.
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.
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.
Only child services of the lowest hierarchy level may have Problem tags defined and be directly correlated to problems. Status of a parent service is then calculated based on child services statuses according to Status calculation rules.
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 rule defined: name equals webcam 3. Service status will change from OK to Warning when this problem is detected.
If the service Web camera 3 had two problem tag conditions set: - name equals webcam 3, - floor equals 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.