Телеграм-бот мониторинга состояния

Обзор

После подключения мониторинга через телеграм-бота, система каждые 5 минут производит автоматический сбор сведений /system/state. При обнаружении в результатах каких-либо сведений, они транслируются через бот всем подключенным администраторам мастер-домена.

Администратор имеет возможность выставить тихий режим или поставить уведомления на паузу. При этом пауза автоматически сбросится, когда состояние нормализуется. В этом случае система отправит всем администраторам соответствующее сообщение.

С помощью бота администратор может запросить в любое время актуальный результат /system/state.

Администратор подключается к боту, отправляя команду "/start <Login>:<Password>".

Сервис взаимодействует с telegram-bot api через long-polling запросы.

Для работы необходим доступ в интернет к https://api.telegram.org (с серверов мастер-сайта, где исполняется роль mware).

Следует создавать отдельного бота под каждый экземпляр платформы. При регистрации одного токена в разных экземплярах платформы вероятны проблемы.

Инструкция по подключению

Шаг 1. Создать в Телеграм нового бота. Для этого необходимо найти @BotFather и отправить сообщение в его адрес:

tg 02

Шаг 2. Настроить бота. Опциональный шаг.

Установить описание команд:

tg 04
start - Connect to service
stop - Disconnect from service
ping - Ping service
test - Test reply message
testfile - Test reply as file
echo - Echo message back
sendtoall - Forward message to all connected users
disable_subscription - Disable automatic events
pause_subscription - Pause automatic events until state is not clear
enable_subscription - Enable automatic events
set_silent_mode - Make notifications silent
reset_silent_mode - Make notifications not silent
system_state - Get system state

Установить пиктограмму:

tg 03

Также по аналогии можно задать описание командой "/setdescription"

Шаг 3. Установить токен в систему. Авторизоваться в мастер-домен под учетной записью администратора, открыть раздел "Домен/Параметры (settings)". Задать токен, полученный на шаге 1, в качестве значения параметра 'telegram_bot_token'.

tg 01

После этого при наличии выхода в интернет в течение короткого времени платформа подключится к Telegram.

Шаг 4. Найти в телеграм созданного бота по заданному имени, и подключиться к нему.

tg 06

Каждое утро после 8 утра в часовом поясе сервера система с помощью бота информирует о своей активности. Отсутствие этого сообщения является признаком необходимости вмешательства. В нормальном режиме взаимодействие с ботом выглядит так:

tg 05