Table of Contents
2 Operations
Overview
You can define the following operations for all events:
- Send a message
- Execute a remote command
Zabbix server does not create alerts if access to the host is explicitly "denied" for the user defined as action operation recipient or if the user has no rights defined to the host at all.
For discovery and autoregistration events, additional operations are available:
- Add host
- Remove host
- Enable host
- Disable host
- Add to host group
- Remove from host group
- Add host tags
- Remove host tags
- Link template
- Unlink template
- Set host inventory mode
Configuring an operation
To configure an operation, go to the Operations tab in action configuration.
General operation attributes:
| Parameter | Description |
|---|---|
| Default operation step duration | Duration of one operation step by default (60 seconds to 1 week). For example, an hour-long step duration means that if an operation is carried out, an hour will pass before the next step. Time suffixes are supported, e.g. 60s, 1m, 2h, 1d. User macros are supported. |
| Operations | Action operations (if any) are displayed, with these details: Steps - escalation step(s) to which the operation is assigned. Details - type of operation and its recipient/target. The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient. Start in - how long after an event the operation is performed. Duration (sec) - step duration is displayed. Default is displayed if the step uses default duration, and a time is displayed if custom duration is used. Actions - links for editing and removing an operation are displayed. |
| Recovery operations | Action operations (if any) are displayed, with these details: Details - type of operation and its recipient/target. The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient. Actions - links for editing and removing an operation are displayed. |
| Update operations | Action operations (if any) are displayed, with these details: Details - type of operation and its recipient/target. The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient. Actions - links for editing and removing an operation are displayed. |
| Pause operations for symptom problems | Mark this checkbox to pause operations (after the first operation) for symptom problems. Note that this setting affects only problem escalations; recovery and update operations will not be affected. This option is available for Trigger actions only. |
| Pause operations for suppressed problems | Mark this checkbox to delay the start of operations for the duration of a maintenance period. When operations are started, after the maintenance, all operations are performed including those for the events during the maintenance. Note that this setting affects only problem escalations; recovery and update operations will not be affected. If you unmark this checkbox, operations will be executed without delay even during a maintenance period. This option is not available for Service actions. |
| Notify about canceled escalations | Unmark this checkbox to disable notifications about canceled escalations (when host, item, trigger or action is disabled). |
All mandatory input fields are marked with a red asterisk.
To configure details of a new operation, click on 
in the Operations block. To edit an existing operation, click on 
next to the operation. A pop-up window will open where you can edit the operation step details.
Operation details
| Parameter | Description | ||
|---|---|---|---|
| Operation | Select the operation: Send message - send message to user. <remote command name> - execute a remote command. Commands are available for execution if previously defined in global scripts with Action operation selected as its scope. More operations are available for discovery and autoregistration based events (see above). |
||
| Steps | Select the step(s) to assign the operation to in an escalation schedule: From - execute starting with this step. To - execute until this step (0=infinity, execution will not be limited). |
||
| Step duration | Custom duration for these steps (0=use default step duration). Time suffixes are supported, e.g. 60s, 1m, 2h, 1d. User macros are supported. Several operations can be assigned to the same step. If these operations have different step duration defined, the shortest one is taken into account and applied to the step. |
||
| Operation type: send message | |||
| Send to user groups | Select user groups to send the message to. The user group must have at least "read" permissions to the host in order to be notified. |
||
| Send to users | Select users to send the message to. The user must have at least "read" permissions to the host in order to be notified. |
||
| Send only to | Send message to all defined media types or a selected one only. | ||
| Custom message | If selected, the custom message can be configured. For notifications about internal events via webhooks, custom message is mandatory. |
||
| Subject | Subject of the custom message. The subject may contain macros. It is limited to 255 characters. | ||
| Message | The custom message. The message may contain macros. It is limited to certain amount of characters depending on the type of database (see Sending message for more information). | ||
| Operation type: remote command | |||
| Target list | Select targets to execute the command on: Current host - command is executed on the host of the trigger that caused the problem event. This option will not work if there are multiple hosts in the trigger. Host - select host(s) to execute the command on. Host group - select host group(s) to execute the command on. Specifying a parent host group implicitly selects all nested host groups. Thus the remote command will also be executed on hosts from nested groups. A command on a host is executed only once, even if the host matches more than once (e.g. from several host groups; individually and from a host group). The target list is meaningless if a custom script is executed on Zabbix server. Selecting more targets in this case only results in the script being executed on the server more times. Note that for global scripts, the target selection also depends on the Host group setting in global script configuration. Target list option is not available for Service actions because in this case remote commands are always executed on Zabbix server. |
||
| Conditions | Condition for performing the operation: Event is not acknowledged - only when the event is unacknowledged. Event is acknowledged - only when the event is acknowledged. Conditions option is only available for Trigger actions. |
||
When done, click Add to add the operation to the list of Operations.