Zabbix оповещение whatsapp — Получаем уведомления от Zabbix в WhatsApp

В сети можно найти множество способов получения уведомлений от Zabbix. Мне показалось удобным получать алерты в WhatsApp — это дешевле, чем sms и, в моем случае, удобнее, чем почта — для получения уведомлений у нас используется корпоративный почтовый аккаунт, доступ к которому извне ограничен, к тому же, алерт может затеряться среди остальных писем. Настройка довольна проста. Нам понадобится:

1) yowsup и его зависимости: 1.1) python 2.6+ 1.2) python-dateutil 1.3) argparse for python < 2.7 1.4) libxml2, если yowsup будет использоваться со старой версии API (флаг —v1) 2) Доступ сервера Zabbix к сети интернет 3) Телефон с SIM-картой, на номер которой будет зарегистрирован аккаунт WhatsApp

Шаг 1: Установка зависимостей yowsup

Прежде всего нужно установить зависимости для yowsup.

В Debian-подобных дистрибутивах или использующих формат пакетов DEB это делается так:

В дистрибутивах на базе RedHat или использующих формат пакетов RPM:

В моем случае в репозитории не оказалось пакета python-argparse, пришлось скачать его отдельно и установить вручную. Для RHEL 6 это можно сделать, например, здесь

Установка:

Шаг 2: Установка yowsup

После установки зависимостей ставим сам yowsup. Официальная страница проекта расположена на GitHub. Непосредственно с сервера Zabbix’а yowsup можно скачать таким образом:

Распаковываем архив и переходим в директорию yowsup-master/src:

Копируем пример конфига в рабочий конфиг:

В нем всего четыре строчки:

cc — это код страны. Список кодов можно найти на странице СountryСode.org. Код России — 7;

phone — номер телефона, к которому будет привязан аккаунт WhatsApp. Должен начинаться с кода страны;

id — это поле нужно в том случае, если Вы хотите использовать существующий аккаунт WhatsApp и старую версию API (запуск yowsup с флагом —v1). Если аккаунт был создан на устройстве Nokia или Android, то в поле id нужно написать IMEI устройства. Если на устройстве на базе iOS, то нужно писать MAC-адрес интерфейса WLAN. В новых версиях API это поле не используется, можно оставить его пустым;

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

Итак, заполняем поля конфига:

Далее нужно пройти процедуру регистрации, в течение которой на номер телефона, указанный в конфиге, придет sms с кодом подтверждения. Вообще, проблем на этом шаге возникнуть не должно. Убедитесь, что сервер Zabbix’а имеет доступ на сервера WhatsApp по протоколу https. Если Zabbix стоит за фаерволом и политика безопасности не позволяет открыть ему полный доступ в интернет, получить список адресов можно, запустив tcpdump на сетевом интерфейсе сервера и посмотреть куда обращается yowsup, запустив процедуру регистрации. Не буду останавливаться на этом подробно, мануалов по tcpdump в сети много, скажу лишь, что мне пригодилась такая команда (весь tcp трафик на интерфейсе eth0, который не ходит в пределах локальной сети 10.0.0.0/8):

Отправляем запрос на регистрацию:

Если все прошло нормально, нам придет sms с шестизначным кодом подтверждения (например, 123-456). Отправляем этот код на сервер WhatsApp:

После этого в поле password нашего конфига должен появиться пароль. На этом процедура регистрации завершена, можно попробовать отправить сообщение другому пользователю WhatsApp.

Отправить сообщение можно командой

Принять сообщение:

А можно вообще в режиме чата переписываться:

image

На этом настройка yowsup закончена.

Шаг 3: Пишем скрипт отправки алертов

Чтобы подружить yowsup и Zabbix, надо написать скрипт отправки уведомлений. Напомню, что Zabbix берет скрипты уведомлений из директории, определенной в переменной AlertScriptsPath конфига zabbix_server.conf. В моем эта директория располагалась в /usr/local/share/zabbix/alertscripts:

Кладем туда скрипт (я назвал его whatsapp), состоящий буквально из трех строчек:

Я положил файлы yowsup в директорию alertscripts — может быть, это не самое лучшее решение, но мне показалось, что так удобнее будет искать конфиги/скрипты в случае чего.

$1 $2 $3 — это значение переменных Zabbix, означающие, соответственно, «кому отсылать уведомление», «тема» и «тело уведомления». Мы настроим эти поля далее из интерфейса Zabbix.

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

Шаг 4: Настраиваем Zabbix

Действуем по стандартному алгоритму:

1) Создаем способ оповещения 2) Создаем действие, связанное с этим оповещением 3) Подключаем уведомление пользователям

1) Создаем способ оповещения

В меню Администрирование -> Оповещения (Administration -> Media types) нажимаем кнопку Создать способ оповещения (Create media type).

Получаем уведомления от Zabbix в WhatsApp

Имя (Name): Любое по Вашему желанию Тип (Type): — Скрипт (Script) Имя скрипта (Script Name): — Должно совпадать с именем скрипта, созданного на предыдущем шаге (whatsapp в нашем случае)

2) Создаем действие

По умолчанию в Zabbix настроено действие, которое делает рассылку всем администраторам всеми видами оповещений:

Получаем уведомления от Zabbix в WhatsApp

Если такого действия у Вас нет, то нужно создать свое. Меню Настройка -> Действия (Configuration -> Action), создаем новое действие кнопкой Создать действие (Create Action).

Получаем уведомления от Zabbix в WhatsApp

На вкладке Действие (Action) можно определить формат сообщения, которое будет отсылаться в WhatsApp. Я оставил всё по умолчанию

Получаем уведомления от Zabbix в WhatsApp

На вкладке Условия (Conditions) настраиваются условия, при которых будет выполняться действие. Тоже оставил по умолчанию.

Получаем уведомления от Zabbix в WhatsApp

Ну и на вкладке Операции (Operations) мы указываем что должен делать Zabbix: отправить сообщение (Send message) группе пользователей или отдельному пользователю способом оповещения WhatsApp.

Сохраняем настройки и переходим к следующему шагу.

3) Подключаем уведомление пользователям

Заходим в настройки пользователя (Администрирование -> Пользователи или Administration -> Users), выбираем нужного пользователя и настраиваем ему Способ оповещений (Media):

Получаем уведомления от Zabbix в WhatsApp

Тип оповещения (Type): WhatsApp Отправлять на (Send to): Номер телефона с кодом страны (например, 79123456789) Выбираем время, когда можно присылать сообщения и степень их критичности. Сохраняем настройки.

На этом настройка закончена, но еще нужно проверить, что сообщения уходят и успешно доставляются. Можно проследить за отправкой уведомлений в меню Администрирование -> Аудит (Administration -> Audit), выбрав пункт Действия (Actions):

Поделиться:
Нет комментариев

Добавить комментарий

Ваш e-mail не будет опубликован. Все поля обязательны для заполнения.

Этот сайт использует Akismet для борьбы со спамом. Узнайте как обрабатываются ваши данные комментариев.