CDR

Введение

CDR (Call Detail Record) - это сервис, обеспечивающий журналирование выполняемых телекоммуникационным оборудованием вызовов (например телефонных звонков). Смотрите статью в ​Википедии. Для каждого совершенного вызова сохраняется набор данных: дата и время начала и окончания соединения, имя (номер) вызывающего и вызываемого абонентов, направление вызова и т.д.

Как это работает

При наличии в блоке MC04-DSL-3U плат, осуществляющих обслуживание вызовов (например VE-01), при завершении каждого вызова обслуживавшая вызов плата направляет плате SW-01 информацию о выполненном вызове. Плата SW-01 сохраняет полученную информацию в своей внутренней базе данных.

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

Настройка правил автозагрузки CDR файлов

На странице конфигурации блока откройте вкладку "CDR". В блоке "Автоматическая передача CDR файлов" нажмите кнопку "Добавить" для создания нового правила или кликните иконку "Редактировать" для изменения уже существующего правила. Откроется окно конфигурации правила автозагрузки. Назначение его полей следующее:

Имя

Произвольное имя правила. Должно быть уникально в пределах блока. Имя может состоять из симолов латиницы, цифр и символа подчеркивания (_).

Периодичность

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

Хост

Имя хоста или адрес IP FTP сервера, на который будет передаваться информация.

Каталог

Путь к каталогу на сервере, в который будет записываться CDR файл.

Имя пользователя

Имя пользователя для аутентификации на сервере.

Пароль

Пароль для аутентификации на сервере.

Шаблон имени файла

Строка, определяющая правило формирования имени CDR файла. В качестве шаблона используется формат ​strftime, где комбинация символа "проценты" (%) и буквы заменяется элементом даты/времени. Обратите внимание, что при формировании имени файла используется не текущее время, а время из того периода, за который производится выборка информации из базы данных. Например, если задан шаблон имени файла file-%Y-%m-%d.cdr и периодичность загрузки "каждый день", то при наступлении 21 августа 2015 года будет создан файл file-2015-08-20.cdr. Вот основные элементы подстановки, которые могут использоваться в шаблоне имени файла:

• %a - сокращенное название дня недели;
• %A - полное название дня недели;
• %b - сокращенное название месяца недели;
• %B - полное название месяца недели;
• %d - день месяца в виде десятичного числа (от 01 до 31);
• %g - подобно %G, но без столетия;
• %G - Год, 4-значное число, соответствующее номеру недели по ISO (см. %V). Аналогично %Y, за исключением того, что если номер недели по ISO соответствует предыдущему или следующему году, используется соответствующий год;
• %H - номер часа от 00 до 23;
• %j - номер дня в году (от 001 до 366);
• %m - номер месяца (от 01 до 12);
• %p - `am' или `pm';
• %T - текущее время, аналогично %H:%M:%S;
• %u - номер дня недели от 1 до 7, где 1 соответствует понедельнику;
• %U - порядковый номер недели в текущем году. Первым днем первой недели в году считается первое воскресенье года;
• %V - Порядковый номер недели в году по стандарту ISO 8601:1988 от 01 до 53, где 1 соответствует первой неделе в году, в которой как минимум 4 дня принадлежат этому году. Первым днем недели считается понедельник. (Используйте %G or %g для определения соответствующего года);
• %W - порядковый номер недели в текущем году. Первым днем первой недели в году считается первый понедельник года;
• %w - номер дня недели, 0 соответствует воскресенью;
• %y - год без столетия (от 00 до 99);
• %Y - год, 4 цифры включая столетие;
• %% - символ `%'.

Формат записи

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

• %b - номер слота платы, от которой получена информация о вызове;
• %B - имя (название) платы, от которой получена информация о вызове;
• %T - если вызов инициирован со стороны TDM, подставляется тип канального окончания вызывающего абонента (например, для платы VE-01 может принимать значения FXS, FXO, 1IND, R2, PRI и т.п.);
• %t - тип канального окончания вызываемого абонента (если вызов был направлен в сеть TDM), поддерживается начиная с ревизии sw_1.0-r1448;
• %a - время начала соединения (ответа вызываемого абонента) в секундах, считая от 00:00 1 января 1970 г. (UNIX time);
• %Y - год начала соединения, 4 цифры включая столетие;
• %M - номер месяца начала соединения (от 01 до 12);
• %C - день месяца начала соединения (от 01 до 31);
• %F - номер часа начала соединения от 00 до 23;
• %Q - номер минуты начала соединения от 00 до 59;
• %R - номер секунды начала соединения от 00 до 59;
• %N - номер дня в году начала соединения от 001 до 366;
• %V - номер дня недели начала соединения от 0 до 6, 0 - воскресенье;
• %W - номер недели начала соединения в году от 00 до 53. Первым днем первой недели в году считается первый понедельник года;
• %E - время окончания соединения (отбоя) в секундах, считая от 1 января 1970 г. (UNIX time);
• %y - год окончания соединения, 4 цифры включая столетие;
• %m - номер месяца окончания соединения (от 01 до 12);
• %c - день месяца окончания соединения (от 01 до 31);
• %f - номер часа окончания соединения от 00 до 23;
• %q - номер минуты окончания соединения от 00 до 59;
• %r - номер секунды окончания соединения от 00 до 59;
• %n - номер дня в году окончания соединения от 001 до 366;
• %v - номер дня недели окончания соединения от 0 до 6, 0 - воскресенье;
• %w - номер недели окончания соединения в году от 00 до 53. Первым днем первой недели в году считается первый понедельник года;
• %L - длительность соединения в секундах;
• %D - Отображаемое имя вызывающего абонента (если имеется);
• %S - Схема вызывающего абонента - позволяет определить направление вызова. В случае платы VE-01 принимает значение "sip" если вызов поступил из IP сети и "tel" если вызов инициирован со стороны TDM;
• %U - имя пользователя (номер) вызывающего абонента;
• %H - хост вызывающего абонента (если имеется);
• %P - порт вызывающего абонента (если отличался от стандартного 5060);
• %d - Отображаемое имя вызываемого абонента (если имеется);
• %s - Схема вызываемого абонента - позволяет определить направление вызова. В случае платы VE-01 принимает значение "sip" если вызов направлялся в IP сеть и "tel" если вызов направлялся в сторону TDM;
• %u - имя пользователя (номер) вызываемого абонента;
• %h - хост вызываемого абонента (если имеется);
• %p - порт вызываемого абонента (если отличался от стандартного 5060);

Условие выборки

Дополнительно к перечисленным выше настройкам каждому правилу автозагрузки может быть установлено условие выборки из базы данных. Записи из базы данных переносятся в CDR файл только в том случае, если они удовлетворяют заданному условию. Условие выборки состоит из одноного или нескольких выражений вида "Поле - операция - значение". Для добавления выражения в условие кликните по ссылке "Добавить условие". Удалить выражение можно кликом по ссылке "Удалить" в строке выражения. Поля выражений соответствуют полям шаблона "формат записи". Под ответом здесь понимается начало соединения, под отбоем - его окончание. В выражении может быть использовано одно из следующих полей:

• номер слота;
• имя платы;
• тип окончания;
• отображаемое имя вызывающего;
• схема вызывающего;
• имя (номер) вызывающего;
• хост вызывающего;
• порт вызывающего;
• отображаемое имя вызываемого;
• схема вызываемого;
• имя (номер) вызываемого;
• хост вызываемого;
• порт вызываемого;
• длительность соединения (сек.);
• номер года ответа;
• номер месяца ответа;
• день месяца ответа;
• номер часа ответа;
• номер минуты ответа;
• номер секунды ответа;
• номер дня года ответа;
• номер недели ответа;
• номер года отбоя;
• номер месяца отбоя;
• день месяца отбоя;
• номер часа отбоя;
• номер минуты отбоя;
• номер секунды отбоя;
• номер дня года отбоя;
• номер недели отбоя.

В выражении может быть использована одна из следующих операций:

• = - равенство значения поля заданному значению;
• != - неравенство значения поля заданному значению;
• > - значение поля больше заданного значения;
• < - значение поля меньше заданного значения.

Одно и то же поле может использоваться в нескольких разных выражениях. При проверке условия все выражения, в которых используется одно и то же поле и операция равенства (=), объединяются в группы через логическое ИЛИ. Полученные группы и прочие выражения объединяются через логическое И. Например условие из следующих шести выражений:

1. номер слота = 10
2. тип окончания вызывающего = FXS
3. номер слота = 12
4. схема вызываемого = sip
5. длительность соединения > 5
6. тип окончания вызывающего = FXO

будет интерпретировано следующим образом:

(номер слота = 10 ИЛИ номер слота = 12) И (тип окончания вызывающего = FXS ИЛИ тип окончания вызывающего = FXO) И схема вызываемого = sip И длительность соединения > 5

Таким образом, в CDR файл будет записана информация о вызовах, инициированных канальными окончаниями FXS и FXO плат, установленных в слоты 10 и 12, длительностью более 5 секунд в направлении TDM --> IP.

Обратите внимание, что поля номер слота и длительность соединения сравниваются с заданными значениями арифметически, все прочие поля - как текст. Например, при использовании поля номер месяца ответа значение должно задаваться в виде двух цифр, даже если оно меньше десяти: "номер месяца ответа = 03". Условие "номер месяца ответа = 3" никогда не будет выполнено, так как поле номер месяца ответа всегда содержит две цифры.

Просмотр CDR

Для интерактивного просмотра содержащихся в базе данных платы SW-01 CDR служит таблица в нижней части вкладки "CDR". Для каждой записи в таблице отображается номер слота, имя платы, типы канальных окончаний абонентов, время ответа и отбоя, длительность соединения. Схема, отображаемое имя, имя, хост и порт вызывающего и вызываемого сгруппированы в столбцах "Вызывающий" и "вызываемый" соответственно.

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

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