bg

Grandstream UCM6100, UCM6200 и UCM6510: настройка CDR

Эта страница охватывает варианты Grandstream Grandstream UCM6200, Grandstream UCM6100 и Grandstream UCM6200 (Real Time) в Advanced PBX Data Logger. В каждом разделе приведены параметры подключения, парсер и поля, которые логгер извлекает для отчётов или базы данных; если шаги настройки одинаковы для всех вариантов, они приведены один раз. Настройки относятся к нашему логгеру; другие программы тарификации могут требовать иной конфигурации.

Кратко

ПараметрGrandstream UCM6100, UCM6200 и UCM6510: настройка CDR
Варианты на этой страницеGrandstream UCM6200, Grandstream UCM6100, Grandstream UCM6200 (Real Time)
ИнтерфейсЗависит от варианта; см. соответствующий раздел.
Порт7777
ПарсерыGrandstream UCM6200, Grandstream UCM6100, Grandstream UCM6200 (Real Time)
Извлекаемых полейот 19 до 20

Варианты на этой странице

  • Grandstream UCM6200 · Записи получаются по HTTP из веб-интерфейса или API системы, полей: 20
  • Grandstream UCM6100 · Записи получаются по HTTP из веб-интерфейса или API системы, полей: 20
  • Grandstream UCM6200 (Real Time) · Локальная сеть, порт 7777, полей: 19

Grandstream UCM6200

Парсер: Grandstream UCM6200
Подключение: Записи получаются по HTTP из веб-интерфейса или API системы.
Извлекаемых полей: 20

Настройки АТС

Вы можете легко изменить настройку через веб-интерфейс.
1. Откройте свой любимый браузер.
2. Перейдите по адресу http://192.168.0.10/ (замените IP-адрес на адрес вашей АТС)
3. Войдите как Administrator.
4. В меню слева выберите CDR → API Configuration.
5. Измените настройки, как показано ниже.
6. (Опционально) Для повышения безопасности вы можете указать разрешённый IP-адрес компьютера, на котором будет установлено наше ПО (например, 192.168.0.10).

CDR. API configuration

Настройка PBX Data Logger

Параметры из документации производителя

Источник: grandstream ucm61xx cdr rec api guide. Приведены значения, указанные в документации; сверьте их с вашей версией прошивки.

ПараметрЗначение по документации
порт API CDR по умолчанию8443

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

ОписаниеТип данныхИмя колонки
Record IDstringFLAG1
Код абонентаstringACC
Набранный номерstringDIALED_PHONE
Вызывающий телефонstringCALLER_PHONE
Тип звонкаstringCALL_TYPE
Исходный channelstringSRC_CH
Конечный channelstringDEST_CH
НаправлениеstringDIRECTION
Caller namestringFLAG2
Charged user IDstringEXT
ЛинияstringTRUNK
Время звонкаdatetimeCALL_TIME
Длительность звонка (с)integerCALL_DURATION_S
Длительность звонкаdatetimeCALL_DURATION
Ожидания ответаdatetimeRING
DispositionstringFLAG3
Unique IDstringFLAG4
User fieldstringFLAG5
СлужбаstringFLAG6
Action ТипstringFLAG7

Grandstream UCM6100

Парсер: Grandstream UCM6100
Подключение: Записи получаются по HTTP из веб-интерфейса или API системы.
Извлекаемых полей: 20

Настройки АТС

Вы можете легко изменить настройку через веб-интерфейс.
1. Откройте свой любимый браузер.
2. Перейдите по адресу http://192.168.5.220/ (замените IP-адрес на адрес вашей АТС)
3. Войдите как Administrator.
4. В меню слева выберите CDR → API Configuration.
5. Измените настройки, как показано ниже.
6. Для повышения безопасности вы можете указать разрешённый IP-адрес компьютера, на котором будет установлено наше ПО.

CDR. API configuration

Настройка PBX Data Logger

1. Advanced PBX Data Logger должен быть настроен в режим HTTP(S) client, укажите целевой URL-адрес вашей АТС (см. пример ниже): "". Номер порта должен совпадать со значением из настроек CDR, указанных выше. URL может также включать номер порта, логин и пароль.

HTTP Client Mode

2. На странице "Modules" необходимо выбрать соответствующий плагин запроса данных и парсера.

Modules

3. Нажмите кнопку "Setup" рядом с плагином запроса данных и настройте интервал опроса (по умолчанию 30 секунд).

