Настройка SMS уведомлений в zabbix

Вопрос SMS уведомлений в zabbix уже освещался на Хабре и проблема решалась с использованием СМС-шлюзов. Также упоминали про Отправку SMS c помощью Delphi. Я же хочу рассказать, как настроить SMS уведомления используя USB модем.
Итак, что имеем:

1) довольно обширная ИТ-инфраструктура

2) система мониторинга Zabbix 2.0.3 (актуальная версия на момент написания статьи) функционирующая под Fedora 14 x64

3) 3G USB модем ZTE MF100 от национального украинского оператора Киевстар.

4) Prepaid симка, которая шла в комплекте с модемом.

Также для модема была куплена корпоративная 3G симка, но её использовать не получится, так как с 3G-карточек невозможно позвонить и отправлять смс, а это нам не подходит.Итак, положил на карточку небольшую сумму «для опытов», втыкнул модем в USB и .

Установка необходимого

Первым делом я зарегистрировал карточку в системе Мой Киевстар. Через неё удобно смотреть остаток денег на счёте модема и заказывать доп. услуги.Напомню, что я все действия провожу в Fedora. Для других линуксов комманды могут отличаться, но думаю выяснить, чем из заменить для вас не составит труда. Также не буду рассматривать вариант установки необходимого из исходников, хотя так тоже можно поступить. Ограничусь установкой существующих стандартных пакетов:

sudo yum install usb_modeswitch # для поддержки USB-модемов Huawei, T-Mobile, Vodafone, Option, ZTE, Novatel sudo yum install minicom        # для терминального подключения к модему по /dev/ttyUSB* sudo yum install smstools  # собстветвенно пакет для работы с смс.  

Теперь проверим, появился ли модем

ls -l /dev/ttyUSB* 

Результат должен выглядеть примерно так

crw-rw----. 1 root dialout 188, 0 Oct 22 12:05 /dev/ttyUSB0 crw-rw----. 1 root dialout 188, 1 Oct 22 15:56 /dev/ttyUSB1 crw-rw----. 1 root dialout 188, 2 Oct 22 12:05 /dev/ttyUSB2 

Модем создал 3 виртуальных USB порта. В моем случае для AT команд доступны ttyUSB1 и ttyUSB2. Если модем создал 5 и более виртуальных портов, то их количество можно уменьшить до 3х. Для этого нужно отключить в нём режимы cdrom и flash-drive. Выключение делается коммандой AT+ZCDRUN=E, включение AT+ZCDRUN=F. Если хотим отключить только cd-rom, то AT+ZCDRUN=8. Если хотим включить обратно — AT+ZCDRUN=9.Запускаю терминал

minicom -D /dev/ttyUSB1 

вижу приветствие

 Welcome to minicom 2.5  OPTIONS: I18n Compiled on Feb 24 2011, 11:25:55. Port /dev/ttyUSB1  Press CTRL-A Z for help on special keys  AT S7=45 S0=0 L1 V1 X4 &c1 E1 Q0 OK  

выключаю CD-ROM

>AT+ZCDRUN=8 Close autorun state result(0:FAIL 1:SUCCESS):1  OK  

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

>AT+ZSNT? +ZSNT: 1,0,0  OK 

в моем случае — =1,0,0 — Автоматический выбор только GSM сети. Поскольку я использую обычную, а не 3G симку, этот режим меня полностью устраивает. Также существуют следующие варианты режима работы:

AT+ZSNT=0,0,0 (Авто) - по умолчанию AT+ZSNT=0,0,1 Автоматический выбор сети: GSM+WCDMA, предпочтение GSM AT+ZSNT=0,0,2 Автоматический выбор сети: GSM+WCDMA, предпочтение WCDMA AT+ZSNT=1,0,0 Автоматический выбор сети: только GSM AT+ZSNT=2,0,0 Автоматический выбор сети: только WCDMA   AT+ZSNT=0,1,0 Ручной выбор сети: GSM+WCDMA AT+ZSNT=1,1,0 Ручной выбор сети: только GSM AT+ZSNT=2,1,0 Ручной выбор сети: только WCDMA 

Проверим, установлена ли защита пин-кодом

>AT+CPIN?  +CPIN: SIM PIN  OK  

Если она включена, то для продолжения работы нам необходимо его ввести

>AT+CPIN=”1234″  OK  

проверим ещё раз

>AT+CPIN?  +CPIN: READY  OK   

Теперь пин-код принят. Посмотрим уровень сигнала

>AT+CSQ +CSQ: 21,99  OK  

получим версию IMEI модуля

