Social
09.11.2021
303567

Мониторинг состояния транков с оповещением в Telegram

Телефония довольно важный аспект любого бизнеса или технического предприятия, порой выход связи из строя может привести к убыткам или просто к задержкам в работе. Именно поэтому своевременное выявление и устранение неполадок на линиях связи очень важны. Часто случается так, что задачи приходят одна за одной, или случилось что-то серьезное и на мелкие проверки времени просто […]

Мониторинг состояния транков с оповещением

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

Часто случается так, что задачи приходят одна за одной, или случилось что-то серьезное и на мелкие проверки времени просто на просто нет, в следствии чего администратор АТС просто не успевает контролировать все.

Что делать если нет времени проверять все вручную? Правильно! Нужно автоматизировать процесс!

В данной статье мы рассмотрим, как с помощью 3 небольших и простеньких скриптов облегчить жизнь любому администратору АТС или просто обычному пользователю, который решил наладить себе свою личную телефонию! Данная статья состоит из 2 блоков ((1) Мониторинг транков, (2) отправка уведомления в Telegram) которые работают независимо друг от друга, так что вы легко сможете найти применение каждому в отдельности для выполнения других задач!

Мониторинг транков

Так что же будет делать наш скрипт?

Все очень просто:

1.Скрипт проверяет статус транков:

Проверка статуса транков
Проверка статуса транков

2. Смотрит общее количество транков в системе:

Общее количество транков в системе
Общее количество транков в системе

