Zabbix is the ultimate enterprise-level software designed for real-time monitoring of millions of metrics collected from tens of thousands of servers, virtual machines and network devices.
Zabbix is Open Source and comes at no cost.
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
Bots are special Telegram accounts designed to handle messages automatically. Users can interact with bots by sending them command messages in private or group chats. You control your bots using HTTPS requests available on the bot API.
To everything described here I'll use the following bot token:
158700146:AAHOPReqqTR8V7FXysa8mJCbQACUWSTBog8.
Please note that this token is only an example. You must generate your own by following the steps on Creating a bot.
The only thing you must have before following these instructions is a Zabbix Server running.
The only installation required is pyTelegramBotAPI. Choose one of the following methods:
$ pip install pyTelegramBotAPI
It is also recommended to install security packages. To do this, run:
$ pip install pyopenssl ndg-httpsclient pyasn1
It may be necessary to update the requests package (tested with Ubuntu 14.04.4):
$ pip install -U requests
$ git clone https://github.com/eternnoir/pyTelegramBotAPI.git
$ cd pyTelegramBotAPI
$ python setup.py install
To create a bot, talk to @BotFather on Telegram.
Send /newbot and it will ask the bot's name. Choose any name.
Then it will ask the bot's username. The username must end with bot and is unique.
When everything is done, the @BotFather will display the bot's token. Save it and keep it secret. Here is an example of a token:
158700146:AAHOPReqqTR8V7FXysa8mJCbQACUWSTBog8
In order to receive messages, the recipient user MUST send a message to the bot at least once.
If a group will be used, add the bot on the group before testing.
For channels, add the bot to the channel as an administrator.
No bot configuration is needed, but there are optional settings.
Commands available on @BotFather:
/tokenShows your bot's token./revokeRevoke the token and give you a new one./setnameChange the bot's name./setdescriptionSet the bot's description, a window displayed when a person opens a chat with the bot./setabouttextSet the bot's about message, displayed on the bot's profile page./setuserpicThe bot's photo./setcommandsThe commands that will be listed as bot's options./setjoingroupsDefines if the bot may or may not join groups./setprivacySet if the bot reads all the messages on a group or only messages that it is cited./deletebotUsed to destroy the bot.
Create a file named telegram_notification.py on the folder /usr/src/zabbixbot:
$ vi telegram_notification.py
Then paste the code:
#!/usr/bin/env python
import telebot,sys
BOT_TOKEN='158700146:AAHOPReqqTR8V7FXysa8mJCbQACUWSTBog8'
DESTINATION=sys.argv[1]
SUBJECT=sys.argv[2]
MESSAGE=sys.argv[3]
MESSAGE = MESSAGE.replace('/n','\n')
tb = telebot.TeleBot(BOT_TOKEN)
tb.send_message(DESTINATION,SUBJECT + '\n' + MESSAGE, disable_web_page_preview=True, parse_mode='HTML')
Change the file permission and allow it to be executed
# chown -R zabbix: /usr/src/zabbixbot/
# chmod +x telegram_notification.py
Go to file /etc/zabbix/zabbix_server.conf
vi /etc/zabbix/server.conf
find the line AlertScriptsPath=. And include:
AlertScriptsPath=/usr/src/zabbixbot/
The easiest way to find is typing /AlertScriptsPath=.
Restart Zabbix-server service.
service zabbix-server restart
On the Zabbix interface, go to Adminstration, Media types, and click on Create media type.
- Name:
telegram_notification.py - Type:
Script - Script name:
telegram_notification.py
- Script Parameters
- {ALERT.SENDTO}
- {ALERT.SUBJECT}
- {ALERT.MESSAGE}
Open Zabbix web interface, go to Configuration, Actions and click on Create Action.
- Name:
Telegram notification - Subject:
#{HOSTNAME}: {TRIGGER.NAME} {TRIGGER.STATUS} - Message:
Value: {ITEM.VALUE} {TRIGGER.STATUS}
Date: {EVENT.DATE} Time: {EVENT.TIME}
The fields Subject and Message are supposed to be customized as your needs. HTML tags supported:
<b>bold</b>, <strong>bold</strong>
<i>italic</i>, <em>italic</em>
<a href="URL">inline URL</a>
<code>inline fixed-width code</code>
<pre>pre-formatted fixed-width code block</pre>
Go to tab Conditions and add settings as your needs.
Go to tab Actions and add settings as your needs.
- Action
- Name: Telegram
- Conditions
- Set as your needs
- Operations
- Recovery operations
The last step is to set who will receive the alerts.
Go to Administration, Users and choose who will receive the notifications. Then, go to Media and click on Add.
- Type:
telegram_notification.py - Send to:
ID| Refer to Telegram ID
Telegram needs ids to send messages. The easiest way to get this id is using the bot you have just created.
Go to https://api.telegram.org/bot158700146:AAHOPReqqTR8V7FXysa8mJCbQACUWSTBog8/getUpdates using your browser.
If you want to get a user id, send a message from this user to the bot. Reload the page and the user id will be shown.
Example:
"message":{"message_id":59,"from":{"id":9083329,"first_name":"Gabriel","last_name":"R F","username":"GabrielRF"},"chat":{"id":9083329,"first_name":"Gabriel","last_name":"R F","username":"GabrielRF","type":"private"},"date":1446911853,"text":"\/start"}}]}
In this case, the user id is 9083329. So, on the step Users, the field Send to would be 9083329.
If you prefer to have your bot working on a group, then create the group and add the bot to it. Reload the page and you will see a message like:
"message":{"message_id":60,"from":{"id":9083329,"first_name":"Gabriel","last_name":"R F","username":"GabrielRF"},"chat":{"id":-57169325,"title":"q31231","type":"group"},"date":1446912067,"group_chat_created":true}},{"update_id":727527785,
In this case, the group id is -57169325. So, on the step Users, the field Send to would be -57169325.
Note that a group id is always negative. Only user's id are positive.
The last alternative is the easiest one. There's no need to get a channel id. Simply set the Send to field on the step Users to @ChannelID. The @ symbol is obligatory.
If this method doesn't work or if you want to get an id from a private channel, please, visit https://github.com/GabrielRF/telegram-id
Most of this method is based on a post from a Brazilian dev named Tobias. Zabbix com notificações pelo Telegram (Portuguese only)
A simple, but extensible Python implementation for the Telegram Bot API. eternoir/pyTelegramBotAPI
Finally, I would like to thank João Paulo Nascimento, from Sergipe, who was the first person to test this method, helping me to find bugs.