Asterisk настройка cdr csv

Содержание:

Getting the software
Installation
- Quick Start
«Допиливаем» Asterisk CDR Viewer под себя
База знаний
Подготовим FreeSWITCH для работы с MySQL через ODBC
Activating the License
Installation
Добавление настроек в базу
- Создание extensions
- Правила вызова (контекст)
Activating the License
Настройки очереди Колл Центра Asterisk (FreePBX)
- Параметры времени и операторов
- Параметры ёмкости очереди
Recordings and FreePBX
Call Detail Record (CDR)
Asterisk call data records in comma-separated text files
Сборка Asterisk

Getting the software

You can see available downloads in http://www.asternic.net/cdrreports/download.php. Asternic CDR Reports requires an activation code, you can purchase a license to get a perpetual activation code, or you can request a 30 days trial code for testing it out before buying.

You also have the choice of installing the open source Lite version of our software. It is important to note that it is not the same software as the commercial version. Database schemas differ and installation instructions are also different. There is another installation guide for the free IssabelPBX module that you can find here.

So, log into your server and run this from your server command line:

Installation

Настройка fail2ban для защиты asterisk

docker pull tiredofit/freepbx:(imagetag)

The following image tags are available:

— Asterisk 17, Freepbx 15 — Debian Buster (latest build)
— Asterisk 14, Freepbx 14 — Debian Stretch (latest build)
— Asterisk 17, Freepbx 15 — Debian Buster (Same as )

You can also visit the image tags section on Docker hub to pull a version that follows the CHANGELOG.

Quick Start

Set various to understand the capabilities of this image.
Map for access to configuration and data files for backup.
Make available for public access if necessary

The first boot can take from 3 minutes — 30 minutes depending on your internet connection as there is a considerable amount of downloading to do!

«Допиливаем» Asterisk CDR Viewer под себя

Установка и базовая настройка сервера asterisk на ubuntu

«Я профессионал, потому что не ленюсь искать информацию в google» — сказал мне однажды коллега.

А я поленился и начал «допиливать» CDR Viewer под себя, даже не посмотрев хотя бы вот это. А может и не в лени дело, просто было интересно… в общем, что из этого вышло можно посмотреть под катом:)

Споры о том, что лучше использовать в качестве офисной АТС — asterisk (с веб-интерфейсом или без, хотя это отдельная тема для споров) или какую-то коробку типа Panasonic, которых на рынок выкинуто немеренное количество — не утихают до сих пор, но топик не об этом, лично для себя я уже давно определился. Хотелось бы поделиться с сообществом своим вариантом придания интерфейсу просмотра статистики дополнительного фунционала.

В качестве «подопытного» я использовал FreePBX Distro (FreePBX 2.11, Asterisk 11, CentOS 6.5), скачанный с официального сайта проекта. Выбор был продиктован тем, что разработчики FreePBX уже позаботились о прикручивании БД к Asterisk и структура хранения записей в общем-то меня устраивает. Хотя процедура «прикручивания» MySQL или какой-либо другой базы к Asterisk была описана ни раз и ни два, о чем можно почитать например здесь, все же в целях экономии времени я решил этого не делать.

За основу был взят Asterisk CDR Viewer (если не нужно каких-то сверхмудреных отчетов — то вполне себе пригодная и простенькая статистика), скачать можно тут.

Установка CDR Viewer не представляется какой-то нетривиальной задачей.

Переходим в нужную нам директорию, качаем архив, извлекаем файлы из архива:

Переносим файлик алиаса в папку с apache2:

Изменяем настройки подключения к БД для Asterisk-CDR-viewer

Нужно поменять параметры в соответствии с текущей конфигурацией вашей базы:

$db_user = ‘’; $db_pass = ‘’; $db_name = ‘’;

Делаем рестарт веб-сервера:

Теперь в браузере набирая /acdr/ попадаем на страницу статистики.

Первое, что мне захотелось сделать — прикрутить авторизацию для просмотра этой самой статистики, для этого воспользуемся htpasswd. Если не установлена —

Переходим в /etc/apache2 и созадем юзер/пароль для статистики:

