cabot_alert_telegram 0.5

A Telegram alert plugin for Cabot by Arachnys

Based on: https://github.com/lblasc/cabot-alert-slack

This is an alert plugin for the cabot service monitoring tool. It allows you to alert users using a Telegram chat room.

Installation

Enter the cabot virtual environment:

$ pip install cabot_alert_telegram
$ foreman stop

or:

$ pip install git+git://github.com/codesyntax/cabot_alert_telegram.git
$ foreman stop

Edit conf/*.env:

CABOT_PLUGINS_ENABLED=cabot_alert_telegram=0.4
...
TELEGRAM_BOT_TOKEN=bot_token
TELEGRAM_CHAT_ID=id of the chat where messages will be sent

Add cabot_alert_telegram to the installed apps in settings.py:

$ foreman run python manage.py syncdb
$ foreman start

Add manually an instance of the Alert Plugin (sometimes it is not added automatically):

$ ssh ubuntu@server
$ source venv/bin/activate
$ cd cabot
$ foreman run -e conf/production.env python manage.py shell # point to the correct production.env file
Python 2.7.3 (default, Dec 18 2014, 19:10:20)
[GCC 4.6.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from cabot_alert_telegram.models import TelegramAlert
>>> ta = TelegramAlert()
>>> ta.title = u'Telegram'
>>> ta.save()
>>> (Ctrl-D to exit)

Telegram Bot

You need to create a Telegram bot which will be used to send the messages to the users. To create a new Telegram Bot check the official documentation at https://core.telegram.org/bots

You need to create a new Group Chat, add all your users to that chatroom and add also the Bot there.

To get the chat id, open https://telegram.me and select the group chat you previously created. Check the URL, it will be something like this:

https://web.telegram.org/#/im?p=g99999999

You need to not the value of p parameter (g99999999) and exchange g with a -: -99999999

This is a bit hacky, but I don’t know any other way to get the group id.

0.5 (2016-11-07)

• Simpler alert message [garaolaza]

0.4 (2016-01-21)

• rework readme [Mikel Larreategi <[e-mail]>]

• remove unneeded slack test [Mikel Larreategi <[e-mail]>]

• add whitespace to make links correctly clickable [Mikel Larreategi <[e-mail]>]

• document telegram install [Mikel Larreategi <[e-mail]>]

• bot documentation [Mikel Larreategi <[e-mail]>]

• remove [Mikel Larreategi <[e-mail]>]

0.3 (2015-07-02)

• bump [Mikel Larreategi <[e-mail]>]

• alert text change [Mikel Larreategi <[e-mail]>]

0.2 (2015-07-02)

• document the bot [Mikel Larreategi <[e-mail]>]

• reformat message [Mikel Larreategi <[e-mail]>]

• reformat [Mikel Larreategi <[e-mail]>]

• docs [Mikel Larreategi <[e-mail]>]

• Merge remote-tracking branch ‘origin/master’ [Mikel Larreategi <[e-mail]>]

• Update README.md [Aitzol <[e-mail]>]

0.1 (2015-07-02)

• history! [Mikel Larreategi <[e-mail]>]

• version [Mikel Larreategi <[e-mail]>]