Телеграм-бот мониторинга состояния
Обзор
После подключения мониторинга через телеграм-бота, система каждые 5 минут производит автоматический сбор сведений /system/state. При обнаружении в результатах каких-либо сведений, они транслируются через бот всем подключенным администраторам мастер-домена.
Администратор имеет возможность выставить тихий режим или поставить уведомления на паузу. При этом пауза автоматически сбросится, когда состояние нормализуется. В этом случае система отправит всем администраторам соответствующее сообщение.
С помощью бота администратор может запросить в любое время актуальный результат /system/state.
Администратор подключается к боту, отправляя команду "/start <Login>:<Password>".
Сервис взаимодействует с telegram-bot api через long-polling запросы.
Для работы необходим доступ в интернет к https://api.telegram.org (с серверов мастер-сайта, где исполняется роль mware).
Следует создавать отдельного бота под каждый экземпляр платформы. При регистрации одного токена в разных экземплярах платформы вероятны проблемы.
Инструкция по подключению
Шаг 1. Создать в Телеграм нового бота. Для этого необходимо найти @BotFather и отправить сообщение в его адрес:
Шаг 2. Настроить бота. Опциональный шаг.
Установить описание команд:
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
Установить пиктограмму:
Также по аналогии можно задать описание командой "/setdescription"
Шаг 3. Установить токен в систему. Авторизоваться в мастер-домен под учетной записью администратора, открыть раздел "Домен/Параметры (settings)". Задать токен, полученный на шаге 1, в качестве значения параметра 'telegram_bot_token'.
После этого при наличии выхода в интернет в течение короткого времени платформа подключится к Telegram.
Шаг 4. Найти в телеграм созданного бота по заданному имени, и подключиться к нему.
Каждое утро после 8 утра в часовом поясе сервера система с помощью бота информирует о своей активности. Отсутствие этого сообщения является признаком необходимости вмешательства. В нормальном режиме взаимодействие с ботом выглядит так:
