Еще не бот, но уже что-то ― получаем уведомления от Zabbix в мессенджеры

Вы хотите получать уведомления с Zabbix
через Telegram
? Нет ничего проще!

Есть для этого готовый бот
и Telegram API

Бот присылает все, что было в специальном HTTP GET
запросе вида:

http://crierbot.appspot.com/@token@/send?message=@message@

TOKEN
— токен выданный ботом при его добавлении в список контактов Telegram

MESSAGE
— собственно сообщение, которые хотите передать.

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

Добавление бота

Для начала добавляем себе в Telegram бота @crierbot и нажимаем START

После нажатия на START
 
бот пришлет нам уникальный ключ «Token
»

Ну вот и все. На этом наше общение с ботом окончено. Теперь только он нам будет писать то, что нам необходимо.

Настройка Zabbix Telegram

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

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

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

#!/bin/bash  PATH=$PATH:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin  wget -O /dev/null "http://crierbot.appspot.com/$1/send?message=Subj: $2 || Message:$3"

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

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

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

chmod +x /usr/local/zabbix32/zabbix/alertscripts/telegram.sh

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

chown zabbix:zabbix /usr/local/zabbix32/zabbix/alertscripts/telegram.sh

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

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

Тут заполняем:

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

Тип
— Скрипт

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

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

{ALERT.SENDTO}

{ALERT.SUBJECT}

{ALERT.MESSAGE}

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

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

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

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

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

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

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

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

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

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

Действие
:

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

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

Операции
:

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

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

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

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

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

Заключение

Вот пример одного из моих действий. У меня есть триггер на температуру CPU моего NAS
. Его я и использовал:

Вот что мы в принципе видим в окне самого Telegram
:

Собственно ничего сложного нет. Это настроить гораздо быстрее чем все это прочитать или тем более все это написать. Если возникнут трудности — пишите в комментарии. Постараюсь помочь.

Установка каких либо дополнительных программ и библиотек меня вообще не впечатлила. Да и зачем всё это если можно использовать Telegram-бота и отправлять сообщения простым запросом

Первый шаг
Необходимо создать бота в Telegram. Для этого нужно добавить в список контактов бота @BotFather, сказать ему /start и /newbot BotFather сперва спросит как назвать нового бота, а потом какое имя ему присвоить. В ответном сообщении вы получите всю необходимую информацию для его использования Вы можете создать своего бота, а можете использовать моего Познакомьтесь, его зовут @TradeNarK_ZabbixBot его токен 256070243:SHAAHonjepm7mzR6doFLgSNAbKg3BNJzQQm Этого бота необходимо добавить либо к себе в список контактов либо в тот чат, куда вы планируете получать уведомления. Эта информация нам пригодится немного позже.

Второй шаг
Для того что бы отправить сообщение себе или в чат необходимо знать ID чата или контакта Сразу замечу, что по ID можно определить пользователь это или чат — ID чата начинается со знака «-» (минус) Для того что бы определить ID есть специальный бот @MyTelegramID_bot. Его нужно добавить с себе в список контактов или же в чат и дать команду /start. В ответ он предоставит ID Мой список контактов Чат для уведомлений Как и говорилось выше ID группы начинается со знака минус

Третий шаг
Для отправки сообщения достаточно выполнить зарос

# curl --header 'Content-Type: application/json' --request 'POST' --data '{"chat_id":"_ID_","text":"_MESSAGE_"}' "https://api.telegram.org/bot_TOKEN_/sendMessage"

Запрос приобретает вид:

# curl --header 'Content-Type: application/json' --request 'POST' --data '{"chat_id":"1111111","text":"test message for blog https://tradenark.com.ua here"}' "https://api.telegram.org/bot256070243:SHAAHonjepm7mzR6doFLgSNAbKg3BNJzQQm/sendMessage"

и бот присылает сообщение Убедившись что вся эта кухня работает нужно написать скрипт который поможет нам в отправке. Смотрим дефолтное расположение скриптов для отправки

# grep -i AlertScriptsPath /etc/zabbix/zabbix_server.conf | grep -v ^# AlertScriptsPath=/usr/lib/zabbix/alertscripts

Теперь создаём скрипт в этой папке с таким содержимым:

# cat /usr/lib/zabbix/alertscripts/telegram_bot.sh #!/bin/bash  TOKEN='256070243:SHAAHonjepm7mzR6doFLgSNAbKg3BNJzQQm'  if [ $# -ne 3 ] ; then echo 'Error! You must to define three params' && exit 1 ; fi  CHAT_ID="$1" SUBJECT="$2" MESSAGE="$3"  # Определяем emoji для темы сообщения if [[ $SUBJECT == 'PROBLEM' ]] then         ICON="uD83DuDE31" elif [[ $SUBJECT == 'OK' ]] then         ICON="uD83DuDC4C" else         ICON="u26A0" fi  curl -s --header 'Content-Type: application/json' --request 'POST' --data "{"chat_id":"${CHAT_ID}","text":"$ICON ${SUBJECT}n${MESSAGE}"}" "https://api.telegram.org/bot${TOKEN}/sendMessage" | grep -q '"ok":false,'

Тут я добавил немного «развлекухи». В зависимости от темы бот будет добавлять смайлик. Как оказалось это одна из самых сложных задач. По той причине что вместо смайликов отображался текст / чистый код Решение всё же нашлось. Для этого необходимо выбрать смайлик и определить его Unicode-формат. К примеру для обычного улыбающегося смайлика 🙂 это будет U+1F601
. Теперь на сайте fileformat.info нужно найти его перекодированное значение. Для этого переходим по ссылке http://www.fileformat.info/info/unicode/char/1F601
/index.htm и находим строку «C/C++/Java source code». В случае улыбающегося смайлика это будет «uD83DuDE01» Сохраняем и делаем его исполняемым:

# chmod +x /usr/lib/zabbix/alertscripts/telegram_bot.sh

Четвёртый шаг
Необходимо научить заббикс пользоваться нашим скриптом. Для этого нужно создать новый способ оповещения с несколькими параметрами: Называем его как нам угодно. В поле «Имя», что бы не путаться, я использую Telegram Bot Тип указываем «Скрипт» В поле «Имя скрипта» вписываем только telegram_bot.sh так как скрипт находится в специально созданной для этого папке Так же добавляем три дополнительных параметра как на скриншоте: {ALERT.SENDTO} — кому отправлять; {ALERT.SUBJECT} — тема сообщения; {ALERT.MESSAGE} — текст самого сообщения; После этого нажимаем «Добавить».

Пятый шаг
Идем в «Администрирование» — «Пользователи». Выбираем нашего пользователя — вкладка «Оповещения» — «Добавить». В поле «Тип» выбирает тот тип, который мы создали (у меня Telrgram Bot). В поле «Отправлять на» указываем свой ID или ID чата со второго шага. Остальные параметры на своё усмотрение.

Шестой шаг
Идем «Настройка» — «Действие». В графе «Источник событий» выбираем «Триггеры» и нажимаем создать. Во вкладке «Действие» настраиваем шаблон уведомлений. Я использую довольно сокращенный вариант по сравнению с предлагаемым по умолчанию: Поле «Тема» — {TRIGGER.STATUS} Поле «Сообщение по умолчанию» — {HOST.HOST} | {HOST.IP} | {TRIGGER.NAME} -> {ITEM.VALUE} Во вкладке «Операции» жмём «Новый». В открывшемся окне нас интересуют три главных пункта: Тип операции — отправить сообщение; Отправлять пользователям — выбираем своего пользователя; Отправлять только через — выбираем метод, созданный на четвертом шаге; В итоге получаются довольно информативные и короткие уведомления: Так же у меня настроены уведомления о авторегистрации:

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

Получать уведомления в такой корпоративный мессенджер как Slack действительно удобно, а благодаря открытому API ― еще и просто. С API можно познакомиться в официальной документации, я же покажу пару примеров реализации.

Самым простым решением станет интеграция с мессенджером через механизм Webhook. Для начала нужно получить на сайте сервиса в разделе Incoming WebHooks специальный адрес, на который можно отправлять запросы хоть обычным curl
. Также там можно будет выбрать иконку и канал для отображения сообщений по умолчанию.

