1 Media types

Overview

Media are the delivery channels used for sending notifications and alerts from Zabbix.

You can configure several media types:

• E-mail
• SMS
• Custom alertscripts
• Webhook

Media types are configured in Alerts → Media types.

Some media types come pre-defined in the default dataset. You just need to finetune their parameters to get them working.

Automated Gmail/Office365 media types

Gmail or Office365 users may benefit from easier media type configuration. The Email provider field in the mail media type configuration allows to select pre-configured options for Gmail and Office 365.

When selecting the Gmail/Office365 related options, it is only required to supply the sender e-mail address/password to create a working media type.

As soon as the e-mail address/password is supplied, Zabbix will be able to automatically fill all required settings for Gmail/Office365 media types with the actual/recommended values, i.e. SMTP server, SMTP server port, SMTP helo, and Connection security. Because of this automation, these fields are not even shown, however, it is possible to see the SMTP server and e-mail details in the media type list (see the Details column).

Note also that:

• The password is not required for the relay options
• For Office365 relay, the domain name of the provided e-mail address will be used to dynamically fill the SMTP server (i.e. replace “example.com” in example-com.mail.protection.outlook.com with the real value)

To test if a configured media type works, click on the Test link in the last column (see media type testing for E-mail, Webhook, or Script for more details).

To create a new media type, click on the Create media type button. A media type configuration form is opened.

Common parameters

Some parameters are common for all media types.

In the Media type tab the common general attributes are:

See the individual pages of media types for media-specific parameters.

The Message templates tab allows to set default notification messages for all or some of the following event types:

• Problem
• Problem recovery
• Problem update
• Service
• Service recovery
• Service update
• Discovery
• Autoregistration
• Internal problem
• Internal problem recovery

To customize message templates:

• In the Message templates tab click on : a Message template popup window will open.
• Select required Message type and edit Subject and Message texts.
• Click on Add to save the message template

Message template parameters:

To make changes to an existing message template: in the Actions column click on to edit the template or click on to delete the message template.

It is possible to define a custom message template for a specific action (see action operations for details). Custom messages defined in the action configuration will override default media type message template.

Defining message templates is mandatory for all media types, including webhooks or custom alert scripts that do not use default messages for notifications. For example, an action “Send message to Pushover webhook” will fail to send problem notifications, if the Problem message for the Pushover webhook is not defined.

The Options tab contains alert processing settings. The same set of options is configurable for each media type.

All media types are processed in parallel. While the maximum number of concurrent sessions is configurable per media type, the total number of alerter processes on the server can only be limited by the StartAlerters parameter. Alerts generated by one trigger are processed sequentially. So multiple notifications may be processed simultaneously only if they are generated by multiple triggers.

User media

To receive notifications of a media type, a medium (e-mail address/phone number/webhook user ID etc) for this media type must be defined in the user profile. For example, an action sending messages to user “Admin” using webhook “X” will always fail to send anything if the webhook “X” medium is not defined in the user profile.

To define user media:

• Go to your user profile, or go to Users → Users and open the user properties form
• In the Media tab, click on

User media attributes:

Parameter	Description
Type	The drop-down list contains the names of enabled media types. Note that when editing a medium of a disabled media type, the type will be displayed in red.
Send to	Provide required contact information where to send messages. For an e-mail media type it is possible to add several addresses by clicking on below the address field. In this case, the notification will be sent to all e-mail addresses provided. It is also possible to specify recipient name in the Send to field of the e-mail recipient in a format ‘Recipient name <[email protected]>’. Note, that if a recipient name is provided, an e-mail address should be wrapped in angle brackets (<>). UTF-8 characters in the name are supported, quoted pairs and comments are not. For example: John Abercroft <[email protected]> and [email protected] are both valid formats. Incorrect examples: John Doe [email protected], %%”Zabbix\@\<H(comment)Q\>” [email protected] %%.
When active	You can limit the time when messages are sent, for example, set the working days only (1-5,09:00-18:00). Note that this limit is based on the user time zone. If the user time zone is changed and is different from the system time zone this limit may need to be adjusted accordingly so as not to miss important messages. See the Time period specification page for description of the format.
Use if severity	Mark the checkboxes of trigger severities that you want to receive notifications for. Note that the default severity (‘Not classified’) must be checked if you want to receive notifications for non-trigger events. After saving, the selected trigger severities will be displayed in the corresponding severity colors, while unselected ones will be grayed out.
Status	Status of the user media. Enabled - is in use. Disabled - is not being used.