Отправка уведомлений из zabbix в telegram через webhook

Введение

Способов настройки уведомлений из заббикса в телеграм существует несколько. Их можно разделить по информативности:

Отправка только текстовых оповещений.
Отправка графиков.

Так же можно разделить по типу реализации:

Использовать встроенный webhook в zabbix.
Написать свой простой скрипт для уведомлений.
Взять готовую реализацию уведомлений в telegram на github.

Я постараюсь разобрать все возможные варианты. Идти будем от простого к сложному. Сначала настроим текстовые оповещения, потом добавим графики. Отправлять будем как в личку, так и в группу.

Кстати, еще один способ отправки уведомлений из zabbix – с помощью звонка через asterisk. Если вам это интересно, читайте соответствующий материал – оповещения zabbix через asterisk.

Я буду настраивать все в zabbix 5.0, установленный на Centos 8. Принципиального значения это не имеет, решение будет одинаково работать практически на всех дистрибутивах linux.

Если у вас еще нет своего сервера для мониторинга, то рекомендую материалы на эту тему. Для тех, кто предпочитает систему CentOS:

Установка CentOS 8.

Настройка CentOS 8.

Установка и настройка zabbix сервера.

То же самое на Debian 10, если предпочитаете его:

Установка Debian 10.

Базовая настройка Debian.

Установка и настройка zabbix на debian.

Введение

Отправка только текстовых оповещений
Отправка графиков

Так же можно разделить по типу реализации:

Использовать готового бота
Создать своего бота для уведомлений
Отправлять оповещения себе лично или в группу

Кстати, еще один способ отправки уведомлений из zabbix — с помощью звонка через asterisk. Если вам это интересно, читайте соответствующий материал — оповещения zabbix через asterisk.

Я буду настраивать все в zabbix 3.4, установленный на Centos 7. Принципиального значения это не имеет, решение будет одинаково работать практически на всех дистрибутивах linux.

Установка CentOS 7.

Настройка CentOS 7.

Установка и настройка zabbix сервера.

То же самое на Debian 9, если предпочитаете его:

Установка Debian 9.

Базовая настройка Debian 9.

Установка и настройка zabbix на debian.

Приступим к реализации.

Создание бота в telegram

Первым делом создадим бота, через которого будем слать оповещения из заббикса. Для этого добавляем себе в контакты @BotFather и пишем ему сначала /start, потом /newbot.

Мы создали бота для оповещений и получили для него token, который нам понадобится далее. Теперь нужно добавить в свой список контактов созданного бота. Для этого найдите его по имени. В моем случае имя @serveradmin_zabbix_bot.

Теперь проверим, как работает отправка уведомлений через нашего бота. Для этого в консоли сервера набираем примерно такую команду:

# curl --header 'Content-Type: application/json' --request 'POST' --data '{"chat_id":"210806260","text":"Проверяю отправку оповещений ботом"}' "https://api.telegram.org/bot526250249:AAFtAqy4ln0BqK5vtU_9IoSlLduhtl8IaGg/sendMessage"

Бот пришлет оповещение.

В моем запросе изменяемые данные следующие:

210806260	id моего аккаунта. Чтобы его узнать, добавьте бота @my_id_bot и напишите ему /start
Проверяю работу бота	Текст сообщения
bot526250249:AAFtAqy4ln0BqK5vtU_9IoSlLduhtl8IaGg	Слово bot и дальше token бота. Пишется все в одно слово.

Если все в порядке, двигаемся дальше. Это самая простая часть, тут не должно быть затруднений.

ZABBIX – Создание действия.

Теперь нам необходимо создать так называемое “Действие”, которое при определенных условиях будет использовать наш способ оповещения. Для этого нам нужно перейти на вкладку “Настройка” и в появившейся строке нажать на кнопку “Действия”, как показано на скриншоте ниже.

Как создать действие в ZABBIX – Страница действий

Обратите внимание, что здесь отображается вся информация по действиям, уже имеющимся в системе. Нам нужна кнопка “Создать действие”. В пример я приведу действие “KKT Notification”:

В пример я приведу действие “KKT Notification”:

Как создать действие в ZABBIX – Страница создания