Получаем URL для отправки запросов.

Теперь нужно добавить в Zabbix скрипт ― по умолчанию это папка /usr/local/share/zabbix/alertscripts
, ― разрешить его выполнение и настроить в нем необходимые параметры. Со скриптом и подробными инструкциями по настройке можно ознакомиться на GitHub в репозитории zabbix-slack-alertscript.

Уведомления в Slack.

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

Ознакомиться с исходным кодом бота и подробной инструкцией по настройке можно в репозитории zabbix-notify на GitHub. Помимо Slack, этот бот поддерживает уведомления в HipChat, создание новых инцидентов и разрешение старых в системе управления инцидентами PagerDuty.

Получать уведомления в этот популярный, но заблокированный на территории РФ, мессенджер тоже удобно, благо открытый API это позволяет. Ознакомиться с возможностями автоматизации можно в документации на официальном сайте.

Для самого простого решения нужно получить свой токен для запросов при помощи «Отца Ботов» ― @BotFather
. При помощи команд /start
и /newbot
главный бот выдаст заветный токен.

Получаем токен для нашего бота-уведомлятора.

Теперь можно отправлять сообщения запросами через curl. В качестве усложненной реализации можно привести в пример бота, отправляющего не только уведомления, но и графики. Завести себе бота поможет GitHub-репозиторий Zabbix-in-Telegram.

С подробной инструкцией к простому и чуть более сложному скрипту можно ознакомиться в материале «Отправка уведомлений и графиков из Zabbix в Telegram».

Этот мессенджер, к сожалению, не имеет документированного публичного API и борется со скриптами на GitHub в рамках «борьбы со спамом». Но выход есть. Можно использовать штатное решение «прямая связь», описанное в официальном FAQ. Но тогда понадобится держать инстанс WhatsApp Web. Аналогично сработает обвязка автокликером веб-версии или десктопного приложения.

Чуть более интересным вариантом будет использование консольного «мессенджера» yowsup
. Сам мессенджер доступен в одноименном репозитории GitHub.
Пока решение работает. Но если WhatsApp вдруг решит поменять свой API, то для адаптации понадобится время.

Отправка сообщений через консоль.

Подробнее с настройкой консольного скрипта и Zabbix можно ознакомиться в статье «Получаем уведомления от Zabbix в WhatsApp».

Если ваш дежурный инженер проводит в соцсетях немало времени, то можно отправлять уведомления ему прямо в сообщения (или на стену) ВКонтакте.

Сначала нам понадобится создать свое приложение в соцсети ― для получения токена. Сделать это можно в разделе «Мои приложения». После создания нового приложения нам нужно скопировать его ID в разделе «Настройки» и перейти по ссылке:

https://oauth.vk.com/authorize?client_id=appid&scope=notify,photos,friends,audio,video,notes,pages,docs,status,questions,offers,wall,groups,**messages**,notifications,stats,ads,offline&redirect_uri=http://api.vk.com/blank.html&display=page&response_type=token

Разумеется, вместо appid
нужно подставить свой ID. А если нужно просто отправлять сообщения ― без оповещения друзей инженера, если он сам не отвечает, ― то в параметрах достаточно задать messages
.

После подтверждения доступа в адресной строке появится подобный адрес:

https://api.vk.com/blank.html#access_token=81eff38378a3bbbcb5c7043a152a69fd04dca057ac821dd7afd7c2d8e35b60172d45a26599c08034cc40a&expires_in=0&user_id=123456

Где в значении параметра access_token
будет необходимый нам токен.

Теперь при помощи обычного curl
можно слать сообщения, а с оберткой из простого скрипта это сможет делать и Zabbix.

С пошаговой настройкой уведомлений и вариантом реализации скрипта можно ознакомиться в статье «Прикручиваем к Zabbix оповещения в VKontakte».

Если некоторое ретроградство вам не чуждо, то еще остался Jabber. Получать уведомления в старый любимый мессенджер Zabbix позволяет «из коробки». Для этого достаточно настроить аккаунт в свойствах оповещений:

Настройка аккаунта Jabber.

И указать нужные JID в свойствах пользователей. Подробнее можно ознакомиться в официальной документации Zabbix в разделе Jabber. Я же добавлю, что если предварительно аккаунт Jabber зарегистрировать в нужных транспортах, то можно отправлять сообщения в ICQ, IRC и прочий агент Mail.ru.

Если не зацикливаться на модных и не очень мессенджерах, то можно получать уведомления и просто через технологию push. Она поддерживается не только в мобильных устройствах, но и в любой Windows 10, а также в браузерах Chrome и Firefox.

Тут нам придется или развертывать свой сервер и приложения для отправки сообщений, или воспользоваться платными сервисами вроде Pushbullet, Pushsafer или Pushover. Методика схожа с остальными: регистрируемся, получаем токен, ставим приложения или расширения браузера и шлем сообщения хоть многострадальным curl.

Выбор конкретного сервиса зависит от ценника. В общем и целом все они работают примерно одинаково. Некоторые сервисы предоставляют ограниченное количество бесплатных сообщений ― например, у Pushbullet это будет 100 сообщений в месяц.

Push уведомления на Android.

С примером конкретных реализаций можно ознакомиться:

  • в материале «Zabbix + Pushbullet: простой способ push-оповещения»;
  • в разделе Zabbix документации Pushsafer;
  • в репозитории zabbix-alertscripts на GitHub.

Уведомления в мессенджеры на телефоны ― это, конечно, хорошо. Но только до тех пор пока у сервера Zabbix есть выход в интернет. Для гарантированного получения уведомлений при сбоях в сети лучше использовать традиционные каналы связи.

Zabbix «из коробки» поддерживает возможность отправлять SMS. К сожалению, он умеет это делать только через последовательный интерфейс. Если у вас завалялся Siemens MC35 или что-то подобное, то с настройками отправки СМС можно ознакомиться в документации Zabbix в разделе SMS.

Помимо такого архаичного варианта, можно воспользоваться сервисом для отправки СМС вроде sms.ru. Благо они все поддерживают разного рода API. Некоторые предоставляют и e-mail шлюз, и для настройки уведомлений не понадобится писать скрипты. Самое главное при выборе шлюза ― проверить его на предмет задержек доставки СМС.

Настройка скрипта для уведомлений по СМС.

С примером настройки Zabbix можно ознакомиться в статье «Бесплатная отправка SMS-уведомлений в Zabbix».

Отправка СМС через внешний шлюз не решит проблему отсутствия интернета на сервере в отличие от отправки через аппаратные устройства с симкой. В качестве бюджетного варианта можно использовать USB-модем ― например, Huawei e1550.

Пошаговую инструкцию можно посмотреть в материале «Оповещения Zabbix через sms, используя GSM модем. Простая настройка».

СМС можно пропустить запросто, а вот телефонный звонок ― уже сложнее. Поэтому для особо срочных уведомлений можно настроить Zabbix на телефонные звонки. Выходов, как обычно, несколько.

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

Пример реализации детально описан в статье «Оповещения из Zabbix телефонным звонком».

Альтернативным вариантом станет использование своей АТС на базе Asterisk и обращение к ней с помощью специальных call-файлов или по интерфейсу AMI. Тогда, при наличии независимого от интернета канала связи вроде аналоговой линии или потока Е1, можно будет выслушать проблемы вашего сервера.

Описание решения доступно в материале «Оповещение о проблемах Zabbix по телефону через Asterisk».

В статье я постарался привести ссылки на основные решения для уведомлений инженеров о проблемах. Главное, при проектировании системы мониторинга учесть возможность отсутствия интернета и не забыть про дублирующую систему, ответив себе на извечный вопрос «Quis custodiet ipsos custodes?
». И, конечно же, не нужно превращать сервер мониторинга в спамера, иначе уведомления станут бессмысленны.

Если вы используете какой-то другой способ оповещения ― мы ждем его в комментариях.

Рейтинг автора
5
Подборку подготовил
Андрей Ульянов
Наш эксперт
Написано статей
168
Ссылка на основную публикацию
Похожие публикации