Для управления настройками системы CDR используется интерфейс командой строки и Web-интерфейс.

Команды, предназначенные для управления настройками CDR, располагаются на виртуальной файловой системе CLI в директории /domain/<DOMAIN>/cdr/. Описание команд приведено в разделе 3.14.0 Справочник команд CLI.

Для управления CDR-файлами через Web-конфигуратор используется приложение 3.14.0 Менеджер cdr (Cdr manager).

Если система в кластере, предварительно должна быть настроена Репликация БД MySQL.

Порядок настройки системы CDR:

  1. Настройки TTS;
  2. Создание и настройка CDR-группы;
  3. Добавление алиаса (абонента) или транка в определенную CDR-группу.

Настройка системы сбора CDR через CLI

Создание CDR-группы

Создание групп производится командой:

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

Для группы устанавливаются параметры аналогичные параметрам домена:

  • prefix - префикс имени файла для группы;
  • mode - режим закрытия файла для группы.
    Режимы закрытия файла аналогичны режимам в домене:
  • count - ограничение на количество cdr-записей в файле;
  • perios - ограничение по длительности, задает периодичность смены файла в секундах;
  • time - ограничение по времени суток, определяет список временных отметок, в которые производится смена файла.
    Если какой либо из параметров при создании группы не указан, то его значение устанавливается равным аналогичному параметру для домена.

Путь команды:

/domain/<DOMAIN>/cdr/add_cdr_group

Синтаксис:

add_cdr_group <NAME> [prefix <"PREFIX">] [mode <MODE>]

Параметры:

  • <NAME> - имя новой группы;
  • <PREFIX> - префикс имени файла для группы;
  • <MODE> - режим закрытия файла: count <NUMBER>, period <TIMER>, time <TIME1> [<TIMES>]:
  • <NUMBER> - количество CDR-записей в файле.
  • <TIMER> - ограничение на длительность записи в один файл в секундах.
  • <TIME> - время суток в формате ЧЧ:ММ:СС либо ЧЧ:ММ.
  • <TIMES> - список времен в сутках, разделенных пробелом в формате аналогичном <TIME>.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/add_cdr_group cdr4brn mode time 00:30 prefix bsk4         
ok

[exec at: 23.02.2019 17:48:27, exec time: 142ms, nodes: core1@ecss2]

Если значения параметров группы при создании не были заданы, то их значения определяются из настроек домена.
Значения параметров для группы устанавливаются в момент создания группы. Изменение общих значений параметров для виртуальной АТС не приводит к изменению индивидуальных значений параметров для группы внутри этой АТС.

  1. Создание CDR-группы cdr_test для виртуальной АТС d.cargo без указания дополнительных параметров:

    /domain/d.cargo/cdr/add_cdr_group cdr_test                               
ok

  2. Создание CDR-группы cdr_test для виртуальной АТС d.cargo с указанием режима работы группы с разбивкой по времени (в момент времени 00:00:00 создавать новый CDR-файл):

    /domain/d.cargo/cdr/add_cdr_group cdr_test mode time 00:00:00         
ok

Просмотр параметров групп производится командой: 

Команда для просмотра информации о настройках группы (всех групп) "cdr_group":

  • name - имя группы;
  • prefix - префикс имени файла для группы;
  • format - формат файла для группы;
  • mode - режим закрытия файла для группы.

Путь команды:

/domain/<DOMAIN>/cdr/show_cdr_group

Синтаксис:

show_cdr_group [<NAME>]

Параметры:

<NAME> - имя группы, опциональный параметр.
Для просмотра информации о всех группах параметр <NAME> не задается или указывается символ "*".

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/show_cdr_group bsk3 
┌────┬──────┬──────┬────────┐
│Name│Prefix│Format│  Mode  │
├────┼──────┼──────┼────────┤
│bsk3│bsk3  │csv   │time    │
│    │      │      │00:00:00│
└────┴──────┴──────┴────────┘

[exec at: 23.02.2019 17:46:09, exec time: 100ms, nodes: core1@ecss2]

Удаление группы производится командой:

Команда служит для удаления определенной группы "cdr_group" из системы.

Путь команды:

/domain/<DOMAIN>/cdr/remove_cdr_group

Синтаксис:

remove_cdr_group <NAME>

Параметры:

  • <NAME> - имя группы.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/remove_cdr_group bsk4 
ok
[exec at: 23.02.2019 17:53:06, exec time: 133ms, nodes: core1@ecss2]

Изменение параметров группы производится командой:

Данной командой производится изменение параметров ранее созданной группы "cdr_group".

Путь команды:

/domain/<DOMAIN>/cdr/change_cdr_group

Синтаксис:

change_cdr_group <NAME> [prefix <"PREFIX">] [mode <MODE>]

