mirror of
https://github.com/zulip/zulip.git
synced 2025-11-19 22:19:48 +00:00
7fd7a1917b
I have added a note about the fact these instructions are for Zabbix 5.2 and above and the workflow for other versions of Zabbix may be different.
116 lines
4.6 KiB
Markdown
116 lines
4.6 KiB
Markdown
Receive Zabbix notifications in Zulip!
|
|
|
|
!!! warn ""
|
|
**Note:** This guide is for Zabbix 5.2 and above; some older Zabbix versions have a
|
|
different workflow for creating an outgoing webhook.
|
|
|
|
1. {!create-stream.md!}
|
|
|
|
1. {!create-bot-construct-url-indented.md!}
|
|
|
|
1. Go to your Zabbix web interface, and click **Administration**. Click on
|
|
**General** and then select **Macros** from the dropdown. Click **Add** and set the
|
|
macro to `{$ZABBIX_URL}`. Set the value as the URL to your Zabbix server like
|
|
`https://zabbix.example.com` ensuring there no trailing slashes. Click **Update**
|
|
|
|
1. Go back to your Zabbix web interface, and click **Administration**. Click on
|
|
**Media Types**, and click **Create Media Type**.
|
|
|
|
1. Set **Name** to a name of your choice, such as `Zulip`. Set **Type** to **Webhook**.
|
|
Add the following **Parameters**:
|
|
|
|
* Add `hostname` as the first parameter with the value `{HOST.NAME}`.
|
|
* Add `item` as the second parameter with the value `{ITEM.NAME1} is {ITEM.VALUE1}`.
|
|
* Add `link` as the third parameter with the value `{$ZABBIX_URL}/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}`.
|
|
* Add `severity` as the fourth parameter with the value `{TRIGGER.SEVERITY}`.
|
|
* Add `status` as the fifth parameter with the value `{TRIGGER.STATUS}`.
|
|
* Add `trigger` as the sixth parameter with the value `{TRIGGER.NAME}`.
|
|
* Add `zulip_endpoint` as the seventh parameter with the value set as the URL
|
|
constructed earlier.
|
|
|
|
Check the **Enabled** option, and click **Update**.
|
|
|
|
1. Click the **Pencil** to edit the script and replace any existing content with the below script:
|
|
|
|
try {
|
|
Zabbix.Log(4, 'zulip webhook script value='+value);
|
|
|
|
var result = {
|
|
'tags': {
|
|
'endpoint': 'zulip'
|
|
}
|
|
},
|
|
params = JSON.parse(value),
|
|
req = new CurlHttpRequest(),
|
|
payload = {},
|
|
resp;
|
|
|
|
req.AddHeader('Content-Type: application/json');
|
|
|
|
payload.hostname = params.hostname;
|
|
payload.severity = params.severity;
|
|
payload.status = params.status;
|
|
payload.item = params.item;
|
|
payload.trigger = params.trigger;
|
|
payload.link = params.link;
|
|
resp = req.Post(params.zulip_endpoint,
|
|
JSON.stringify(payload))
|
|
|
|
if (req.Status() != 200) {
|
|
throw 'Response code: '+req.Status();
|
|
}
|
|
|
|
resp = JSON.parse(resp);
|
|
result.tags.issue_id = resp.id;
|
|
result.tags.issue_key = resp.key;
|
|
} catch (error) {
|
|
Zabbix.Log(4, 'zulip issue creation failed json : '+JSON.stringify(payload));
|
|
Zabbix.Log(4, 'zulip issue creation failed : '+error);
|
|
|
|
result = {};
|
|
}
|
|
|
|
return JSON.stringify(result);
|
|
|
|
1. Click **Apply**. Click **Message Templates**. Click **Add**. Select **Problem**.
|
|
|
|
1. Set **Subject** to `{TRIGGER.STATUS}-{TRIGGER.SEVERITY}-{TRIGGER.NAME}`.
|
|
Set **Message** to the following:
|
|
|
|
{
|
|
"hostname": "{HOST.NAME}",
|
|
"severity": "{TRIGGER.SEVERITY}",
|
|
"status": "{TRIGGER.STATUS}",
|
|
"item": "{ITEM.NAME1} is {ITEM.VALUE1}",
|
|
"trigger": "{TRIGGER.NAME}",
|
|
"link": "{$ZABBIX_URL}/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}"
|
|
}
|
|
|
|
1. Click **Add**. Click **Update**.
|
|
|
|
1. Go back to your Zabbix web interface, and click **Administration**.
|
|
Click on **Users**, and select the alias of the user you would like
|
|
to use to set the notification. Click **Media**, and click **Add**.
|
|
|
|
1. Set **Type** to **Zulip** or whatever you named your media type as.
|
|
Set **Send To** to `Zulip` or any text. This field needs something in,
|
|
but isn't used. Tweak the severity and times when active for notifications
|
|
as appropriate, and check the **Enabled** option. Click **Add**.
|
|
Click **Update**.
|
|
|
|
1. Go back to your Zabbix web interface, and click **Configuration**.
|
|
Click **Actions**, and click **Create Action**.
|
|
|
|
1. Set **Name** to a name of your choice, such as `Zulip`. Under
|
|
**New Conditions**, add the conditions for triggering a notification.
|
|
Check the **Enabled** option, and click **Operations**.
|
|
|
|
1. Under **Operations** click **Add**, and then set **Operation Type** to
|
|
`Send Message`. Under **Send to Users**, click **Add**, and select the user
|
|
you added the alert to and click **Select**. Under **Send only to**,
|
|
select **Zulip** or the name of your media type. Click **Add** twice.
|
|
|
|
{!congrats.md!}
|
|
|
|
|