rocketchat-zabbix

Sends Zabbix notifications to Rocket.Chat, an Open Source Slack Alternative (Tested on Zabbix 2.4.5. For higher versions, change similar parameters.)

Definitions in examples

Variable	URL
Zabbix URL	zabbix.example.com
Rocket.Chat URL	rocketchat.example.com

Rocket.chat

In Rocket.Chat, click in Options > Administration > Integrations > New integration > Incoming WebHook

Enabled: True
Name: Incoming-zabbix
Post to Channel: #zabbix-channel

Save changes and get Webhook URL. Example: http://rocketchat.example.com/hooks/7mbi7xr3akMfKZdna/2wPNTHja7xaREdZY39744eehskYTkw7yx6mwrBpD5Wjphfqg

Zabbix

Create a script

In directory of AlertScript (Use grep ^AlertScript /etc/zabbix/zabbix_server.conf), create a file rocketchat.py.

#!/usr/bin/python

import sys
import requests

url     = sys.argv[1]
body    = sys.argv[2]
body = body.encode(encoding='utf-8')

r = requests.post(url, body)

Add executable permissions to the script

chmod +x rocketchat.py

Create a media

In Administration > Media types > Create media type:

Name: rocketchat alert
Type: script
Script name: rocketchat.py

Script parameters:

{ALERT.SENDTO}
{ALERT.MESSAGE}

{ALERT.SENDTO} will be changed by webhook url and {ALERT.MESSAGE} will be changed by alert message, formated in JSON.

Click in add.

Create a user

IMPORTANT

I recommend that you create a group with read-only permission (zabbix-ro) of the items you want to receive alerts, and put the user rocketchat on it.

in Administration > Users > Create user

User Tab

Define

Alias: rocketchat
Name: rocketchat
Groups: zabbix-ro

Media Tab:

Type: rocketchat alert
Send to: http://rocketchat.example.com/hooks/7mbi7xr3akMfKZdna/2wPNTHja7xaREdZY39744eehskYTkw7yx6mwrBpD5Wjphfqg
Status Enabled.

Save changes.

Create Actions

In Configuration > Actions, select "event source: Triggers", and click in Create action.

Action Tab

Name: Rocket.Chat Notifications
Default subject: Problem {TRIGGER.NAME}
Default message:

{
  "text": ":negative_squared_cross_mark: *{TRIGGER.NAME} ({ITEM.VALUE1})*",
  "attachments": [
    {
      "color": "#FF0000",
      "title": "[INCIDENT] {HOST.NAME}  ({HOST.CONN})",
      "title_link": "https://zabbix.example.com/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}",
      "text": "Verified in {TIME}, at {EVENT.DATE}",
      "image_url": "https://zabbix.example.com/chart3.php?&width=900&height=200&period=3600&name={HOST.NAME}: {TRIGGER.NAME}&legend=1&items[0][itemid]={ITEM.ID}&items[0][drawtype]=5&items[0][color]=ff0000"
    }
  ]
}

Click in Recovery message

Recovery subject: OK: {TRIGGER.NAME}
Recovery message:

{
  "text": ":white_check_mark: *{TRIGGER.NAME} ({ITEM.VALUE1})*",
  "attachments": [
    {
      "color": "#00FF00",
      "title": "[OK] {HOST.NAME}  ({HOST.CONN})",
      "title_link": "https://zabbix.example.com/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}",
      "text": "Verified in {TIME}, at {EVENT.DATE}",
      "image_url": "https://zabbix.example.com/chart3.php?&width=900&height=200&period=3600&name={HOST.NAME}: {TRIGGER.NAME}&legend=1&items[0][itemid]={ITEM.ID}&items[0][drawtype]=5&items[0][color]=00ff00"
    }
  ]
}

To understand more about Zabbix Macros, check the link: https://www.zabbix.com/documentation/3.4/manual/appendix/macros/supported_by_location

Click in Enabled, and Add.

Conditions tab

Type of calculation: And/Or (A and B and (C or D))
Conditions:

Label	Name
A	Maintenance status not in maintenance
B	Trigger value = PROBLEM
C	Trigger severity = Disaster
D	Trigger severity = High

In this configuration, the triggers will only be sent if an event occurs in high severity or disaster. Minor events will not be reported. To add, just include them.

Operations tab

Operation details:

Operation type: Send message
Send to Users: rocketchat
Send only to: rocketchat-script

Click in Add to Operation details and Add in screen.

So when a trigger is triggered, this will be the message sent to Rocket.Chat:

Note: To view the graphs, you need to be logged in to Zabbix.

Plus: Zabbix Template

you need to set the user macro ROOT_URL on the host where the template will be applied.

{$ROOT_URL}: Your Rocket.Chat URL (ex.: https://rocket.example.com )

This template monitors:

Itens

MongoDB
- Memory usage
- MOngoDB service status
Node
- Memory usage node main.js
- Node on port 3000
- Number of process node main.js
Web
- Check status of webpage
- Check status of api

Triggers

Rocket.Chat is down
Node main.js is NOT RUNNING
NodeJS port is closed
MongoDB port is closed

Graphics

Memory usage node main.js
Memory usage mongoDB

Blinket / rocketchat-zabbix