Параметры:

  • <NAME> - имя новой группы;
  • <PREFIX> - префикс имени файла для группы;
  • <MODE> - режим закрытия файла: count <NUMBER>, period <TIMER>, time <TIME1> [<TIMES>]:
  • <NUMBER> - количество CDR-записей в файле;
  • <TIMER> - ограничение на длительность записи в один файл, в секундах;
  • <TIME> - время суток в формате ЧЧ:ММ:СС либо ЧЧ:ММ;
  • <TIMES> - список времен в сутках, разделенных пробелом в формате аналогичном <TIME>.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/change_cdr_group bsk4 mode count 1000 
ok
[exec at: 23.02.2019 17:50:21, exec time: 186ms, nodes: core1@ecss2]

Добавление абонента и транка в определенную CDR-группу

Параметр с именем "cdr_group" определяет, к какой группе относится абонент или транк. Его значение должно представлять собой строку, состоящую из символов английского алфавита и/или цифр.

Предварительно эта группа должна быть создана. Если для абонента/транка настроен параметр "cdr_group", но на текущий момент данной группы не существует (например, группа была создана, но её удалили), то вызов, поступивший от такого абонента/транка, будет отнесен к группе по умолчанию (default). Если абоненту/транку, с которого совершается вызов, не назначена группа, то настройки будут присвоены из значений по умолчанию, установленных для виртуальной АТС.

Добавление абонента

Для добавления абонента (алиаса) в определенную CDR-группу необходимо установить параметр "cdr_group" в свойствах алиаса на требуемом уровне (домена, интерфейса или определенного алиаса).

/domain/<DOMAIN>/alias/set <NUMBER> <GROUPNAME> <INTERFACE> cdr_group <CDRGroupName>

где
<DOMAIN> - имя виртуальной АТС;
<NUMBER> - абонентский номер;
<GROUPNAME> - имя группы интерфейсов, логическая привязка интерфейсов в определенной виртуальной АТС;
<INTERFACE> - имя интерфейса;
<CDRGroupName> - имя CDR-группы.

Пример

Для виртуальной АТС test.domain добавляем абонента 102 (интерфейс ) в CDR-группу test_cdr на уровне алиаса. Логическая группа, в которую входит абонент с номером 102 - test_group:

admin@[mycelium1@ecss1]:/$ domain/test.domain/alias/set 102 test_group 102@test.domain cdr_group test_cdr
There are aliases within domain test.domain affected by settings property cdr_group:
  102  <->  102@test.domain

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

Для добавления вызовов с транка в определенную CDR-группу необходимо установить параметр "cdr_group" в свойствах алиаса на уровне интерфейсов.

/domain/<DOMAIN>/alias/set-for-iface <GROUPNAME> <TRUNK_NAME> cdr_group <CDRGroupName>

где

<DOMAIN> - имя виртуальной АТС;
<GROUPNAME> - имя группы интерфейсов;
<TRUNK_NAME> - имя SIP-транка;
<CDRGroupName> - имя CDR-группы.

Пример

Для виртуальной АТС d.cargo добавляем транк CITY.TRUNK в CDR-группу cdr_test:

/domain/d.cargo/alias/set-for-iface smg.gr CITY.TRUNK cdr_group cdr_test
Affected ifaces in domain: d.cargo
  CITY.TRUNK

Конфигурирование режимов генерации CDR-файла

При создании виртуальной АТС (описание приведено в разделе 3.14.0 Создание виртуальной АТС (домена). Порядок настройки) значения параметров "default_format", "default_mode", "default_prefix" устанавливаются в значения по умолчанию:

default_format = csv
default_mode = time, 00:00:00
default_prefix = ""

Просмотреть значения по умолчанию можно командой:

Данная команда служит для просмотра информации о настройках функционирования подсистемы генерации CDR для вызовов вне групп (режим сохранения, форматы и префикс).

Путь команды:

/domain/<DOMAIN>/cdr/info

Синтаксис:

info

Параметры:

Команда не содержит аргументов.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/info 
┌──────────────┬────────┐
│    Param     │ Value  │
├──────────────┼────────┤
│default_mode  │time    │
│              │00:00:00│
│default_prefix│        │
└──────────────┴────────┘

[exec at: 23.02.2019 16:16:44, exec time: 67ms, nodes: core1@ecss1]

Изменить префикс для всей АТС можно командой: 

Данной командой устанавливается значение префикса по умолчанию, которое используется в имени CDR-файла в домене.

Путь команды:

/domain/<DOMAIN>/cdr/prefix

Синтаксис:

prefix "<PREFIX>"

Параметры:

<PREFIX> - текстовая строка, которая будет добавлена к имени CDR-файла.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/prefix bsk4
ok

[exec at: 23.02.2019 17:41:55, exec time: 198ms, nodes: core1@ecss1]

Изменить режим формирования файла для всей АТС можно командой: 