Вводим пароль в диалоге, который предлагает htpasswd и получаем файл «passwordfile» с юзером «username» и сгенерированным зашифрованным паролем.

Далее в /etc/apache2/conf.d изменяем asterisk-cdr-viewer.conf, раскомментрировав строки авторизации, в результате получаем:

Alias /acdr/ «/var/www/asterisk-cdr-viewer/»

AuthName «Asterisk-CDR-Stat» AuthType Basic AuthUserFile /etc/apache2/passwordfile AuthGroupFile /dev/null require valid-user

Рестартуем apache2 и при входе на страницу видим окно авторизации:

Следующее, что был сделано — это прослушивание разговоров из веб-интерфейса.

1) Для прослушивания звонков добавляем две иконки в каталог /var/www/asterisk-cdr-viewer/templates/images (play и stop)

источник

База знаний

История одного проекта или как я 7 лет создавал атс на базе asterisk и php

Здесь еще один написанный на PHP скрипт для импорта файлов cdr.csv в mysql cdr базу данных. Полезен для перехода от текстовых cdr файлов к БД или даже для еженочных импортов.

Этот скрипт надежен для запуска многократное число раз лог файл, который хранит рост, потому что он, во-первых, проверяет таблицу БД для поиска старшей записи и только потом импортирует CDRs, которые НИКОГДА This script is safe to run multiple times on a log file that keeps growing because it first checks the database table to find the oldest record and then only imports CDRs that are NEWER than the oldest database record.

Скопируйте и вставьте скрипт в текстовый файл, например, “importcdr.php” и затем используйте php в командной строке для выполнения следующего: php importcdr.php Master.csv

Обновлено July 21, 2005: I fixed this code so it should copy and paste properly now. Wiki не нравятся квадратные скобки!

Замечание: Поля в файле Master.csv очень зависят от ваших настроек. Там есть комментарии о них.

Обновлено June 2, 2006: Этот скрипт теперь прекрасно работает с астериском 1.2.7.1.

\n»); print(«Where filename is the path to the Asterisk csv file to import (Master.csv)\n»); print(«This script is safe to run multiple times on a growing log file as it only imports records that are newer than the database\n»); exit(0); >

// соединение с бд $linkmb = mysql_connect($locale_db_host, $locale_db_login, $locale_db_pass) or die(«Could not connect : » . mysql_error()); //echo «Connected successfully\n»; mysql_select_db($locale_db_name, $linkmb) or die(«Could not select database $locale_db_name»);

/** 1) Ищет последний элемент лога **/ // просматривает в cdr таблице, чтобы увидеть, когда последний элемент был создан. // это устанавливает начальную точку для данных астариска. $sql=»SELECT UNIX_TIMESTAMP(calldate) as calldate». » FROM cdr». » ORDER BY calldate DESC». » LIMIT 1″;

if(!($result = mysql_query($sql, $linkmb))) print(«Invalid query: » . mysql_error().»\n»); print(«SQL: $sql\n»); die(); > $result_array = mysql_fetch_array($result); //$lasttimestamp = date(«Y-m-d H:i:s», $result_array); $lasttimestamp = $result_array;

//** 2) ищет новые записи в лог файле астериска. **

$rows = 0; $handle = fopen($logfile, «r»); while (($data = fgetcsv($handle, 1000, «,»)) !== FALSE) // ЗАМЕЧАНИЕ: поля в Master.csv могут изменяться. Это должно работать по умолчанию на всех кстановках, но вы можете отредактировать следующую строку для сравнения вашей конфигурации list($accountcode,$src, $dst, $dcontext, $clid, $channel, $dstchannel, $lastapp, $lastdata, $start, $answer, $end, $duration, $billsec, $disposition, $amaflags ) = $data;

// 3) анализирует каждый ряд и добавляет к бд if(strtotime($end) > $lasttimestamp) $sql = «INSERT INTO cdr (calldate, clid, src, dst, dcontext, channel, dstchannel, lastapp, lastdata, duration, billsec, disposition, amaflags, accountcode) VALUES(‘$end’, ‘».mysql_real_escape_string($clid).»‘, ‘$src’, ‘$dst’, ‘$dcontext’, ‘$channel’, ‘$dstchannel’, ‘$lastapp’, ‘$lastdata’, ‘$duration’, ‘$billsec’, ‘$disposition’, ‘$amaflags’, ‘$accountcode’)»; if(!($result2 = mysql_query($sql, $linkmb))) print(«Invalid query: » . mysql_error().»\n»); print(«SQL: $sql\n»); die(); > $rows++; > > fclose($handle);

