Zabbix-in-Telegram

Zabbix Notifications with graphs in Telegram

Join us in our Telegram group via this link: https://t.me/ZbxTg

Subscribe to our channel: https://t.me/Zabbix_in_Telegram

Rate on share.zabbix.com: https://share.zabbix.com/cat-notifications/zabbix-in-telegram

Features

Graphs based on latest data are sent directly to your messenger
You can send messages both in private and group/supergroup chats
Channels support (only public, but you can do it for private as well with durty hack)
Saves chatid as a temporary file
Simple markdown and HTML are supported
Emoji (you can use emoji instead of severity, see the wiki article) (zabbix doesn't support utf8mb4 encoding yet)
Location map

TODOs

Simple zabbix's management via bot's commands – in dev state
Ability to send complex graph or part of screen

Configuration / Installation

First of all: You need to install the requests module for python, this is required for operation!
To do so, enter pip install requests in your commandline!

Put zbxtg.py in your AlertScriptsPath directory, the path is set inside your zabbix_server.conf
Put zbxtg_group.py in the same location if you want to send messages to the group chat
Create zbxtg_settings.py with your settings and save them in the same directory as the script, see example for layout
Create a bot in Telegram and get API key
Create readonly user in Zabbix (for getting graphs images from zabbix)
Set proxy host:port in zbxtg_settings.py if you need an internet proxy
Add new media for Telegram in Zabbix web interface with these settings:

Add another one if you want to send messages to the group

Note that Zabbix 3.0 has different settings for that step, see it there: https://github.com/ableev/Zabbix-in-Telegram/wiki/Working-with-Zabbix-3.0
Send a message to your bot via Telegram, e.g. "/start"
If you are in group chat, start a conversation with your bot: /start@ZbxTgDevBot
Create a new action like this:

Last value: {ITEM.LASTVALUE1} ({TIME})
zbxtg;graphs
zbxtg;graphs_period=10800
zbxtg;itemid:{ITEM.ID1}
zbxtg;title:{HOST.HOST} - {TRIGGER.NAME}

Add the appropriate Media Type to your user
The username is CASE-SENSITIVE
Group chats don't have URLs, so you need to put group's name in media type
Messages for channels should be sent as for private chats
Private:

Group:

Annotations

zbxtg;graphs -- enables attached graphs
zbxtg;graphs_period=10800 -- set graphs period (default - 3600 seconds)
zbxtg;graphs_width=700 -- set graphs width (default - 900px)
zbxtg;graphs_height=300 -- set graphs height (default - 300px)
zbxtg;itemid:{ITEM.ID1} -- define itemid (from trigger) for attach
zbxtg;title:{HOST.HOST} - {TRIGGER.NAME} -- graph title
zbxtg;debug -- enables debug mode, some logs and images will be saved in the tmp dir (temporary doesn't affect python version)
zbxtg;channel -- enables sending to channels

You can use markdown or html formatting in your action: https://core.telegram.org/bots/api#markdown-style + https://core.telegram.org/bots/api#html-style.

Debug

You can use the following command to send a message from your command line:
./zbxtg.py "<username>" "<message_subject>" "<message_body>" --debug
For <username> substitute your Telegram username, NOT that of your bot (case-sensitive)
For <message_subject> and <message_body> just substitute something like "test" "test" (for Telegram it's doesn't matter between subject and body
You can omit the ", these are optional

Known issues

MEDIA_CAPTION_TOO_LONG

If you see this error, it means that you rich the limit of caption with 200 symbols in it (Telegram API's limitaion). Such captions will be automatically cut to 200 symbols.

Zabbix 3.0

https://github.com/ableev/Zabbix-in-Telegram/wiki/Working-with-Zabbix-3.0

ruslan-ohitin / Zabbix-in-Telegram