Александр Мутовин
30.12.2019
128993

Чтение и анализ данных AMI интерфейса

Для работы с телефонией с помощью сторонних программ в asterisk реализованы 3 интерфейса AGI ARI и AMI. В это статье мы рассмотрим как можно получить логи звонков, а также выгрузить их в файл для дальнейшего анализа. При использовании AMI нет необходимости запускать приложение на самом сервере телефонии, т.к. этот интерфейс предоставляет возможность подключиться дистанционно. В […]

Для работы с телефонией с помощью сторонних программ в asterisk реализованы 3 интерфейса AGI ARI и AMI. В это статье мы рассмотрим как можно получить логи звонков, а также выгрузить их в файл для дальнейшего анализа.

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

АМИ интерфейс предоставляет полный доступ к управлению телефонией. Настоятельно рекомендуется ограничивать подключение по IP адресу и сложному паролю. Также выставлять требуемые права доступа к определенным свойствам.

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

По умолчанию AMI интерфейс запущен на порту 5038. Перед тем, как производить написание скрипта, необходимо создать учетную запись АMI для подключения.

Откроем веб интерфейс Freepbx и перейдем в раздел «Settings -> Asterisk Manager User» (рисунок 1).Откроется страничка с настройками.

Добавление AMI пользователя
Добавление AMI пользователя
  • В поле «manager name» вводим логин будущего пользователя
  • В поле «Manager secret» вводим пароль (по умолчанию нам предлагается уже сгенерированный системой пароль)
  • В поле «Deny» указывается с каких сетей запрещено подключение. Все нули означают, что запрещено подключение со всех сетей.
  • В поле «Permit» указываются сети, с которых разрешено подключение.
  • В поле Write Timeout указывается таймаут в миллисекундах на запись данных в сокет. Если в это время данные не записались, соединение считается не установленным.

Далее перейдем во вкладку «Permissions» (рисунок 2)

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

Подробнее о правах доступа можно почитать на этой страничке https://voxlink.ru/kb/book/interfejs-upravlenija-asterisk-ami/

После установки определенных параметров нажимаем кнопку «Submit» и после этого нажимаем «Apply Config»

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

Для начала рассмотрим алгоритм его работы (рисунок 3)

Блок схема алгоритма работы скрипта.
Блок схема алгоритма работы скрипта.

 Сам скрипт будет состоять из двух классов. Первый класс будет главным, в нем будет происходить инициализация и ввод авторотационных данных. На основе второго класса будет создаваться отдельный поток, в котором реализован процесс подключения, пере подключения и считывания полученных данных.

Первая часть Класса Asterisk.
Первая часть Класса Asterisk.
продолжение класса Asterisk.
продолжение класса Asterisk.

Рисунки 4-5 это код главного класса.

Далее в рисунках 6-8 показан код потока, который устанавливает и держит соединение.

Начало класса потока подключения
Начало класса потока подключения
Продолжение  класса потока подключения
Продолжение  класса потока подключения
Продолжение класса потока подключения
Продолжение класса потока подключения

Далее компиляцию программы опустим. Об этом информации в интернете много. Для запуска jar приложения на linux установим JDK

# yum install yum install java-1.8.0-openjdk.x86_64

После установки напустим программу

# java –jar Asterisk.jar – Запуск программы

Если ввести неправильные учетные данные, то программа об этом уведомит и попросит заново их ввести. (рисунок 9)

попытка авторизации с неправильными учетными данными.
попытка авторизации с неправильными учетными данными.

После успешной авторизации отобразится информация, о том, что авторизация прошла успешно, также можно увидеть сообщения:

Response: Success
ActionID: 400
CoreStartupDate: 2019-12-26
CoreStartupTime: 15:00:37
CoreReloadDate: 2019-12-26
CoreReloadTime: 15:00:37
CoreCurrentCalls: 0

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

Введем команду для проверки записи логов в файл (рисунок 10):

# tailf  ami-log.tx
Файл логов ami-log.txt создается автоматически после запуска приложения в той же директории
Данные в файле логов.
Данные в файле логов.

Далее эти данные можно анализировать и использовать по назначению. Также можно на основе этих данных написать парсер логов и вести статистику звонков.

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

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

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

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

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

ближайшие Вебинары

ONLINE

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 сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.