Уведомления от Zabbix в Telegram

Сегодня подумал: "А почему бы не прикрутить telegram к zabbix?"... Немного погуглил... Но мне не понравились решения с установкой дополнительных программ/скриптов. Поэтому я решил реализовать это по своему: сделать бота и научить zabbix отправлять мне уведомление через него.


Шаг 1.
Для начала нужно создать бота в telegram. Для этого надо добавить в свой список контактов бота @BotFather, сказать ему "/start" и потом "/newbot". BotFather сначала спросит, как назвать нового бота, а следующим сообщением нужно ввести имя бота. В ответ BotFather пришлет token.
Вы можете либо создать своего бота либо использовать моего (все сообщения будут отправлены только вам, у меня к ним доступа нет). Звать этого бота @zabbix_notify_bot, а token у него "179320554:AAHI9AeBkptHgMIh5pVs31CRzGHV_9sG8bs". Бота нужно добавить в свой список контактов.


Шаг 2.
Чтобы можно было отправить себе сообщение, нужно знать свой Telegram ID. Для этого добавьте в свой список контактов бота @MyTelegramID_bot и скажите ему "/start". В ответ получите свой Telegram ID. Скоро он пригодится.
Если оповещение нужно слать в группу, то надо этого бота добавить в группу и сказать "/start". И далее использовать этот Telegram ID.

Шаг 3.
Для отправки сообщений достаточно дать одну команду:

curl --header 'Content-Type: application/json' --request 'POST' --data '{"chat_id":"_telegram_id_","text":"_your_message_"}' "https://api.telegram.org/bot_bot_token_/sendMessage"

, где _telegram_id_ - ваш Telegram ID, полученный на шаге 2;
_your_message_ - любое сообщение, которое бот отправит вам (для переноса строк можно использовать \n);
_bot_token_ - token бота, полученный на шаге 1.
Для отправки уведомлений из zabbix, я использую такой скрипт:

#!/bin/bash

TOKEN='179320554:AAHI9AeBkptHgMIh5pVs31CRzGHV_9sG8bs'

which curl &>/dev/null
if [ $? -ne 0 ] ; then echo 'FAIL: curl not found.' && exit 1 ; fi
if [ $# -ne 3 ] ; then echo 'FAIL: Params not defined.' && echo 'Usage: zabbix-to-telegram-notify.sh TelegramID Subject Message' && exit 1 ; fi

CHAT_ID="$1"
SUBJECT="$2"
MESSAGE="$3"

curl -s --header 'Content-Type: application/json' --request 'POST' --data "{\"chat_id\":\"${CHAT_ID}\",\"text\":\"${SUBJECT}\n${MESSAGE}\"}" "https://api.telegram.org/bot${TOKEN}/sendMessage" | grep -q '"ok":false,'
if [ $? -eq 0 ] ; then exit 1 ; fi

Если используется прокси, то нужно добавить соответствующие параметры для curl.
Скрипт нужно положить в каталог, который указан в параметре "AlertScriptsPath" в конфиге zabbix сервера:

# grep -i AlertScriptsPath /etc/zabbix/zabbix_server.conf | grep -vE '^#'
AlertScriptsPath=/etc/zabbix/alertscripts

И сделать его исполняемым:

chmod +x /etc/zabbix/alertscripts/zabbix-to-telegram-notify.sh

Шаг 4.
Теперь нужно настроить сам zabbix, чтобы он мог пользоваться скриптом. Для начала нужно создать новый способ оповещений. Я буду рассматривать для zabbix 3+, т.к. использую его. В 2.2-2.4 разница не большая.
Идем в Администрирование - Способы оповещений, жмем кнопку "Создать способ оповещений". В поле "Имя" вводим название способа оповещения. В поле "Тип" нужно выбрать "Скрипт". В поле "Имя скрипта" нужно указать имя файла-скрипт, без пути; например, zabbix-to-telegram-notify.sh. В поле "Параметры скрипта" нужно нажать "Добавить" 3 раза и ввести в появившиеся поля {ALERT.SENDTO}, {ALERT.SUBJECT} и {ALERT.MESSAGE}. Пример:

Шаг 5.
Идем в Администрирование - Пользователи - выбираем своего пользователя - Оповещения - Добавить. В поле "Тип" выбираем только что созданный способ оповещения, например, Telegram Bot. В поле "Отправлять на" вводим свой Telegram ID, полученный на шаге 2. Остальные поля заполняем на свое усмотрение.

Шаг 6.
Идем в Настройка - Действия, в поле "Источник событий" выбираем "Триггеры" и жмем "Создать действие". На закладках "Действие" и "Условие" заполняем поля по своему усмотрению. Я в полях "Сообщение по умолчанию" и "Сообщение о восстановлении" указываю такое:

{HOST.NAME} :: {ITEM.NAME} :: {ITEM.VALUE}


Status:  {TRIGGER.STATUS}
Host:  {HOST.NAME}
Item:  {ITEM.NAME}
Value:  {ITEM.LASTVALUE}

Key:  {ITEM.KEY}

Severity: {TRIGGER.SEVERITY}

Trigger: {TRIGGER.NAME}
Description: {TRIGGER.DESCRIPTION}

Но это "на вкус и цвет".
На закладке "Операции" жмем "Новый". Выбираем пользователя. В поле "Отправить только через" выбираем созданный на шаге 4 способ оповещения, например, Telegram Bot. Жмем "Добавить" и еще раз "Добавить".


На этом все. Теперь Zabbix должен присылать уведомления в Telegram.






Информация с сайта http://blog.angel2s2.ru/.