Снова пройдемся по полям:

Имя – видимое имя действия.
Тип вычисления – здесь необходимо выбрать будут складываться ваши условия и выдавать алерт, или если хотя бы одно из условий нарушено, то генерируется алерт.
Условия – условия срабатывания действия.

Далее переходим на вкладку “Операции”. Здесь нам необходимо нажать на кнопку “Новый” в поле “Операции”.

Как создать действие – Новая операция

В появившихся поля нам необходимо указать:

Шаги – количество выполнения данной операции.
Длительность шага – время выполнения 1 шага.
Тип операции – сама операция, это поле уже на ваш выбор.
Отправлять группам пользователей – отправка сразу нескольким пользователям, входящих в указанную группу.
Отправлять пользователям – отправка указанным пользователям. (не забудьте поставить себя и в своем профиле указать свой электронный адрес)
Отправлять только через – способ отправки. (Нам нужен Email)
Условия – дополнительные условия отправки. (Указываем “Событие подтверждено = Не подтверждено”)

Для того, чтобы добавить группу пользователей, пользователя отдельно или дополнительное условие, нажимайте на кнопки в этих полях “Добавить” и “Новый”.

После нажатия кнопки “Добавить”, вас перенесет на страницу действий, где появится только что созданное действие. Теперь нам осталось проверить работоспособность нашего действия. Для этого мне необходимо снова зайти на сервер vtrsagent и выключу блокнот.

После проделанных операций мне пришло письмо на почтовый адрес с содержанием проблемы:

Как создать действие – Письмо от ZABBIX

Выглядит не очень презентабельно, но если вчитаться, то можно понять, что упал блокнот на сервере.

Ну-с, собственно все, могу вас поздравить! Вы только что создали систему оповещения алертов в заббиксе!

Отправка уведомлений в telegram через webhook

Начиная с 5-й версии, в Zabbix из коробки работают уведомления в telegram через механизм webhook. Чтобы настроить его, переходите в Администрирование -> Способы оповещений и выбирайте там Telegram.

Внутри увидите некоторые параметры. Можно так же посмотреть текст скрипта, который используется для отправки оповещений. В целом, тут сейчас не обязательно что-то менять. Дефолтные настройки полностью рабочие. Надо только указать токен бота.

Тут же можете шаблоны поправить так, как вам нравится. Это нововведение 5-й версии Zabbix – правка шаблонов оповещений в настройках самих оповещений. Это позволяет создавать для каждого типа свои шаблоны. Очень удобно.

Давайте теперь проверим отправку уведомлений через этот способ. Нажимайте Тест.

Я указал текст сообщения, заголовок, свой id и token бота. В итоге мне в личку пришло сообщение от бота.

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

Итак, убедились, что сообщения в telegram нормально отправляются. С технической стороны проблем нет. Теперь настроим отправку уведомлений по событиям. Я обычно для этого использую тестовый триггер. В стандартном шаблоне zabbix для OS Linux есть элемент данных Number of logged in users, который считает количество залогиненных пользователей. Я для него делаю триггер, чтобы он срабатывал, когда пользователей 2 и более. И с его помощью тестирую уведомления, просто подключаясь на сервер по ssh двумя подключениями одновременно.

Теперь идем в настройки пользователя и добавляем ему способ оповещений через telegram.

Если у вас ранее не работали никакие уведомления, то не забудьте активировать Действия.

У нас все настроено для отправки оповещений в telegram. Добейтесь срабатывания триггера и проверяйте телеграм канал, в который настроили отправку сообщений.

Все работает. Если вам достаточно такого функционала, то можно оставлять и пользоваться. Но как по мне, так бледновато эти уведомления выглядят. Можно немного шаблоны изменить, чтобы было более читаемо. Так же есть возможность все настроить более красиво и наглядно, да еще и с графиками. Дальше я расскажу еще 2 разных способа отправки уведомлений из zabbix в telegram с графиками и готовыми ссылками на события.

Настройка Zabbix Telegram

Zabbix умеет отправлять оповещения, используя скрипт. Zabbix отправляет 3 параметра: получатель, тема сообщения, текст сообщения.