источник

Подготовим FreeSWITCH для работы с MySQL через ODBC

Предполагается, что сервер mysql () установлен.

 yum install -y mysql-connector-odbc unixODBC unixODBC-devel

Проверим odbcinst.ini

# Driver from the mysql-connector-odbc package
# Setup from the unixODBC package

Description     = ODBC for MySQL
Driver          = /usr/lib/libmyodbc5.so
Setup           = /usr/lib/libodbcmyS.so
Driver64        = /usr/lib64/libmyodbc5.so
Setup64         = /usr/lib64/libodbcmyS.so
FileUsage       = 1

Заполним odbc.ini

Driver=MySQL
SERVER=localhost
PORT=3306
DATABASE=freeswitchcdr
USER=DB_USER
PASSWORD=DB_PASSWORD

Проверим подключение к MySQL

 echo "select 1" | isql -v freeswitchcdr

Нажмите, чтобы отобразить

Нажмите, чтобы скрыть

   
+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help                       |
| quit                                  |
|                                       |
+---------------------------------------+
SQL> select 1
+---------------------+
| 1                   |
+---------------------+
| 1                   |
+---------------------+
SQLRowCount returns 1
1 rows fetched

Создадим БД MySQL в формате asteriskcdrdb

Создайте файл, например:

 touch freeswitchcdr.sql

И скопируйте в него структуру таблицы БД:

CREATE TABLE cdr (
   calldate datetime NOT NULL default '0000-00-00 00:00:00',
   clid varchar(80) NOT NULL default '',
   src varchar(80) NOT NULL default '',
   dst varchar(80) NOT NULL default '',
   dcontext varchar(80) NOT NULL default '',
   channel varchar(80) NOT NULL default '',
   dstchannel varchar(80) NOT NULL default '',
   lastapp varchar(80) NOT NULL default '',
   lastdata varchar(80) NOT NULL default '',
   duration int(11) NOT NULL default '0',
   billsec int(11) NOT NULL default '0',
   disposition varchar(45) NOT NULL default '',
   amaflags int(11) NOT NULL default '0',
   accountcode varchar(20) NOT NULL default '',
   uniqueid varchar(32) NOT NULL default '',
   userfield varchar(255) NOT NULL default '',
   did varchar(50) NOT NULL default '',
   recordingfile varchar(255) NOT NULL default '',
   KEY `calldate` (`calldate`),
   KEY `dst` (`dst`),
   KEY `accountcode` (`accountcode`),
   KEY `uniqueid` (`uniqueid`)
)ENGINE=InnoDB DEFAULT CHARSET=utf-8;

Задаем права на БД с параметрами определенными в odbc.ini

 mysql> GRANT ALL PRIVILEGES ON freeswitchcdr.* TO DB_USER@localhost  IDENTIFIED BY 'DB_PASSWORD';
 flush privileges;
 \q

Activating the License

In order to run reports, you need a valid activation code to get your license, either a trial or purchased one. Once you have your code at hand, use your browser and go to:

You should be prompted for both the activation code, and a registration name. The registration name can be chosen by you and it could be your company name, customer name, etc. A legend will appear in the reports footer saying «Licensed to XXXXX» where XXXXX is the registation name you used at time of activation. That name cannot be changed in the future, so please chose wisely.

Afer entering both the activation code and registration name, click the button to acquire a license file. That’s it! After a short while, you will be presented with the login form. The default user/pass to access the system is: admin/admin . You can change the password once logged by selecting the Setup/Users menu inside Asternic GUI.

Continue reading the Administrator Guide in order to configure or set preferences for your reports.

Installation

Once the download finishes, extract the package:

Then change to the newly extracted directory that contains all files:

And finally start the installation script:

The installation script will do several things:

