Asterisk Fonality (CSV): настройка SMDR и формат CDR

На этой странице описано, как получить записи о вызовах (SMDR/CDR) от Asterisk Fonality (CSV) в Advanced PBX Data Logger: параметры подключения, выбор парсера и 17 полей, которые логгер извлекает для отчётов или базы данных. Настройки относятся к нашему логгеру; другие программы тарификации могут требовать иной конфигурации.

Кратко

Параметр	Asterisk Fonality (CSV)
Интерфейс	Файлы CDR загружаются по FTP с АТС или её сервера и разбираются по мере поступления.
Порт	21
Парсер	Asterisk Fonality (CSV)
Извлекаемых полей	17

Asterisk — это программная АТС с открытым исходным кодом, распространяемая по лицензии GPL.

Настройка Asterisk

Для этого необходимо, чтобы был загружен модуль cdr_csv.so. Команды show modules или module show, введённые в CLI, покажут, загружен ли он. Если нет: введите в CLI команду load cdr_csv.so. Также рекомендуется добавить эту команду загрузки в /etc/asterisk/modules.conf, если Asterisk не подключил этот модуль автоматически при запуске.

Также необходимо отредактировать файл cdr.conf. Он расположен в каталоге /etc/asterisk/.

[general]

; Define whether or not to use CDR logging.  Setting this to "no" will override
; any loading of backend CDR modules.  Default is "yes".
enable=yes
unanswered=yes (or no)

Затем cdr_custom.conf

[mappings]

Master.csv => "${CDR(clid)}","${CDR(src)}","${CDR(dst)}","${CDR(dcontext)}","${CDR(channel)}","${CDR(dstchannel)}","${CDR(lastapp)}","${CDR(lastdata)}","${CDR(start)}","${CDR(answer)}","${CDR(end)}","${CDR(duration)}","${CDR(billsec)}","${CDR(disposition)}","${CDR(amaflags)}","${CDR(accountcode)}","${CDR(uniqueid)}","${CDR(userfield)}","${CDR(sequence)}"

Как проверить статус службы CDR

CLI> cdr show status
Call Detail Record (CDR) settings
----------------------------------
  Logging:                    Enabled
  Log unanswered calls:       Yes
  Log congestion:             No

* Registered Backends
  -------------------
    csv

Настройка логгера для АТС PBX Data Logger

1. Создайте новый источник данных типа "File".
2. Кликните по кнопке "Действие → Добавить...".
3. Выберите тип соединения "FTP" и настройте параметры подключения к FTP серверу на вашей АТС.
4. Подкорректируйте настройки чтения данных.

Добавление нового файлового источника данных для Asterisk Fonality [CSV]

Asterisk Fonality [CSV]. Выбор типа источника данных.

Настройка соединения FTP к Asterisk Fonality [CSV]

192.168.0.254

/var/log/asterisk/cdr-custom/

Master*.csv

admin

Настройка параметров чтения файла для Asterisk Fonality [CSV]

Выбор правильного модуля-парсера для Asterisk Fonality (CSV)

Asterisk Fonality (CSV)

Данные, извлекаемые PBX Data Logger

Описание	Тип данных	Имя колонки
Caller name	string	FLAG1
Вызывающий телефон	string	CALLER_PHONE
Исходный	string	FLAG2
Конечный	string	FLAG3
Направление	string	DIRECTION
Расширение	string	EXT
Линия	string	TRUNK
Конечный contРасширение	string	FLAG4
Тип звонка	string	CALL_TYPE
Время звонка	datetime	CALL_TIME
Длительность звонка (с)	integer	CALL_DURATION_S
Длительность звонка	datetime	CALL_DURATION
Ожидания ответа	datetime	RING
Desposition	string	FLAG5
AMA Признакs	string	FLAG6
Код абонента	string	ACC
Идентификатор вызова	string	FLAG7

Пример записи

Запись в том виде, в каком её выдаёт система; телефонные номера, имена и внешние адреса скрыты.

"","5444","916xxxxxxxxx","internal","""A Person   "" <5444>","SIP/0004F27E5A3C-000213a6","SIP/ATT-000213a7","Dial","SIP/ATT/162xxxxxxxx,,W","2020-01-31 14:36:34","2020-01-31 14:36:42","2020-01-31 14:38:16",102,94,"ANSWERED","DOCUMENTATION","1580502994.260534","SIP/0004F27E5A3C-000213a6<ssrc=1595049192;themssrc=311xxxxxxx;lp=0;rxjitter=0.000220;rxcount=4684;txjitter=0.000046;txcount=4679;rlp=0;rtt=0.000000>SIP/ATT-000213a7<ssrc=926xxxxxx;themssrc=1630575087;lp=0;rxjitter=0.000292;rxcount=4679;txjitter=0.000000;txcount=4684;rlp=0;rtt=0.060000>","srcip=10.0.68.126","dnid=916xxxxxxxxx"
"316xxxxxxx","470xxxxxxx","s","Sales","""Sales"" <470xxxxxxx>","SIP/ATT_Second_IP-000213a8","Local/#401xxxxx@neoagent-e7a7;1","Queue","Sales,tT,,,120","2020-01-31 14:36:41","2020-01-31 14:36:41","2020-01-31 14:38:22",101,101,"ANSWERED","DOCUMENTATION","1580503001.260536","SIP/ATT_Second_IP-000213a8<ssrc=115xxxxxxx;themssrc=409xxxxxxx;lp=0;rxjitter=0.000501;rxcount=2077;txjitter=0.000000;txcount=4892;rlp=0;rtt=0.000000>","srcip=198.51.100.5","dnid=316xxxxxxx"
"","470xxxxxxx","s","neoagent","""Sales"" <470xxxxxxx>","Local/#401xxxxx@neoagent-e7a7;2","SIP/0004F2CA9174-000213aa","Dial","SIP/0004F2CA9174,15,woCrgtM(neoanswer^5401) ","2020-01-31 14:37:04","2020-01-31 14:37:12","2020-01-31 14:38:22",78,70,"ANSWERED","DOCUMENTATION","1580503024.260541","SIP/0004F2CA9174-000213aa<ssrc=1830756287;themssrc=417xxxxxxx;lp=0;rxjitter=0.000135;rxcount=3477;txjitter=0.000122;txcount=1793;rlp=0;rtt=0.000000>"

Отчёты и база данных

Полученные записи логгер сохраняет в текстовый файл, в любую базу данных через ODBC в реальном времени или передаёт в утилиту PBX Reports, которая строит ручные, запланированные и отправляемые по e-mail отчёты и имеет встроенный веб-сервер. Настройка базы данных описана в статье о записи истории звонков в базу данных.