Данной командой устанавливается режим закрытия (финализации/ротации) текущего файла.

В ECSS-10 поддерживаются следующие режимы закрытия CDR-файла:

  • count - файл закрывается, когда в него записано определенное количество записей;
  • period - файл закрывается по истечении определенного времени с момента открытия файла;
  • time - файл закрывается по достижении определенного времени суток (устанавливаются моменты закрытия файла в сутках).

Путь команды:

/domain/<DOMAIN>/cdr/mode

Синтаксис:

mode <MODE>

Параметры:

  • <MODE> - режим генерации CDR-файлов, принимает значение: count <NUMBER>, period <TIMER>, time <TIME1> [TIMES].
  • <NUMBER> - количество CDR-записей в файле;
  • <TIMER> - ограничение на длительность записи в один файл в секундах;
  • <TIME> - время суток в формате ЧЧ:ММ:СС либо ЧЧ:ММ;
  • <TIMES> - список времен в сутках разделенных пробелом в формате аналогичном <TIME>.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/mode time 01:00
ok
[exec at: 23.02.2019 17:43:59, exec time: 109ms, nodes: core1@ecss2]

Настройка системы сбора CDR через WEB-конфигуратор

Для работы с CDR-файлами через Web-конфигуратор используется приложение "Cdr Manager" ("Менеджер CDR").
Описание приложения приведено в разделе 3.14.0 Менеджер cdr (Cdr manager) или во вкладке ниже.

Менеджер cdr (Cdr manager)

Приложение Web-конфигуратора "Менеджер cdr" ("Cdr manager") позволяет управлять режимами генерации CDR-файлов в рамках определенного домена.

Администратор домена определяет CDR-группы и правила обработки обслуженной нагрузки в определенном домене: формат сохранения CDR-файлов, способ ротации (закрытия) CDR-файла.

CDR-файлы - файлы с записями о разговорах абонентов (CDR - Call Detail Record), используются подсистемой TTS для предоставления информации об обслуженной системой нагрузке оператору системы.

В системе поддерживаются сохранения CDR-файлов в формате csv. Это общепринятый формат представления табличных данных. Каждая строка файла — это одна строка таблицы. Первая строка - имена колонок, колонки разделяются определенным разделителем. Далее указываются строки с данными. По умолчанию в качестве разделителя принят символ ";" (точка с запятой), который может быть изменен в конфигурационном файле.

Режимы ротации CDR-файла:

  • count - файл закрывается, когда в него записано определенное количество записей;
  • period - файл закрывается по истечении определенного времени с момента открытия файла;
  • time - файл закрывается по достижении определенного времени суток (устанавливаются моменты закрытия файла в сутках).

Каждому абоненту/транку может быть назначена CDR-группа (cdr_group).
Вызовы в системе группируются в заданные логические группы. Принадлежность вызова к некоторой группе определяется принадлежностью к этой группе вызывающего абонента или транка, с которого поступил вызов.

Если для абонента/транка была задана CDR-группа, но не были выполнены настройки для данной CDR-группы (например, группа была, но её удалили), то вызов с такого абонента/транка будет отнесен к группе по умолчанию, [DEFAULT].

Подробное описание работы с CDR-файлами для администратора системы приведено в разделе 3.14.0 Управление системой сбора CDR.

Рисунок 1 - Интерфейс Web-приложения "Менеджер cdr" ("Cdr manager")

В разделе "Имя" ("Name") отображается список CDR-групп.

В разделах "Префикс" ("Prefix"), "Формат" ("Format"), "Тип" ("Mode") отображаются настройки определенной группы.

Для выключения/включения записи CDR-файлов нажмите кнопку "Cdr recording":

запись CDR-файлов выключена, для включения нажмите на кнопку

запись CDR-файлов включена, для выключения нажмите на кнопку

Для добавления новой группы "CDR-group", которая в дальнейшем может быть назначена абоненту (группе абонентов) или транку, нажмите на кнопку  и заполните следующие поля:

  • "Имя" ("Name") - имя новой группы;
  • "Префикс" ("Prefix") - префикс имени CDR-файла для группы (текстовая строка, которая будет добавлена к имени CDR-файла);
  • "Тип" ("Mode") - режим закрытия (финализации/ротации) текущего CDR-файла:
    • count - файл закрывается, когда в него записано определенное количество записей;
    • period - файл закрывается по истечении определенного времени с момента открытия файла;
    • time - файл закрывается по достижении определенного времени суток (устанавливаются моменты закрытия файла в сутках).

Для сохранения изменений нажмите кнопку "Ok", для отмены нажмите кнопку "Отмена" ("Cancel").

Для изменения параметров группы CDR-файлов нажмите на кнопку напротив имени группы и измените желаемые настройки:

Для удаления группы "CDR-group" из системы нажмите на кнопку  напротив удаляемой группы.

  • Нет меток