|
|
# iLert Alerting Integration
|
|
|
|
|
|
|
|
|
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**.
|
|
|
|
|
|
[](images/1.png)
|
|
|
|
|
|
2\. Set a name (e.g. "Zabbix") and select your desired escalation policy. Select "Zabbix" as the **Integration Type** and click **Save**.
|
|
|
|
|
|
[](images/2.png)
|
|
|
|
|
|
3\. On the next page, an **API key** is generated. You will need it when setting up the iLert media type in Zabbix.
|
|
|
|
|
|
[](images/3.png)
|
|
|
|
|
|
|
|
|
## In Zabbix
|
|
|
|
|
|
|
|
|
The configuration consists of a _media type_ in Zabbix which will invoke a webhook to send alerts to iLert through the iLert Event API.
|
|
|
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 a problem is detected.
|
|
|
|
|
|
> Note: only trigger events are currently supported
|
|
|
|
|
|
|
|
|
## 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 your Zabbix frontend URL (for example http://192.168.7.123:8081)
|
|
|
|
|
|
[](images/4.png)
|
|
|
|
|
|
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.
|
|
|
|
|
|
[](images/5.png)
|
|
|
|
|
|
3\. Select the Import file [media_ilert.yaml](media_ilert.yaml) and click **Import** at the bottom to import the iLert media type.
|
|
|
|
|
|
[](images/6.png)
|
|
|
|
|
|
4\. Optional: you can overwrite the standard incident summary with a custom template using the **.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 **Create user**.
|
|
|
|
|
|
[](images/7.png)
|
|
|
|
|
|
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**.
|
|
|
|
|
|
[](images/8.png)
|
|
|
|
|
|
* Please note: in order to be notified of host problems this user must have at least read permissions for the given host.
|
|
|
|
|
|
5\. Navigate to the **Media** tab and click on the **Add** button inside of the **Media** box.
|
|
|
|
|
|
[](images/9.png)
|
|
|
|
|
|
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**: paste the alert source api key that you generated in iLert.
|
|
|
* Make sure the **Enabled** box is checked.
|
|
|
* Click the **Add** button when you are 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. The text from "Action Operations" will be sent to "iLert Alert" when a problem happens.
|
|
|
|
|
|
For more information use the [Zabbix](https://www.zabbix.com/documentation/7.0/manual/config/notifications) and [iLert](https://docs.ilert.com/integrations/zabbix/native) documentations.
|
|
|
|
|
|
|
|
|
## Supported Versions
|
|
|
|
|
|
|
|
|
Zabbix >=7.0, iLert API v1.
|