>AT+GSN 359518034903581  OK  

Посмотрим тип регистрации в сети

>AT+CREG? +CREG: 0,1  OK 

0 означает, что нет сообщения о сменен регистрации в сети1 — успешно зарегистрирован в сетиПосмотрим информацию об операторе

>AT+COPS? +COPS: 0,0,"Kyivstar",0  OK  

Первый 0 означает автоматический выбор сети, длинный тестовый формат имени (второй 0), и само названия оператора — Киевстар.проверим, установлен ли у нас и какой именно центр отправки смс (Service Center Address)

AT+CSCA? +CSCA: "+380672021111",145  OK 

Для Киевстара это правильный номер.Теперь попробуем отправить сообщение. Перед отправкой сообщения нужно установить формат сообщения. Делается это коммандой AT+CMGF=x. где x — формат сообщений, 0-1.0, — режим PDU, управление кодом команды. Вывод сообщения в HEX коде. Режим по умолчанию1, — текстовый режим. Команды текстовые. Вывод сообщения в текстовом виде.В первый режиме сообщения будут выдаваться в виде шестнадцатеричных кодов ascii или unicode.Это очень неудобный режим.Отправка смс делается командой AT+CMGS=«ХХХХХХХХХХХ», где ХХХХХХХХХХХ — номер абонента. Отправка смс зависит от формата сообщения. После ввода команды выдает приглашение ">" после чего можно вводить текст сообщений. Завершается символом ESC или Ctrl-Z. Отправим сообщение используя текстовый режим и предварительно насильно установив SCA:

AT+CMGF=1 OK AT+CSCA= "+380672021111" OK AT+CMGS="+38067xxxxxxx" > test message >  +CMGS: 110  OK 

Смс успешно пришла.Можно отправлять смс предварительно записав в память:

AT+CMGW="91234567"<CR>Sending text messages is easy.<Ctrl+z>  AT+CMSS=3 

При работе с AT командами не всегда всё проходит гладко. Иногда комманды выполняются с ошибками, возвращая трехзначный код ошибки. Вот список основных кодов ошибок:

Error code 	Meaning  0-127 	GSM 04.11 Annex E-2 values  128-255 	GSM 03.40 section 9.2.3.22 values  300 	Phone failure  301 	SMS service of phone reserved  302 	Operation not allowed  303 	Operation not supported  304 	Invalid PDU mode parameter  305 	Invalid text mode parameter  310 	SIM not inserted  311 	SIM PIN necessary  312 	PH-SIM PIN necessary  313 	SIM failure  314 	SIM busy  315 	SIM wrong  320 	Memory failure  321 	Invalid memory index  322 	Memory full  330 	SMSC (message service center) address unknown  331 	No network service  332 	Network timeout  500 	Unknown error  512 	Manufacturer specific

Настройка smstools

Теперь настраиваем SMS Tools. Правим конфиг /etc/smsd.comf. Привожу готовый конфиг с комментариями:

#используемые устройства, если несколько — пишем через запятую devices = GSM1 #папки для сохранения смс incoming=/var/spool/sms/incoming outgoing=/var/spool/sms/outgoing checked=/var/spool/sms/checked sent=/var/spool/sms/sent # лог, если не указан — пишется в syslog, если = 1, пишет в stdout logfile = /var/log/smsd/smsd.log #уровень логирования loglevel = 5 #debug = 7 user = sms #включаем "умный" лог smart_logging = yes #скрипт, выполяющийся перед отправкой смс для автоматической конвертации кириллических сообщений в "правильную" кодировку. о нём подробнее ниже checkhandler = /etc/smsd/check.sh #скрипт, выполняющийся после отправки смс и создающий лог отправленного. о нём подробнее ниже eventhandler = /etc/smsd/trsms.sh  [GSM1] #используемое устройство device = /dev/ttyUSB1 #пин-код pin = 1111 #SCA smsc = 380672021111 

Подробнее обо всех параметрах конфига можно прочитать на официальном сайте smstool.

Скрипт trsms.sh

Теперь создаем скрипт /etc/smsd/trsms.sh, который будет писать лог отправленных смс. Причём все кириллические сообщения будут попадать в него в читаемой кодировке. Не забываем дать права на выполнение скрипта пользователю smstool и на запись в лог /var/log/smsd/sms.log

chown  smstools:smstools /etc/smsd/trsms.sh chmod gu+x /etc/smsd/trsms.sh chmod gu+w /var/log/smsd/sms.log 

Сам скрипт:

status="$1" file="$2" touch /etc/smsd/ok case "$1" in  SENT)       FILE=`mktemp /tmp/smsd_XXXXXX`        head -5 $file | grep -e "^To: " -e "Alphabet: " -e "^Sent: " >> /var/log/smsd/sms.log       if grep "Alphabet: Unicode" $file >/dev/null; then          tail -n +6  $file | iconv -f UCS-2BE -t UTF-8  >> /var/log/smsd/sms.log       else         tail -n +5 $file >> /var/log/smsd/sms.log       fi         echo >> /var/log/smsd/sms.log         echo "========================================" >> /var/log/smsd/sms.log         echo >> /var/log/smsd/sms.log         ;; esac 

Кстати, под Ubuntu не работают конструкции типа “tail +13”, вместо неё нужно писать “tail -n +13”.Пример части лога:

========================================  To: 38067XXXXXXX Alphabet: Unicode Sent: 12-10-23 21:07:29 test message  ========================================  To: 38093XXXXXXX Alphabet: Unicode Sent: 12-10-19 12:16:28 лог пишет теперь и на русском  ========================================  

Скрипт check.sh

SMSTools умеет обрабатывать события при помощи внешних программ, Наш скрипт поможет отправлять русские смс в правильной кодировке проверяя сообщения перед отправкой (за прототип был взят unicode2sms из стандартного пакета скриптов, который можно найти в /usr/bin. Аналогично, не забываем дать права на выполнение скрипта пользователю smstool

chown  smstools:smstools /etc/smsd/check.sh chmod gu+x /etc/smsd/check.sh 

Сам скрипт:

 # checkhandler for SMS Tools 3 # autoconverts cyrillic messages to UCS-2BE # add checkhandler=/path/to/ucsautoconvert into global part of smsd.conf # written by lexy (lexy@mrlexy.ru), 2008  FILE=`mktemp /tmp/smsd_XXXXXX`  if [ ! `grep '[А-Яа-я]' $1 > /dev/null` -o `grep 'Alphabet:\s*U' $1 > /dev/null` ]     then exit 0 fi  cat $1 | awk '{if(NF==0) {s=1} if(s==0 && NF>0 && $0!~/Alphabet:[ \t]*U/){print}}' > $FILE echo Alphabet: Unicode >> $FILE cat $1 | awk '{if(NF==0) {s=1} if(s==1){print}}' | iconv -t UCS-2BE >> $FILE  mv $FILE $1 chmod 664 $1  

теперь всё готово к запуску.

>service smsd start Starting smsd:                                             [  OK  ] 

проверяем, запустился ли

> ps ax | grep smsd  1345 ?        Ss     0:00 /usr/sbin/smsd  1347 ?        S      0:00 /usr/sbin/smsd  2322 pts/2    S+     0:00 grep --color=auto smsd 

пробуем отправить сообщение. номер абонента указываем в международном формате, но без знака «+»

smssend "38067XXXXXXX" "test message" -- Text: test message To: 38067XXXXXXX 

смотрим лог.

> tail  /var/log/smsd/smsd.log 

добавились строки

2012-10-23 21:07:08,5, GSM1: SMS sent, Message_id: 112, To: 38067XXXXXXX, sending time 7 sec. 2012-10-23 21:07:21,5, smsd: Moved file /var/spool/sms/outgoing/send_NpoTqX to /var/spool/sms/checked 

проверяем отправленную смс:

>cat /var/spool/sms/sent/send_NpoTqX To: 38067XXXXXXX Alphabet: Unicode Modem: GSM1 Sent: 12-10-23 21:07:29 IMSI: 255030837719869 test message 

Настройка Zabbix

Напишем скрипт, который будет выполнять Zabbixдля отправи смски. В Zabbixтакие скрипты лежат в директории, определенной в переменной AlertScriptsPath.

cat /usr/local/etc/zabbix_server.conf | grep AlertScriptsPath ### Option: AlertScriptsPath  AlertScriptsPath=/home/zabbix/bin/ 

Сам скрипт называю sms_send.sh и состоит он практически из одной строки:

#!/bin/bash to=$1 subject="$2" body="$3" smssend $to  "$subject" 

Дальнейшая настройка осуществляется через веб-интерфейс. Сначала идем в Администрирование -> Способы оповещений (Administration Media types-> ) и создаем новый способ оповещений ( Media types). Название скрипта должно быть таким же, как и имя файла скрипта в директории AlertScriptsPath

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

После этого в настройках Действий (Actions) появится возможность использовать этот Media:

Тарифы

Стандартная цена одного СМС = 0,5 грн. Что при большом количестве смс может вылится в крупную копеечку. Что же предлагает оператор для уменьшения расходов?

вариант первый — Prepaid

Здесь варианта два:

1. «Пакет 30 SMS» с абон.платой в 4 грн в неделю. Получается, что цена 1 смс =13,33 коп.
2. «Пакет 60 SMS» с абон.платой в 6 грн в неделю. Получается, что цена 1 смс =10 коп.

Цена хорошая. Но есть и минусы:

• В обоих случаях неиспользованные в конце недели смс «сгорают».
• Нужно регулярно заходить в профиль на «Мой Киевстар» и дозаказывать услугу, а то можно в самый важный момент остаться без уведомления.

вариант второй — контракт
Здесь варианта три:

1. «Пакет SMS -50%» с абон.платой в 3 грн в месяц. В пакет входит 500 смс со скидкой. Получается, что цена 1 смс =25 коп.
2. «Пакет SMS -70%» с абон.платой в 7 грн в месяц. В пакет входит 500 смс со скидкой. Получается, что цена 1 смс =15 коп.
3. «Пакет 1000 SMS» с абон.платой в 120 грн в месяц. В пакет входит 1000 бесплатных смс. Получается, что цена 1 смс =12 коп.

Получается дороже, чем в препейд-пакетах, но зато не нужно еженедельно активировать. Один раз сделал — и забыл.
К слову, цены получается конкурентоспособными. Например, интернет-сервис smscentre.kiev.ua для нашей организации предложил цену в 15 коп. за одно смс при количестве смс в месяц 1-25000 без абон. платы и с бесплатной активацией пакета.Но при использовании модема мы получаем одно неоспоримое преимущество — независимость от интернета. Ведь интересуют не массовые смс-рассылки, а уведомления от Zabbix. И при использовании интернет-сервисов рассылки смс я рискую НЕ получить важную смс в случае, например, продолжительного выключения света в офисе или аварии у провайдера. Какой из пакетов выбирать — решать вам.
Подробнее о смс-пакетах можно узнать на: для контракта и для Prepaid

Настройка PlaySMS

Установка этого приложения не обязательна. Приложение анализирует логи smstool и складывает их в mysql базу. Для работы необходимы пакеты httpd, mysql, php, php-pear, php-mysql, php-cli, phpmyadmin. Но эти все пакеты я и так установил для работы Zabbix. Создаём нового пользователя и дериктории для PlaySMS. Скачиваем последнюю версию PlaySMS и создаём базу в mysql:

adduser playsms mkdir -p /var/www/playsms mkdir -p /var/spool/playsms mkdir -p /var/log/playsms chown -R apache /var/www/playsms chown -R apache /var/spool/playsms chown -R apache /var/log/playsms chmod -a -G smstools playsms  wget http://downloads.sourceforge.net/project/playsms/playsms/Version%200.9.7.1/playsms-0.9.7.1.tar.gz tar -zxvf playsms-0.9.7.1.tar.gz -C /usr/local/src cd /usr/local/src/playsms-0.9.7.1/web/ cp -rR * /var/www/playsms cp playsmsd* sendsmsd* /usr/local/bin/   chown -R apache /var/www/playsms mysqladmin -u root -p create playsms 

Импортируем в созданную базу:

mysql -u root -p playsms < /usr/local/src/playsms-0.9.7.1/db/playsms.sql 

Копируем конфиг, предварительно отредактировав в нем пароль пароль для подключения к базе (и логин, если у вас не root)

cp /var/www/playsms/config-dist.php /var/www/playsms/config.php  vi /var/www/playsms/config.php $core_config['db']['pass'] = 'ваш пароль';          // database password 

Настраиваем автоматический запуск программы:

cd /usr/local/src/playsms-0.9.7.1/bin  cp playsmsd playsmsd.php playsmsd_start /usr/local/bin/  cp playsms /etc/default/ 

В /etc/rc.d/rc.local добавлеям строчку — /usr/local/bin/playsmsd_start. Панель управления PlaySMS доступна по htpp://ip.адресс.вашего.сервера/playsms. Вход admin \ admin.
Проверяем, кто в /etc/default/playsms указан правильный путь

PLAYSMS_PATH=/var/www/html/playsms   

Полезные ссылки

Ссылки, которые натолкнут вас на мысли по дальнейшему совершенствованию идеи отправки СМС:
Статья со скриптом-шлюзом E-mail->SMS
Подробный мануал по AT-командам и отправке СМС
Описание различных AT-команд
Переадресация SMS с помощью SMSTools
Описание заголовков файла смс-сообщений