Send Zabbix alerts to a HipChat room using the v2 API.
Note: The notify.rb script can be used on its own without Zabbix as a simple command-line notification script for the HipChat v2 API. The hipchat.rb script is the one that is Zabbix-specific.
- Clone repository to your Zabbix alertscripts location (check
zabbix_server.conffor the proper location, on RHEL/CentOS it is/usr/lib/zabbix/alertscripts), and make sure the Gemfile dependency is installed. - In Zabbix navigate to Administration > Media Types and create a new media type called "HipChat". For type select "Script" and for script name type in "hipchat.rb".
- Create a new user account or use an existing account with adequate (read-only) permissions. In the "Media" tab, create a new media of type "HipChat". The "Send To" field is not used but cannot be blank, so just put some text into it.
- Navigate to Configuration > Actions and create a new Trigger action. Setup the appropriate conditions and choose any Name and Subject you'd like. For both the Default Message and the Recovery Message enter the following (format inspired by PagerDuty's ouput format, slightly adjusted to be valid YAML):
name: "{TRIGGER.NAME}"
id: "{TRIGGER.ID}"
status: "{TRIGGER.STATUS}"
hostname: "{HOSTNAME}"
ip: "{IPADDRESS}"
value: "{TRIGGER.VALUE}"
event_id: "{EVENT.ID}"
severity: "{TRIGGER.SEVERITY}"- Finally, in the "Operations" tab, setup an operation that sends a message to the user you have setup with the HipChat media, and choose "HipChat" from the "Send only to" dropdown.
Be sure to configure an appropriate config.yaml file (an example is provided) with your generated token and other information, then you will get nice color-coded messages in your chat room when Zabbix actions are fired.