Check if the software is already installed, if so it will abort and exit
Check if the database qstats exists, if so, it will abort and exit.
It will install the ionCube loader for your platform and PHP version
It will install an init script for the asterniclog parser daemon
It will install the perl-Time-HiRes module
It will create a MySQL database and tables named ‘qstats’
It will install both the parselog tool in /usr/local/parselog and the web application in /var/www/html/stats

Добавление настроек в базу

На текущем шаге, Asterisk будет использовать конфигурационные файлы. Рассмотрим процесс настройки использования СУБД с добавлением настроек в базу.

Создание extensions

Редактируем файл extconfig.conf:

vi /etc/asterisk/extconfig.conf

sipusers => odbc,asterisk-conf,sippeers
sippeers => odbc,asterisk-conf,sippeers

* мы добавили две строчки в раздел settings, которые говорят астериску искать пиры через odbc, настройку asterisk-conf.

Перезапускаем астер:

systemctl restart asterisk

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

Подключаемся к базе данных:

mysql -uasteruser -pasterpassword123

Добавим 4-е коротких номера:

> INSERT INTO asterisk.sippeers
(`name`, `defaultuser`, `host`, `type`, `context`, `secret`, `nat`, `callgroup`, `language`, `disallow`, `allow`, `regexten`, `call-limit`)
VALUES
(‘1001’, ‘1001’, ‘dynamic’, ‘friend’, ‘outcalling’, ‘1234’, ‘no’, ‘1’, ‘ru’, ‘all’, ‘alaw,ulaw’, ‘1001’, ‘4’),
(‘1002’, ‘1002’, ‘dynamic’, ‘friend’, ‘outcalling’, ‘1234’, ‘no’, ‘1’, ‘ru’, ‘all’, ‘alaw,ulaw’, ‘1002’, ‘4’),
(‘1003’, ‘1003’, ‘dynamic’, ‘friend’, ‘outcalling’, ‘1234’, ‘no’, ‘1’, ‘ru’, ‘all’, ‘alaw,ulaw’, ‘1003’, ‘4’),
(‘1004’, ‘1004’, ‘dynamic’, ‘friend’, ‘outcalling’, ‘1234’, ‘no’, ‘1’, ‘ru’, ‘all’, ‘alaw,ulaw’, ‘1004’, ‘4’);

* в данном примере мы создаем 4 номера 1001, 1002, 1003, 1004 с правилом обработки вызова в диалплане outcalling и паролем 1234.

Обновить запись можно командой UPDATE, например:

> UPDATE asterisk.sippeers SET `secret`=’password’ WHERE `name`=’1001′;

Проверить состояние абонентов и транков SIP можно подключившись к консоли Asterisk:

asterisk -r

*CLI> sip show peers

Правила вызова (контекст)

Открываем следующий файл:

vi /etc/asterisk/extconfig.conf

Добавляем в раздел :

…
extensions => odbc,asterisk-conf,extensions

Открываем файл extensions.conf:

vi /etc/asterisk/extensions.conf

Создаем диалплан (группу правил):

switch => Realtime/outcalling@extensions

Перезапускаем астер:

systemctl restart asterisk

Подключаемся к базе и добавляем правило в диалплан outcalling:

mysql -uasteruser -pasterpassword123

> INSERT INTO asterisk.extensions VALUES (NULL, ‘outcalling’, ‘_XXXX’, ‘1’, ‘DIAL’, ‘SIP/${EXTEN},,m’);

Activating the License

In order to run reports, you need a valid activation code to get your license, either a trial or purchased one. Once you have your code at hand, use your browser and go to:

Continue reading the Administrator Guide in order to configure or set preferences for your reports.

Настройки очереди Колл Центра Asterisk (FreePBX)

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

Реализацию функционала колл-центра в Asterisk можно условно разделить на уровень АТС, уровень приложений АТС и уровень приложений 3-й стороны (3rd party) :

Базовые функции маршрутизации и обработки вызовов реализованы непосредственно в Asterisk:

Организация очереди (обработка вызовов в порядке поступления).
Маршрутизация вызова по номеру абонента.
Интерактивные Голосовые Сообщения / IVR.
Распределение вызовов среди агентов по занятости или по порядку.