3. Ищет проблемные транки, если находит таковые, то пытается «восстановить» их работоспособность, затем проводит повторную проверку по результатам которой вызывает (один из дополнительных скриптов (Описаны во втором блоке статьи), которые в свою очереди информируют администратора(вас), о том, что все в порядке (или нет).

Сам скрип выглядит следующим образом:

#!/bin/bash
# Задаем необходимые для проверки переменные.
ALLTRUNKSMINIMUM="`/usr/sbin/asterisk -rx "sip show registry"`" # Проверяем статус каждого транка.
ALLTRUNKS=`echo "$ALLTRUNKSMINIMUM" |grep "SIP registrations" |awk '{print $1}'` # Проверяем сколько всего транков в системе.
REGTRUNKS=`/usr/sbin/asterisk -rx "sip show registry" |grep Registered |wc -l` # Проверяем сколько в системе зарегистрированных транков (Со статусом Registered).
# Задаем условие.
if [ "$REGTRUNKS" -lt "$ALLTRUNKS" ]; then # Если в одном или более транке встретился статус отличный от Registered(т.е. если хотя бы один транк не работает).
sleep 5 # Ждем 5 секунд.
echo `/usr/sbin/asterisk -rx "sip reload"` # Выполняем переотправку регистрационных пакетов ,делая sip reload (Пытаемся восстановить проблемный транк(и)).
sleep 5 # Ждем 5 секунд.
VAR=`/usr/sbin/asterisk -rx "sip show registry"` # Выполняем проверку транков ,после попытки восстановления
# Если после повторной проверки хотя бы один транк остался не в рабочем состаянии вызываем скрипт отправки сообщения в telegram с уведомлением об необходимсти проверки.
./TrunkError.php
# Если же после попытки восстановления все транки пришли в рабочее состояние вызываем скрипт отправки уведомления в telegram ,что на АТС все впорядке.
else
./TrunkOk.php
fi
Скрипт
Скрипт

Далее настроим авто выполнение скрипта каждые 2 минуты, для этого добавим его в cron.

Добавление скрипта в cron

Конфигурирование сценариев cron производится через unix shell. Прежде всего нужно определить, какие программы Вы хотите запускать и узнать полные пути к ним на диске сервера. Для этого перейдите с помощью команды cd в каталог, где находится запускаемая программа, и узнайте полный путь к этому каталогу с помощью команды pwd. Путь может выглядеть, например, как /home/u12345/scripts/script.pl.

Убедитесь, что файл, который Вы хотите запускать, имеет права на чтение+исполнение (r+x) для владельца файла.

Поменять права на нужные можно командой: chmod 750 script.pl

Далее выполните команду crontab -e. Вы окажетесь в текстовом редакторе vi, где сможете вводить текст сценария для cron.

Краткая справка по редактору vi:

Для вставки текста нажмите i, затем вводите текст

Для удаления символов нажмите ESC, а затем наберите x

Для выхода из vi без сохранения изменений нажмите ESC, а затем наберите: q!

Для сохранения и выхода нажмите ESC, а затем наберите: wq

Задания для cron пишутся по одному в строке. После каждой строки, в том числе после последней или единственной, обязательно нужно нажать enter ‒ иначе задания работать не будут.

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

поле1 поле2 поле3 поле4 поле5 команда

Значения первых пяти полей:

минуты ‒ число от 0 до 59

часы ‒ число от 0 до 23

день месяца ‒ число от 1 до 31

номер месяца в году ‒ число от 1 до 12

день недели ‒ число от 0 до 7 (0-Вс,1-Пн,2-Вт,3-Ср,4-Чт,5-Пт,6-Сб,7-Вс)

Для каждого конкретного параметра можно задать несколько значений через запятую. Например, если в поле «часы» написать 1,4,22, то задание будет запущено в 1 час ночи, в 4 часа утра и в 22 часа. Можно задать интервал ‒ 4-9 будет означать, что программу нужно запускать каждый час в период с 4 до 9 часов включительно. Символ ‘*’ означает «все возможные значения». Например, указание ‘*’ в поле «часы» будет означать «запускать каждый час». Символ ‘/’ служит для указания дополнительной периодичности задания. Например, ‘*/3’ в поле «часы» означает «каждые три часа». Подробнее

В нашем случае команда будет выглядеть так:

*/2 * * * * означает что скрипт будет выполняться каждые две минуты
/usr/local/bin/test.sh директория где находится сам скрипт (убедиться, что скрипт имеет права на запуск)

/dev/null 2>&1 используется для подавления нежелательного вывода в консоль.

После этого останется написать два дополнительных скрипта для оповещения. Рассмотрим далее.

Оповещение в Telegram

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

Для начала, дабы обеспечить работоспособность скрипта, нам нужно разобраться с самим telegram, а именно, нам необходимо:

  1. Зарегистрировать своего собственного бота и узнать его token;
  2. Узнать id чата на который будут приходить уведомления (ваш чат);

Итак, приступим.

1.Регистрация бота в telegram:

Нам необходимо зайти в Telegram и начать чат с @BotFather.
Откроется список команд, отправляем /newbot.
Затем выбираем название бота (name) и его имя (username), по которому бот будет доступен для поиска. Имя бота обязательно должно быть уникально и оканчиваться на «bot».

После этого регистрация бота завершена, @BotFather пришел сообщение с информацией о боте и, самое главное, его token:

Информация о боте и его token
Информация о боте и его token

2. id чата администратора (ваш):
С этим этапом все еще проще чем с предыдущим, нам нужно всего лишь зайти на необходимую нам учетную запись telegram (на эту запись в будущем будут приходить уведомления о состоянии транков ) и начать диалог с @JsonViewBot (написать,например Hello), в ответ мы получим сообщение в котором будет содержаться необходимый нам id:

 id чата администратора
id чата администратора

Подготовка завершена, собственно теперь сам скрипт (в мои случаи ‒ это скрипт TrunkError.php (см. первый блок).

Выглядит скрипт следующим образом:

#!/usr/bin/php
<?php
/*
Отправляем уведомление о необходимости проверки транков вручную.
*/
function send($token, $chatid, $text)
{
$ch=curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.telegram.org/bot'.$token.'/sendMessage');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'chat_id='.$chatid.'&text='.urlencode($text));
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, 1);


// Отправляем сообщение
$result=curl_exec($ch);
}
// Токен бота и идентификатор чата
//id чата оператора в Telegram
$token='2037875512:AAH_bHFifTuKUebBceCYJcJ5Xx7v11qeyb0';
$chatid=1590871398;
/* В данной строке прописываем какого вида сообщение будет присылать бот в Telegram. */
$text='Внимание, необходимо проверить состояние транков!';
// Отправка сообщения в личный Telergam чат
send($token, $chatid, $text);
echo $text;
fclose ($stdin);
fclose ($stdout);
exit(0);
?>

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

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

#cd /var/lib/asterisk/agi-bin/
#chmod +x TrunkError.php
#chmod +x TrunkOk.php
Права на исполнение
Права на исполнение

И так, в данной статье, мы рассмотрели элементарный набор скриптов, позволяющий сэкономить много времени и избежать непредвиденных ситуаций на нашей АТС.

Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Виталий Шелест, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.

Надежен в эксплуатации.

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

Гибкий в настройке.

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

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

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

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.