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, or you can too (Thanks to @vjunior1981 in #3):

• Enable guest user;
• Allow guest user to read the required hosts;

With this, you graphics are public. Use only if necessary.

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