Гибкое распределение вызовов между агентами колл центра в соответствии с заданной политикой.

Звонят все агенты
Звонят наименее занятые
Вызываются по кругу с последнего ответившего.
Линейно (в порядке перечисления)
Случайным образом

Параметры времени и операторов

Так же «очередь» имеет множество опций обработки вызова и работы агентов:

Приветствие оператору — проигрывается агенту прежде чем, тот соединиться с позвонившим из очереди

(например: «звонок из очереди «Продажи» — при обработке одним агентом звонков из нескольких очередей).

Приветствие позвонившему — проигрывается один раз при попадании в очередь.
Музыка на удержании — проигрывается при ожидании в очереди, можно заменить на рекламную информацию.
Максимальное время ожидания в очереди или неограниченно.
Максимальная длина очереди — максимальное количество позвонивших или неограниченно.
Стратегия дозвона (смотри выше: тип выбора свободного агента)
Таймаут — время вызова свободного оператора или неограниченно
Повтор — время повторения вызова операторов.
Передышка — пауза для оператора завершившего разговор вызов.
Сообщение о позиции в очереди
Сообщение о среднем времени ожидания в очереди.
Вставка сообщения авто-секретаря с возможностями прямого набора номера или системы голосовых меню.

Рассчитывается среднее время ожидания в очереди и ожидающий абонент информируется о номере в очереди и оставшемся времени ожидания.

Параметры ёмкости очереди

Приложения контроля интеллектуального набора. Хотя набор номеров и маршрутизацию осуществляет сам Asterisk, для интеллектуального дозвона требуется приложение которое инициировало бы вызовы по заданному списку и управляло алгоритмом набора.

Автоматизированный набор номера (predictive dialer)

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

Визуализация данных о клиенте (карточка клиента) на основании номера абонента (CallerID)

Recordings and FreePBX

Asternic CDR Reports can be configured to listen/download to recordings if they are stored in the CDR tables already. Different backends might use different ways to store that meta data. In this article we will describe the needed settings to make recordings availabe with FreePBX version 12 and up.

Log as an administrator into Asternic CDR Reports PRO by pointing your browser to http://your.server/cdrstats and select Setup / Preferences from the menu.

Once there be sure to add the following settings:

The above settings indicates that the filename for the recording is to be foudn on the recordingfile field on the CDR table.

The above setting will instruct Asternic to find the recording file over the directory /var/spool/asterisk/monitor and the YEAR / MONTH / DAY subdirectories.

Finally:

This one is there for security reasons, to not let downloads outside from /var/spool/asterisk/monitor to happen.

With those settings in place, you will see icons to play/download recordings if they are available on your system.

Call Detail Record (CDR)

Теперь настроем хранение журнала вызовов в базе данных.

Открываем следующий файл:

vi /etc/asterisk/cdr_adaptive_odbc.conf

Добавляем в самый низ:

connection=asterisk-conf
table=cdr
alias src => source
alias channel => source_channel
alias dst => dest
alias dstchannel => dest_channel

Перезапускаем астериск:

systemctl restart asterisk

Пробуем позвонить через наш астериск и после звонка смотрим записи в базе:

mysql -uasteruser -pasterpassword123 -e «SELECT * FROM cdr»

Получим примерно следующее:

Или в более читаемом виде:

Поле	Пример значения	Описание поля
accountcode	NULL	Дополнительное поле для идентификации клиента. Может использоваться, если не хватает стандартного набора параметров.
src	1001	Кто звонит.
dst	1004	Кому позвонили.
dcontext	outcaling	Контекст (группа правил обработки звонка).
clid	«1001» <1001>	Caller identification или CID. Состоит из имени и номера звонящего.
channel	SIP/1001-00000000	Канал, который принимает вызов.
dstchannel	SIP/1004-00000001	Канал исходящего вызова.
lastapp	Dial	Dialplan обработки вызова.
lastdata	SIP/1004,,m	Что передавалось в lastapp.
start	2017-12-07 16:11:24	Начало звонка.
answer	NULL	Время, за которое подняли трубку. NULL — трубку не подняли.
end	2017-12-07 16:11:32	Дата и время окончания звонка.
duration	7	Длительность звонка в секундах.
billsec	Время разговора (с момента поднятия трубки).
disposition	NO ANSWER	Состояние вызова. Возможные варианты: — ANSWERED — отвечен. — NO ANSWER — ответа нет. — CONGESTION / FAILED — ошибка вызова. — BUSY — занято.
amaflags	DOCUMENTATION	Не используется.
userfield	NULL	Пользовательские параметры для канала.
uniqueid	1512652284.0	Уникальный идентификатор канала звонящего.
linkedid	1512652284.0	Уникальный идентификатор канала звонящего.
peeraccount	NULL	Код учетной записи канала Стороны 2.
sequence	Номер последовательности канала.

