Осмотр возможностей
MonAst позиционируется разработчиками как инструмент мониторинга, который действует как панель оператора для Asterisk. Распространяется по лицензии BSD. Проект написан с использованием Python (демон для связи с Asterisk по AMI), PHP, JS (AJAX).
Из возможностей просмотра (в режиме real-time) — следующее:
- Работа с несколькими серверами (с помощью переключения между ними)
- Многопользовательский режим с указанием прав доступа
- Отображение пользователей и пиров (SIP, IAX, DAHDI, Khomp, etc…)
- Отображение активных каналов и вызовов (с именем канала и CallerID)
- Каналы конференции (с отображением подключённых пользователей)
- Припаркованные звонки (Parked Calls)
- Очереди (с отображением статистики, участников и ожидающих клиентов)
Из возможностей выполнения операций:
- Выполнение (инициация) вызовов
- Трансфер вызовов
- Сброс вызовов
- Паркование вызовов
- Прослушивание звонков (Spy Calls)
- Приглашение участников в конференцию
- Удаление участников конференции
- Добавление пользователей (или пиров) как участника любой очереди
- Удаление участников из очереди
- Постановка и снятие с паузы участников очереди
- Выполнение CLI команд
Как видно — список возможностей достаточно обширный.
Установка
Подопытной системой у нас будет чистая Ubuntu 10.10 с базовыми программами и обновлениями. MonAst не обязательно ставить на хосте с Asterisk. У меня, к примеру, MonAst стоит локально на ноутбуке — и я прекрасно мониторю все наши 6 серверов с Asterisk.
Прежде чем приступить к установке MonAst — пробежимся по требованиям.
Так как демон, с помощью которого происходит обмен между Asterisk и MonAst (посредством AMI — Asterisk Manager API) написан на Python, то первым делом проверяем его присутствие в системе:
it@ubuntu-test ~ $ python --version
Python 2.6.6
Если видим нечто подобное — значит все в порядке. Если по каким то причинам его нет — выполняем команду:
it@ubuntu-test ~ $ sudo apt-get update && sudo apt-get install python
Двигаемся дальше.
Так как все это будет отображаться через web-интерфейс, то нужно иметь установленный http сервер с поддержкой php, а так же php-pear. Если ранее данного комплекта не стояло — выполняем команду (дополнительно поставим mc — для удобства навигации и редактирования):
it@ubuntu-test ~ $ sudo apt-get install apache2 php5 php-pear mc
Ну и напоследок — установка зависимостей для обсуждаемого продукта. Этот список у нас невелик:
- Twisted Python 10.1+
- zope.interface 3.6+
- Starpy SVN-Trunk
- PHP PEAR Packages: (HTTP_Client)
Пакет zope.interface уже стоял в системе (был в наличии из коробки).
Ставим пакет HTTP_Client:
it@ubuntu-test:/usr/src$ sudo pear install HTTP_Client
WARNING: "pear/HTTP_Client" is deprecated in favor of "pear/HTTP_Request2"
WARNING: channel "pear.php.net" has updated its protocols, use "pear channel-update pear.php.net" to update
WARNING: "pear/HTTP_Request" is deprecated in favor of "pear/HTTP_Request2"
WARNING: "pear/Net_URL" is deprecated in favor of "pear/Net_URL2"
downloading HTTP_Client-1.2.1.tgz ...
Starting to download HTTP_Client-1.2.1.tgz (10,202 bytes)
.....done: 10,202 bytes
downloading HTTP_Request-1.4.4.tgz ...
Starting to download HTTP_Request-1.4.4.tgz (17,109 bytes)
...done: 17,109 bytes
downloading Net_URL-1.0.15.tgz ...
Starting to download Net_URL-1.0.15.tgz (6,303 bytes)
...done: 6,303 bytes
downloading Net_Socket-1.0.10.tgz ...
Starting to download Net_Socket-1.0.10.tgz (5,429 bytes)
...done: 5,429 bytes
install ok: channel://pear.php.net/Net_URL-1.0.15
install ok: channel://pear.php.net/Net_Socket-1.0.10
install ok: channel://pear.php.net/HTTP_Request-1.4.4
install ok: channel://pear.php.net/HTTP_Client-1.2.1
Как видим — в процессе установки говорит об устаревании пакета и предлагает поставить более новый:
it@ubuntu-test:/usr/src$ sudo pear install HTTP_Request2
Пакеты Twisted и StarPy будем ставить из исходников. Но при установке выявились еще зависимости, которые и исправляем (попутно перейдем в режим суперпользователя):
it@ubuntu-test:~$ sudo su
root@ubuntu-test:~$ cd /usr/src/
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src/Twisted-12.0.0
Если видим надпись «Finished processing dependencies for Twisted==12.0.0» — значит установка прошла успешно и переходим дальше. Если выскакивает ошибка — то скорее не хватает какого-то компонента. Проверте по списку — все ли зависимости установлены? Идем дальше:
root@ubuntu-test:/usr/src/Twisted-12.0.0
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src/starpy-1.0.0a13
root@ubuntu-test:/usr/src/starpy-1.0.0a13
Ну и самый главный виновник торжества. На момент написания актуальная версия — 3.0b4:
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src
root@ubuntu-test:/usr/src/monast-3.0b4
В процессе установки скрипт задаст пару вопросов относительно путей. Если предложенные им варианты устраивают — соглашаемся. Иначе прописываем свои данные. Я лишь изменил путь, куда ложатся .php файлы
MonAst HTML path [/var/www/html/monast]: /var/www/asterisk/monast/
Может показаться что на этом установка закончена. Но не тут то было. Стартовый скрипт /etc/init.d/monast ставится лишь для систем SuSE, RedHat, Debian, Gentoo, Slackware, FreeBSD. Но не Ubuntu и ей подобные. Потому копируем скрипт от Debian и добавляем его в автозагрузку:
root@ubuntu-test:/usr/src/monast-3.0b4
root@ubuntu-test:/usr/src/monast-3.0b4
root@ubuntu-test:/usr/src/monast-3.0b4
Вот теперь установка у нас окончена. Можно переходить к настройке.
Настройка
Перво наперво нужно выполнить настройку самого Asterisk, дабы сабжевое ПО могло успешно подключится и обмениваться информацией. На сервере с Asterisk переходим по пути /etc/asterisk/ и правим файл manager.conf. Если серверов несколько — делаем подобные поправки на нужных.
root@asterisk ~ $ mcedit /etc/asterisk/manager.conf
[general]
enabled = yes ; Активируем AMI
port = 5038 ; Порт, по которому к данному сервису будет подключаться MonAst
bindaddr = 0.0.0.0 ; Прослушиваем все интерфейсы в системе для принятия подключения
displayconnects = yes ; Показывать в консоли Asterisk о факте подключения
webenabled = no ; Выключаем встроенный в Asterisk static_http
allowmultiplelogin = yes ; Разрешаем вход вход под одним и тем же пользователем с разных мест.
timestampevents = yes ; Добавлять метку времени для событий
[monast_user]
secret=qwerty123 ; Пароль для подключения
deny=0.0.0.0/0.0.0.0 ; Запрещаем подключение с любого адреса
permit=127.0.0.1/255.255.255.0 ; И постепенно разрешаем нужные
permit=192.168.1.10/255.255.255.0 ; Так разрешаем конкретный хост
permit=192.168.2.0/255.255.255.0 ; А вот так можно разрешить подсеть
writetimeout=100 ; Таймаут для посылки команд
read=system,call,log,verbose,command,agent,user,config,originate,reporting
write=system,call,log,verbose,command,agent,user,config,originate,reporting
После чего перезагрузим конфигурацию Asterisk для модуля manager:
root@asterisk$ asterisk -rx "manager reload"
На этом настройка Asterisk закончена. Переходим к конфигурации самого MonAst’а.
Файл с параметрами находится по пути /etc/monast.conf. Его и правим. Скажу наперед — сложностей в настройке не возникло, приведенные в файле комментарии четко описывают тот или иной параметр. Но для примера приведу свой пример файла
root@ubuntu-test:/usr/src/monast-3.0b4
root@ubuntu-test:/etc
[global]
bind_host = 127.0.0.1 ; Разрешаем подключения с локального хоста
bind_port = 5039 ; Порт для подключения к демону.
auth_required = true ; Указываем сто аутентификация обязательна
[server: Server1]
hostname = 192.168.1.1
hostport = 5038
username = monast_user
password = qwerty123
default_context = default
transfer_context = default
meetme_context = default
meetme_prefix =
[server: Server2]
hostname = 192.168.2.1
hostport = 5038
username = monast_user
password = qwerty123
default_context = default
transfer_context = default
meetme_context = default
meetme_prefix =
[peers]
sortby = callerid
default = show
[meetmes]
default = hide
[queues]
default = hide
[user: admin]
secret = SuperPuperDruper
roles = originate,queue,command,spy
servers = ALL
[user: manager]
secret = password
roles = originate
servers = ALL
[user: server1]
secret = 12345
roles = originate
servers = Server1
[user: server2]
secret = 54321
roles = originate,command
servers = Server2
Сохраняем изменения и перезагружаем демон:
root@ubuntu-test:/etc
Все. Можно подключаться и проверять. Открываем браузер и в строке адреса вбиваем: http://localhost/asterisk/monast/
Если ставили «auth_required = true» то вводим логин, пароль — и наслаждаемся рабочим инструментом 🙂
Важное замечание. В режиме «без аутентификации» все, кто работают в панели оператора MonAst — имеют полные права, т.е. являются «суперпользователями». А как мы знаем «Оружие, данное в неумелые руки, может навредить». Будьте внимательны.
Так же в файле /var/www/asterisk/monast/lib/config.php находятся параметры адреса и порта, где работает демон monast.py, параметры отображение вкладок debug и cli, а так же некоторых не менее интересных параметров.
Обзор возможностей
Теперь же пробежимся по возможностям данного программного продукта.
После входа на web-интерфейс мы видим несколько вкладок. А если быть точнее:
- Mixed Pannels — Вкладка с практически всем разделами сразу. Удобство заключается в том, что можно отобразить лишь нужные и, не переключаясь, видеть необходимую информацию в одном месте.
- Peers/Users — Просмотр и управление достуными пирами и пользователями.
- Meetme Rooms — Просмотр и управление конференциями
- Channels/Calls — Просмотр и управление активными вызовами и поднятыми каналами.
- Parked Calls — Просмотр и управление припаркованными вызовами
- Queues — Просмотр и управление очередью звонков
- Asterisk CLI — Командная строка Asterisk. Если у пользователя есть права выполнения команд в консоли, то именно здесь можно ввести нечто схожее с «core show version» 🙂
Разобраться в возможностях не составляет труда и, возможно, даже лучше будет если Вы сами пробежитесь и опробуете доступные функции — так вы четко будете понимать что и как работает. Но я все таки опишу парочку интересных из них 🙂
Originate call (инициирование вызова). Из названия функции ясно — можно соединить внутреннего абонента с каким либо номером (если он, номер, сможет обработаться Вашим dialplan’ом). Для выполнения функции нужно нажать правой кнопкой мыши (далее по тексту — пкм) на нужном аккаунте и выбрать соответствующий пункт. В появившемся окне вводим нужный номер и, вуаля — у выбранного человека звонит телефонный аппарат, он берет трубку и Asterisk соединяет его с выведенным нами номером. Так же можно перетащить мышкой один аккаунт на другой и, согласившись — инициировать соединение между ними.
Meetme Rooms (комната конференции). Перейдя в данный раздел можно управлять уже созданными конференциями, либо создать новую и пригласить туда определённых участников. Для создания своей конференции — переходим в соответствующий раздел, нажимаем «Create Dynamic Meetme» и в окне вводим запрашиваемую информацию. Нажали «Ок» — и процесс пошел-поехал 🙂
Spy (прослушивание вызова). Что она делает? Из названия можно понять — дает возможность подключится к выбранному разговору и прослушать речевой поток. Функция может быть полезна при использовании в call-центрах для контроля и проверки агентов. При этом в процессе разговора собеседники даже не подозревают о факте прослушивания. По крайней мере я, тестируя данную возможность, никакого сигнала или уведомления не слышал. Для того, чтобы пользователь панели имел право на прослушивание — нужно чтобы в поле roles его прав доступа присутствовало spy. Потому для того, чтоб ограничить использование данной функции с нехорошим умыслом — включайте аутентификацию для доступа к панели и давайте права на ее использование только доверенным для этого пользователям. Начальнику отдела, например 🙂
Заключение
MonAst, как и альтернативные проекты с подобной функциональностью (FOP, Links и пр.) однозначно имеет право на существование и, соответственно, использование в рабочем процессе.
Простота использования, относительная лёгкость в установке и настройке, мониторинг нескольких серверов с одного места — все это, в большинстве случаев, будет более чем достаточно.
Ссылки