Poll interval

Параметры из документации производителя

Источник: grandstream ucm61xx cdr rec api guide. Приведены значения, указанные в документации; сверьте их с вашей версией прошивки.

ПараметрЗначение по документации
состояние включения CDR/REC APIdisabled by default
TLS Bind Address / порт API0.0.0.0:8443 (port 8443)
значение по умолчанию Permitted IP(s)пусто, что означает запрет всех IP-адресов
формат вывода API CDR по умолчаниюcsv
значение по умолчанию/максимум numRecords для API CDR за один запрос1000

Включение вывода SMDR по документации

  1. Включите API и настройте TLS Bind Address, TLS-сертификат/ключ и Permitted IP(s), прежде чем API CDR можно будет опрашивать со стороны стороннего приложения.
  2. Добавьте IP-адрес компьютера, выполняющего запросы, в Permitted IP(s); по умолчанию этот список пуст и запрещает доступ с любого адреса, поэтому API CDR будет отклонять все запросы, пока адрес не будет добавлен.

Замечания о формате записи

  • Запросы к API CDR используют форму URL https://[UCM IP]:[Port]/cdrapi?[option]=[value]&... с параметрами запроса, включающими format, numRecords, offset, caller, callee, startTime, endTime, minDur и maxDur.
  • Строка заголовка вывода CSV: AcctId,accountcode,src,dst,dcontext,clid,channel,dstchannel,lastapp,lastdata,start,answer,end,duration,billsec,disposition,amaflags,uniqueid,userfield,channel_ext,dstchannel_ext,service.
  • Вывод XML оборачивает каждую запись в элементы <cdr>...</cdr> внутри одного элемента <root>, повторно используя названия колонок CSV в качестве тегов элементов.
  • Вывод JSON представляет собой объект верхнего уровня с массивом "cdr", содержащим объекты для каждого звонка, снова использующие те же названия полей в качестве ключей.

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

ОписаниеТип данныхИмя колонки
Record IDstringFLAG1
Код абонентаstringACC
Набранный номерstringDIALED_PHONE
Вызывающий телефонstringCALLER_PHONE
Тип звонкаstringCALL_TYPE
Исходный channelstringSRC_CH
Конечный channelstringDEST_CH
НаправлениеstringDIRECTION
Caller namestringFLAG2
Charged user IDstringEXT
ЛинияstringTRUNK
Время звонкаdatetimeCALL_TIME
Длительность звонка (с)integerCALL_DURATION_S
Длительность звонкаdatetimeCALL_DURATION
Ожидания ответаdatetimeRING
DispositionstringFLAG3
Unique IDstringFLAG4
User fieldstringFLAG5
СлужбаstringFLAG6
Action ТипstringFLAG7

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

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

<sub_cdr>
      <AcctId>184</AcctId>
      <accountcode/>
      <src>3259</src>
      <dst>6474</dst>
      <dcontext>ext-local</dcontext>
      <clid>"Name Surname   " &lt;3259&gt;</clid>
      <channel>PJSIP/3259-000xxxxf</channel>
      <dstchannel>PJSIP/6474-000000a0</dstchannel>
      <lastapp>Dial</lastapp>
      <lastdata>PJSIP/6474/sip:6474@10.224.21.193:5060,30,zb(callee-handler^s^1)</lastdata>
      <start>2018-03-01 07:38:11</start>
      <answer>2018-03-01 07:38:15</answer>
      <end>2018-03-01 07:38:58</end>
      <duration>46</duration>
      <billsec>42</billsec>
      <disposition>ANSWERED</disposition>
      <amaflags>DOCUMENTATION</amaflags>
      <uniqueid>1519911491.511</uniqueid>
      <userfield>Internal</userfield>
      <channel_ext>3259</channel_ext>
      <dstchannel_ext>6474</dstchannel_ext>
      <service>s</service>
      <caller_name>Name Surname   </caller_name>
      <recordfiles/>
      <dstanswer>6474</dstanswer>
      <chanext/>
      <dstchanext/>
      <session>151xxxxxxxxxxxxx-3259</session>
      <action_owner>3259</action_owner>
      <action_type>DIAL</action_type>
      <src_trunk_name/>
      <dst_trunk_name/>
    </sub_cdr>

Grandstream UCM6200 (Real Time)