Также существуют продукты, позволяющие в графическом интерфейсе смотреть CDR. Например, веб-приложение Asterisk CDR Viewer Mod.

Asterisk call data records in comma-separated text files

По умолчанию, Asterisk генерирует CDR записи в точко разделенные тестовые файлы в директории /var/log/asterisk/cdr-csv. Файл Master.csv содержит все записи. Детализированные записи могут быть частично сконфигурированы на основе канала, и некоторые из данных для IAX и SIP могут быть определены на пользовательском уровне. Конфигурация Zap для CDR записей определяется каналом в zaptel.conf

Для того чтобы с этим работать, вам надо загрузить cdr_csv.so. Введите “ show modules” в CLI и вы увидите, загружен он или нет. Если нет: напечатайте “ load cdr_csv.so” в CLI. Вам также надо добавить эту команду в /etc/asterisk/modules.conf, если Астериск не автоматически включает этот модуль при запуске.

accountcode: Какой учетный номер используется: account, (строка, 20 символов)
src: Номер Caller*ID (строка, 80 символов)
dst: Расширение направления (строка, 80 символов)
dcontext: Контекст направления (строка, 80 символов)
clid: Caller*ID с текстом (80 символов)
channel: Используемый канал (80 символов)
dstchannel: Канал направления, если подходит (80 символов)
lastapp: Последнее приложение, если подходит (80 символов)
lastdata: Дата последнего приложения (аргументы) (80 символов)
start: Начало вызова (дата/время)
answer: Ответ вызова (дата/время)
end: Конец вызова (дата/время)
duration: Полное время в системе, в секундах (целое), от набора номера до зависания
billsec: Полное время вызова, в секундах (целое), от ответа до зависания
disposition: Что случилось с вызовом: ANSWERED, NO ANSWER, BUSY, FAILED (на некоторых CDR выходных буферах, например ODBC, они могут быть целыми; заметьте, что более детальная инфа может быть найдена в переменной диалплана $HANGUPCAUSE)
amaflags: Какой флаг используется: смотри amaflags: DOCUMENTATION, BILLING, IGNORE и т.д., указанного на базисе каждого канала подобно accountcode.

В некоторых случаях появляется uniqueid:

uniqueid: Уникальный Идентификатор Канала (32 символа)

Замечание: Вы можете редактировать файл источник cdr_csv.c для того, чтобы разрешить CSV_LOGUNIQUEID (она отключена по умолчанию)

источник

Сборка Asterisk

Если Asterisk уже установлен и изначально не собирался с учетом MySQL, необходимо выполнить сборку снова. Сначала смотрим версию установленного Asterisk:

asterisk -V

wget https://downloads.asterisk.org/pub/telephony/asterisk/asterisk-15-current.tar.gz

Распаковываем архив и переходим в каталог с распакованным содержимым:

tar -xvf asterisk-*.tar.gz

cd asterisk-*

Конфигурируем исходник:

./configure … —with-mysqlclient

* где … — опции + with-mysqlclient, который отвечает для работу с MySQL.

Например:

./configure —prefix=/usr —sysconfdir=/etc —localstatedir=/var —libdir=/usr/lib64 —with-dahdi —with-pri —with-iconv —with-libcurl —with-speex —with-mysqlclient

Открываем окно дополнительных настроек:

make menuselect

В разделе Add-ons ставим все опции, связанные с mysql: