A kaholo trigger for integration with Zabbix Webhooks.
Versions
This works with Zabbix 1.8.x or greater – including 2.2, 2.4, 3.x. and 4.x!
Installation
Within the Zabbix web interface
When logged in to the Zabbix servers web interface with super-administrator privileges, navigate to the “Administration” tab, access the “Media Types” sub-tab, and click the “Create media type” button.
You need to create a media type as follows:
- Name: Kaholo
- Type: Script
- Script name: kaholo.sh
…and ensure that it is enabled before clicking “Save”.
However, on Zabbix 3.x and greater (including 4.x), media types are configured slightly differently and you must explicitly define the parameters sent to the kaholo.sh script. On Zabbix 3.x and 4.x, three script parameters should be added as follows:
{ALERT.SENDTO}{ALERT.SUBJECT}{ALERT.MESSAGE}
Then, create a “Kaholo” user on the “Users” sub-tab of the “Administration” tab within the Zabbix servers web interface and specify this users “Media” as the “kaholo” media type that was just created with the Slack.com channel (“#alerts” in the example).
Finally, an action can then be created on the “Actions” sub-tab of the “Configuration” tab within the Zabbix servers web interface to notify the Zabbix “Kaholo” user ensuring that the “Subject” is “PROBLEM” for “Default message” and “RECOVERY” should you choose to send a “Recovery message”.
Keeping the messages short is probably a good idea; use something such as the following for the contents of each message:
{TRIGGER.NAME} - {HOSTNAME} ({IPADDRESS})
More Information
- Zabbix 2.2 custom alertscripts documentation
- Zabbix 2.4 custom alertscripts documentation
- Zabbix 3.x custom alertscripts documentation
- Zabbix 4.x custom alertscripts documentation
Method: Zabbix Webhook
Webhook URL: <Kaholo URL>/zabbix/webhook Catches alerts sent from zabbix to this webhook.
Parameters
- Secret (Vault) Optional – If specified, check secret provided by request matches the secret provided here.
- Severity Level (String) Optional – If specified accept only alerts with the specified severity.
