Skip to content

Latest commit

 

History

History
88 lines (46 loc) · 3.72 KB

media_ilert.md

File metadata and controls

88 lines (46 loc) · 3.72 KB

iLert webhook

This guide describes how to integrate your Zabbix 4.4 installation with iLert using the Zabbix webhook feature. This guide will provide instructions on setting up a media type, a user and an action in Zabbix.

In iLert

1. Go to Alert sources and click on Add a new alert source.

2. Set a name (e.g. "Zabbix") and select your desired escalation policy. Select "Zabbix" as the Integration Type and click Save.

3. On the next page, a Webhook URL is generated. You will need this URL when setting up the iLert media type in Zabbix.

In Zabbix

The configuration consists of a media type in Zabbix, which will invoke webhook to send alerts to iLert through the iLert alert source url. To utilize the media type, we will create a Zabbix user to represent iLert. We will then create an alert action to notify the user via this media type whenever there is a problem detected.

Create Global Macro

1. Go to the Administration tab.

2. Under Administration, go to the General page and choose the Macros from drop-down list.

3. Add the macro {$ZABBIX.URL} with Zabbix frontend URL (for example http://192.168.7.123:8081)

4. Click the Update button to save the global macros.

Create the iLert media type

1. Go to the Administration tab.

2. Under Administration, go to the Media types page and click the Import button.

3. Select Import file media_ilert.xml and click the Import button at the bottom to import the iLert media type.

4. Set the ILERT.ALERT.SOURCE.URL variable to the alert source url that you generated in iLert

5. Optional: you can rewrite standard incident summary with custom template via ILERT.INCIDENT.SUMMARY variable e.g. {TRIGGER.NAME}: {TRIGGER.STATUS} for {HOST.HOST}

Create the iLert user for alerting

1. Go to the Administration tab.

2. Under Administration, go to the Users page and click the Create user button.

3. Fill in the details of this new user, and call it iLert User”. The default settings for iLert User should suffice as this user will not be logging into Zabbix.

4. Click the Select button next to Groups.

  • Please note, that in order to notify on problems with host this user must has at least read permissions for such host.

5. Click on the Media tab and, inside of the Media box, click the Add button.

6. In the new window that appears, configure the media for the user as follows:

  • For the Type, select iLert (the new media type that was created).
  • For Send to: enter any text, as this value is not used, but is required.
  • Make sure the Enabled box is checked.
  • Click the Add button when done.

7. Click the Add button at the bottom of the user page to save the user.

8. Use the iLert User in any Actions of your choice. Text from "Action Operations" will be sent to "iLert Alert" when the problem happens. Text from "Action Recovery Operations" and "Action Update Operations" will be sent to "iLert Alert Notes" when the problem is resolved or updated.

For more information, use the Zabbix and iLert documentations.

Supported Versions

Zabbix 4.4, iLert API.