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

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

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

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

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

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

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

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

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

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

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

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

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

Рисунки 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

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