Создание скрипта

Давайте напишем скрипт, который и будет передавать нам информацию из Zabbix нашему боту, который в свою очередь будет передавать ее нам:

Где $1, $2, $3 переданные Zabbix’ом параметры: получатель, тема сообщения, сообщение.

Данный скрипт сохраняем с произвольным именем, например. telegram.sh в директорию Zabbix’а, где хранятся скрипты уведомлений (в Freebsd по умолчанию это директория: /usr/local/zabbix32/zabbix/alertscripts/ — (Для версии 3.2)

Делаем наш скрипт исполняемым:

Выдаем zabbix права на этот скрипт:

Настройка способа оповещения через telegram

Теперь переходим в веб-интерфейс Zabbix’а и переходим по Меню: «Администрирование» -> «Способы оповещения» и нажимаем «Создать способ оповещения»

Имя — Произвольное

Тип — Скрипт

Имя скрипта — так, как вы назвали скрипт при его создании

Параметры срипта:

(Это как раз и есть наши $1, $2 и $3)

И ставим галочку «Активировано»

И нажимаем Добавить (у меня обновить, так как он уже создан у меня)

Добавление способа оповещения пользователю

Далее заходим в «Администрирование» -> «Пользователи«. Выбираем нашего пользователя и переходим на вкладку «Оповещения» и нажимаем «Добавить»

В появившемся окне выбираем тип — под каким именем мы создали действие, вставляем наш токен, который выдал нам бот и нажимаем «Добавить»

После этого у пользователя в Оповещениях появится новый способ оповещения. Нажимаем «Обновить«.

Теперь нам осталось только создать действий, по которому нам будет приходить какое-либо сообщение.

Настройка действий

Итак, приступим к созданию действия. Для этого переходим в «Настройка» -> «Действия«. Справа вверху где «Источник событий» выбираем» Триггеры. Нажимаем «Создать действие«.

Имя — Пишем любое понятное для нас имя

Условие — Настраиваем условие, при котором будет происходит наше действие (ниже я приведу пример 1 из своих действий)

Выбираем что будет присылаться нам во время срабатывание нашего условия

В операциях нажимаем Новый и добавляем наш способ оповещения:

Должно получиться что то типа вот этого.

На вкдадке Операции восстановления Выбираем в операциях «оповещение о восстановлении», чтобы знать, что проблема ушла.

И нажимаем «Добавить«. В принцип на этом этапе мы уже все настроили!

Telegram ID

Telegram needs to send messages. The easiest way to get this id is using the bot you have just created.

Go to using your browser.

UserID

If you want to get a user id, send a message from this user to the bot. Reload the page and the user id will be shown.

Example:

In this case, the user id is . So, on the step , the field would be .

GroupID

If you prefer to have your bot working on a group, then create the group and add the bot to it. Reload the page and you will see a message like:

In this case, the group id is . So, on the step , the field would be .

Note that a group id is always negative. Only user’s id are positive.

ChannelID

The last alternative is the easiest one. There’s no need to get a channel id. Simply set the field on the step to . The symbol is obligatory.

If this method doesn’t work or if you want to get an id from a private channel, please, visit https://github.com/GabrielRF/telegram-id

Getting started

The only installation required is pyTelegramBotAPI. Choose one of the following methods:

From source

Creating a bot

To create a bot, talk to @BotFather on Telegram.

Send and it will ask the bot’s name. Choose any name.

Then it will ask the bot’s username. The username must end with and is unique.

When everything is done, the @BotFather will display the bot’s token. Save it and keep it secret. Here is an example of a token:

In order to receive messages, the recipient user MUST send a message to the bot at least once.

If a group will be used, add the bot on the group before testing.

For channels, add the bot to the channel as an administrator.

Настройка повторяющегося оповещения

После того, как убедились, что тестовый триггер работает, настроим для него повторяющееся уведомление. Для этого идем в раздел Настройка -> Действия и нажимаем Создать действие.

Во вкладке Действие указываете имя и добавляете тестовый триггер.

Дальше переходим в раздел Операции и указываем длительность шага равное 1 минуте. Добавляем шаг с параметром 1 — 0 и указываем необходимое действие. В примере я просто буду отправлять всем администраторам оповещение на почту.

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

Обращаю внимание, что вы получите оповещение и от стандартного правила, которое шлет один раз и от нового, которое повторяющееся. Чтобы все было красиво и удобно, необходимо отключать стандартное оповещение и создавать свои с определенными правилами в зависимости от типа триггера

Создание бота в telegram

# curl --header 'Content-Type: application/json' --request 'POST' --data '{"chat_id":"210806260","text":"Проверяю отправку оповещений ботом"}' "https://api.telegram.org/bot1393668911:AAHDfgghTHgfhdfyX28R-wxKfvH1WR6-vdNw/sendMessage"

Бот пришлет оповещение.

В моем запросе изменяемые данные следующие:

210806260	id моего аккаунта. Чтобы его узнать, добавьте бота @my_id_bot и напишите ему /start
Проверяю работу бота	Текст сообщения
bot1393668911:AAHDfgghTHgfhdfyX28R-wxKfvH1WR6-vdNw	Слово bot и дальше token бота. Пишется все в одно слово.

Если все в порядке, двигаемся дальше. Это самая простая часть, тут не должно быть затруднений.

Бот

Регистрируем своего бота, для этого пишем в Telegram боту @BotFather

/newbot

BotFather
Alright, a new bot. How are we going to call it? Please choose a name for your bot.

Zabbix

BotFather
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.

имя_вашего_бота

BotFather
Done! Congratulations on your new bot. You will find it at telegram.me/zbxmtbot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands.

Use this token to access the HTTP API:
токен:бота

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

/setuserpic

BotFather
Choose a bot to change profile photo.

@имя_вашего_бота

BotFather
OK. Send me the new profile photo for the bot.

Отправка оповещений в группу

Рассмотрим ситуацию, когда мы хотим отправлять уведомления из zabbix не конкретным людям, а сразу в группу, где будут несколько пользователей. Никаких особых настроек для этого не надо. Просто создайте группу в Телеграме, добавьте в эту группу бота @my_id_bot и напишите /start. Так вы узнаете ID группы. В эту же группу добавьте своего бота.

Теперь ID группы надо использовать в способе оповещения пользователя. Там, где мы раньше использовали ID пользователя, теперь ставим ID группы. Можете либо отредактировать предыдущий способ, либо добавить новый. Я добавлю новый, конкретно проделав следующие действия:

Создал 2 способа оповещения: Telegram private и Telegram group.
Добавил оба этих способа пользователю администратор, указав соответствующие ID.
Добавил оба эти способа в Действия.

Хочу обратить внимание, что ID группы начинается с тире, например -288179672. Я этот момент упустил и долго не мог сообразить, почему в группу не отправляются оповещения. Не знал, что этот символ является неотъемлемой частью

Не знал, что этот символ является неотъемлемой частью.

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

Настройка чата

Прежде чем рассылать сообщения, необходимо узнать chat_id. Это делается один раз для каждого адресата (группы)

Видимо, для избежания рассылки спама, в Telegram Bot API не предусмотрена возможность отправки сообщений по имени или номеру контактна, а так же поиск.

Поэтому, прежде чем бот сможет отправлять сообщения, необходимо первым начать с ним диалог (либо добавить в группу) — и написать любое тестовое сообщение.

Это нужно для того, что бы узнать chat_id.

Есть спец. боты типа @get_id_bot, возможно это удобно, но я бы предпочел обойтись только собственным ботом.

Индивидуальные сообщения

Найти и добавить бота в контанкты
Написать тестовое сообщение в чат
Выполнить скрипт с параметром getid

$: .telegram.sh getid
{"id":227768999,"first_name":"Aleksey","last_name":"K","username":"Aleksey","type":"private"},
{"id":287033399,"first_name":"\u041c\u0430\u043a\u0441\u0438\u043c","last_name":"\u041f","type":"private"},
 
# Русские символы записываются кодами символов Unicode
$: python -c 'print(u"\u041c\u0430\u043a\u0441\u0438\u043c")'
Максим

Отправить ответное сообщение для проверки

$: .telegram.sh 227768999 TEST
OK Message was sent

Групповые сообщения

Что бы бот увидел сообщения в групповом чате ему нужно добавить прав. Проще всего его сделать админом чата.

Написать тестовое сообщение в чат группы
Выполнить скрипт с параметром getid

$: .telegram.sh getid
{"id":-1001134251199,"title":"Monitoring Zabbix","type":"supergroup"},

Отправить ответное сообщение для проверки

$: .telegram.sh -1001134251199 TEST
OK Message was sent

chat_id группового чата начинается с «-»

Настройка уведомлений Zabbix через Telegram

Для настройки будем использовать сервер Zabbix3.2 установленный на CentOs7 и проект «Telegram messenger CLI».

Ставим git

sudo yum install git

Клонируем «Telegram messenger CLI» с github

git clone —recursive https://github.com/vysheng/tg.git

переходим в директорию tg

cd tg

Ставим необходимые зависимости для сборки пакета

sudo yum install gcc libevent-devel openssl-devel \

readline-devel libconfig-devel lua-devel jansson-devel

Собираем telegram-cli

./configure

sudo make

Произведем настройку пользователся Telegram из под которого будем осущевствлять отправку уведомлений.

bin/telegram-cli -k tg-server.pub -W

Telegram-cli version 1.4.1, Copyright (C) 2013-2015 Vitaly Valtman
Telegram-cli comes with ABSOLUTELY NO WARRANTY; for details type `show_license".
This is free software, and you are welcome to redistribute it
under certain conditions; type `show_license" for details.
Telegram-cli uses libtgl version 2.1.0
Telegram-cli includes software developed by the OpenSSL Project
for use in the OpenSSL Toolkit. (http://www.openssl.org/)
I: config dir=[/root/.telegram-cli]
phone number: +7**********
code ("CALL" for phone number): ****
>

Указываем номер телефона для регистрации учетной записи в телеграм и вводим код подтверждения, который будет прислан на указанный номер

Для вызова справки можно использовать команду «help»

Добавляем контакт

> add_contact "телефон" Admin_User

Заметка: Для разделения слов в имени контакта используется знак подчеркивания «_»

Теперь мы можем непосредствено отправлять этому пользователя сообщения

> msg Admin_User "Привет!"

Но скорее всего вы захотите рассылать уведомления в чат, что бы его получали несколько контактов:

> create_group_chat "Имя_чата" список пользователей

> create_group_chat Zabbix_Alert Admin_User Vasya

Мы создали чат с двумя контактами.

Для выхода из консоли используем команду «quit»

В домашней директорий пользователся под которым мы запускали telegram-cli была создана директория .telegram-cli с настройками, перенесем её в домашнюю директорию пользователя zabbix, туда же переносим папку с клонированным с github проектом и выставим на них права.

chown -R zabbix:zabbix /var/lib/zabbix

Создадим скрипт для отправки уведомлений Zabbix

В конфигурационном файле /etc/zabbix/zabbix_server.conf указываем директорию для хранения скриптов

cat /etc/zabbix/zabbix_server.conf

....
AlertScriptsPath=/usr/lib/zabbix/alertscripts
...

Перезапускаем севрер

systemcl restart zabbix-server

Создаем скрипт уведомлений tg.sh

cat /usr/lib/zabbix/alertscripts/tg.sh

#!/bin/bash

to=$1
msg="$2"

tgpath=/var/lib/zabbix/tg
cd $tgpath

(sleep 3; echo "msg $to $msg"; echo "safe_quit") | bin/telegram-cli -k tg-server.pub -W

sleep необходимо для того что бы telegram-cli успел запуститься.

$1,$2 — параметры, которые будет передавать Zabbix при запуске скрипта

Разрешаем выполнение скрипта

chmod +x tg.sh

Теперь переходим к настройки самого Zabbix через веб-интерфейс

Заходим в Administation->Media types

Создаем новый способ оповещения: называем его telegram, указываем имя скрипта tg.sh и задаем два параметра для передачи скрипту, это будет имя кому отправлять и тело сообщения

Далее привязываем способ оповещения к пользователю

Administration->Users->Media

Добавляем способ оповещения: указываем тип — telegram (созданый ранее), куда отправлять (указываем наш чат Zabbix_Alert), указываем время когда можно отправлять оповещения и уровень важности

Все настройка готова.

Скрипт

На Zabbix сервере добавляем скрипт, через который будут отправляться сообщения. KEY, он же токен бота берем из диалога с BotFather.

nano /usr/lib/zabbix/alertscripts/zbxtg.sh

#!/bin/bash

USERID=$1
THEME=$2
BODY=$3

KEY="токен:бота"
TIMEOUT="10"
URL="https://api.telegram.org/bot$KEY/sendMessage"

TEXT="$THEME
$BODY"

PARSEMODE="markdown"

curl -s --max-time $TIMEOUT -d "chat_id=$USERID&disable_web_page_preview=1&parse_mode=$PARSEMODE&text=$TEXT" $URL > /dev/null

Кстати, обратите внимание на вот этот кусочек кода:

TEXT="$THEME
$BODY"

Таким образом обеспечивается перенос строки, я пробовал всякие там <br>, <br />, /n, /r — ничего не работало, а вот такой перенос — работает ;-). И ещё хозяйке на заметку (хотя я это и не использую): All <, > and & symbols that are not a part of a tag or an HTML entity must be replaced with the corresponding HTML entities (< with <, > with > and & with &).

Меняем владельца и делаем скрипт исполняемым.

chown zabbix:root /usr/lib/zabbix/alertscripts/zbxtg.sh
chmod +x /usr/lib/zabbix/alertscripts/zbxtg.sh

Параметрами $1, $2, $3 для скрипта являются получатель, тема и тело сообщения. Вы можете сами проверить как Zabbix будет дёргать скрипт, выполнив команду /usr/lib/zabbix/alertscripts/zbxtg.sh user_id message_theme message_body

"message":{"message_id":14681,"from":{...},"chat":{"id":123456789,"first_name":"REALNAME","username":"NICKNAME","type":"private"},"date":...

Где «chat»:{«id»:123456789 и будет user id. Для группы:

"message":{"message_id":14686,"from":{...},"chat":{"id":-12345678,"title":"GROUPNAME","type":"group"},"date":...

Где user id будет: «chat»:{«id»:-12345678

Заметка: чтобы добавить бота в группу, нужно нажать на название группы в Telegram, выбрать Добавить участников и в поиске набрать имя_бота.

ZABBIX – Создание способа оповещения.

ZABBIX – Как создать способ оповещения

Как видите не всегда для настройки используется сочетание “Настройка” – > “Узлы сети”, сегодняшний случай – исключение :). Давайте двигаться дальше. На появившейся странице в правом верхнем углу нажимаем на кнопку “Создать способ оповещения”, после чего попадаем на страницу создания.

Как создать способ zabbix оповещения –Страница создания

Как всегда пробежимся по предлагаемым полям:

Имя – видимо имя способа оповещения
Тип – способ доставки оповещения
SMTP сервер – почтовый сервер, который необходим для отправки оповещения.
SMTP email – адресат, от которого заббикс будет высылать оповещение.

Остальное можно оставить без изменений. (Но опять же зависит от ваших задач, не забываем, что мы в статьях стараемся как можно быстрее развернуть мониторинг). Нажимаем кнопку “Добавить”, после чего попадаем на страницу способов оповещений, где уже имеется наш способ, который мы только что добавили.

Заключение

Теперь у нас zabbix работает современно, модно, молодежно ? Использует telegram для отправки оповещений с графиками. Функционал удобный и настраивается достаточно просто. У меня практически не было затруднений, когда разбирал тему. Возьму себе на вооружение и буду по необходимости использовать. Хотя сам не люблю оповещения в телеграме, и чаще всего их отключаю, как и от остальных программ. Не нравится, когда меня в каждую минуту могут отвлечь какие-то события. Проверка почты раз в 30 минут самая подходящая интенсивность для меня.

Тем не менее, при работе коллектива, оповещения в общую группу могут быть очень удобны. Особенно, если только на мониторинге сидят отдельные люди, в чью задачу входит оперативная реакция на события.