Overview

    You can configure several media types:

    Media types are configured in Administration → Media types.

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

    It is possible to test if a configured media type works, by clicking on Test in the last column (see 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 update

    • Discovery

    • 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:

    ParameterDescription
    Message typeType of event for which default message will be defined.
    Only one default message can be defined for each event type.
    SubjectSubject of the default message. The subject may contain macros. It is limited to 255 characters.
    Subject is not available for SMS media type.
    MessageThe default message. The message may contain macros. It is limited to certain amount of characters depending on the type of database (see for more information).

    To make changes to an existing message template: In the Actions column click on 1 Media types - 图6 to edit the template or click on to delete the message template.

    A notification message template can also be defined for each action individually (see action operations for details). Custom messages in actions can override message templates configured for a media type.

    Message templates must be defined for all media types, including webhooks or custom alert scripts that are not using default messages for notifications. For example, an action “Send message to Pushover webhook” will fail to send problem notifications, if problem message has not been defined for the Pushover webhook.

    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 server can only be limited by the StartAlerters . Alerts generated by one trigger are processed sequentially. So multiple notifications may be processed simultaneously only if they are generated by multiple triggers.

    1 Media types - 图8

    Media type testing

    It is possible to test if a configured media type works.

    E-mail

    For example, to test an e-mail media type:

    • Locate the relevant e-mail in the list of media types

    • Enter a Send to recipient address and with body and optional subject

    Test success or failure message will be displayed in the same window:

    Webhook

    To test a webhook media type:

    • Locate the relevant webhook in the list of media types

    • Click on Test in the last column of the list (a testing window will open)

    • Edit the webhook parameter values, if needed

    • Click on Test

    By default, webhook tests are performed with parameters entered during configuration. However, it is possible to change attribute values for testing. Replacing or deleting values in the testing window affects the test procedure only, the actual webhook attribute values will remain unchanged.

    To view media type test log entries without leaving the test window:

    • Click on Open log (a new popup window will open).
    If the webhook test is successful

    • “Media type test successful.” message is displayed

    • Server response appears in the gray Response field

    • Response type (JSON or String) is specified below the Response field

    If the webhook test fails
    • “Media type test failed.” message is displayed, followed by additional failure details.

    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 Administration → Users and open the user properties form

    • In the Media tab, click on

    1 Media types - 图13