Парсер: Grandstream UCM6200 (Real Time)
Подключение: Локальная сеть. АТС передаёт записи на компьютер с логгером; логгер слушает TCP-порт 7777. Порт 7777.
Извлекаемых полей: 19

Настройки АТС

Примечание: функция CDR Real-Time Output добавлена начиная с прошивки 1.0.17.16 на UCM62xx/UCM6510 и начиная с прошивки 1.0.5.4 на UCM630xA.

Вы можете изменить настройку АТС через веб-интерфейс.
1. Откройте свой любимый браузер.
2. Перейдите по адресу http://192.168.0.10/ (замените IP-адрес на адрес вашей АТС)
3. Войдите как Administrator.
4. В меню слева:
4.1 Выберите "CDR → API Configuration".
4.2 Или в более новых версиях "Value-added features → API Configuration".
5. Перейдите на вкладку "Real Time /CDR Real-time output settings".
6. Укажите IP-адрес/порт компьютера с Advanced PBX Data Logger (например: 172.16.135.23 и 7777). На этом компьютере должен быть статический IP-адрес.

Real Time CDR. API configuration

Данные, извлекаемые PBX Data Logger: Grandstream UCM6200 (Real Time)

ОписаниеТип данныхИмя колонки
Record IDstringFLAG1
Код абонентаstringACC
Набранный номерstringDIALED_PHONE
Вызывающий телефонstringCALLER_PHONE
Тип звонкаstringCALL_TYPE
Исходный channelstringSRC_CH
Конечный channelstringDEST_CH
НаправлениеstringDIRECTION
Caller namestringFLAG2
Charged user IDstringEXT
Время звонкаdatetimeCALL_TIME
Длительность звонка (с)integerCALL_DURATION_S
Длительность звонкаdatetimeCALL_DURATION
Ожидания ответаdatetimeRING
DispositionstringFLAG3
Unique IDstringFLAG4
User fieldstringFLAG5
СлужбаstringFLAG6
Action ТипstringFLAG7

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

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

'73436','','050xxxxxxx','171','from-internal','"" <050xxxxxxx>','DAHDI/o7-1','PJSIP/171-000021c0','Dial','PJSIP/170/sip:170@172.16.132.55:5060&PJSIP/173/sip:173@172.16.132.107:5060&PJSI','2018-07-30 16:11:41','2018-07-30 16:11:56','2018-07-30 16:11:56','14','0','NO ANSWER','DOCUMENTATION','1532952700.27036','Inbound','o7','171','p','','','','','','153xxxxxxxxxxxxx-050xxxxxxx','050xxxxxxx','RINGGROUP[6400]','Etisalat_024xxxxxx','',
'73437','','050xxxxxxx','111','from-internal','"" <050xxxxxxx>','DAHDI/o7-1','PJSIP/111-000021c1','Dial','PJSIP/170/sip:170@172.16.132.55:5060&PJSIP/173/sip:173@172.16.132.107:5060&PJSI','2018-07-30 16:11:41','2018-07-30 16:11:56','2018-07-30 16:12:10','28','13','ANSWERED','DOCUMENTATION','1532952700.27036','Inbound','o7','111','p','','','111','','','153xxxxxxxxxxxxx-050xxxxxxx','050xxxxxxx','RINGGROUP[6400]','Etisalat_024xxxxxx','',
'73438','','050xxxxxxx','6400','ext-group','"" <050xxxxxxx>','DAHDI/o4-1','','ForkCDR','are','2018-07-30 16:12:19','2018-07-30 16:12:20','2018-07-30 16:12:20','0','0','ANSWERED','DOCUMENTATION','1532952739.27079','Inbound','o4','6400','p','','','6400','','','153xxxxxxxxxxxxx-050xxxxxxx','050xxxxxxx','RINGGROUP[6400]','Etisalat_024xxxxxx','',

Подключение логгера

Добавьте в PBX Data Logger источник данных, соответствующий интерфейсу из раздела вашего варианта (RS232, TCP-клиент, TCP-сервер или FTP), затем откройте Модули → Запрос Разбор Фильтр → Запрос данных, нажмите «Настройка» и выберите указанный там парсер.

Читает записи Grandstream UCM6100, UCM6200 и UCM6510. Парсеры для всех 3 моделей с этой страницы уже встроены.

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

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

Похожие системы Grandstream

Grandstream UCM6500 (Real Time)
Greenlite
GoldStar GPS-6A
Genbend M6
Все поддерживаемые АТС

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