Для управления настройками системы CDR используется интерфейс командой строки и Web-интерфейс.
Команды, предназначенные для управления настройками CDR, располагаются на виртуальной файловой системе CLI в директории /domain/<DOMAIN>/cdr/. Описание команд приведено в разделе Справочник команд CLI.
Для управления CDR-файлами через Web-конфигуратор используется приложение Управление CDR-файлами (Cdr manager).
Порядок настройки системы CDR:
- Настройки TTS;
- Создание и настройка CDR-группы;
- Добавление алиаса (абонента) или транка в определенную CDR-группу.
Настройка системы сбора CDR через CLI
Создание CDR-группы
Создание групп производится командой:
add_cdr_group
Данной командой создается новая группа "cdr_group", которая в дальнейшем может быть назначена абоненту (группе абонентов) или транку. CDR-записи сохраняются в файл (группу файлов), на основании принадлежности абонента А к определенной группе "cdr_group".
Для группы устанавливаются параметры аналогичные параметрам домена:
- prefix - префикс имени файла для группы;
- mode - режим закрытия файла для группы.
Режимы закрытия файла аналогичны режимам в домене: - count - ограничение на количество cdr-записей в файле;
- period - ограничение по длительности, задает периодичность смены файла в секундах (макс. 31536000000 с.);
- 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>.
Пример:
domain/test/cdr/add_cdr_group test_group prefix "ATS23" mode count 1000
ok
domain/test/cdr/add_cdr_group test_group1
ok
domain/test/cdr/add_cdr_group test_group2 prefix ""
ok
domain/test/cdr/add_cdr_group test_group3 prefix mode time 00:00
ok
Создание CDR-группы cdr_test для виртуальной АТС d.cargo без указания дополнительных параметров:
Создание CDR-группы cdr_test для виртуальной АТС d.cargo с указанием режима работы группы с разбивкой по времени (в момент времени 00:00:00 создавать новый CDR-файл):
Просмотр параметров групп производится командой:
show_cdr_group
Команда для просмотра информации о настройках группы (всех групп) "cdr_group":
- name - имя группы;
- prefix - префикс имени файла для группы;
- format - формат файла для группы;
- mode - режим закрытия файла для группы.
Путь команды:
domain/<DOMAIN>/cdr/show_cdr_group
Синтаксис:
show_cdr_group [<NAME>]
Параметры:
<NAME> - имя группы, опциональный параметр.
Для просмотра информации о всех группах параметр <NAME> не задается или указывается символ "*".
Пример:
ssw@[mycelium@ecss3]:/#> domain/d.local/cdr/show_sgroup *
ssw@[mycelium@ecss3]:/#> domain/d.local/cdr/show_cdr_group
------------------------------------
| Name |Prefix|Format|Mode |
|--------------+------+------+-----|
|alex_group |"" |csv |count|
| | | |20 |
|max_group |"" |csv |count|
| | | |20 |
|sveta_group |"" |csv |count|
| | | |3 |
|yahontov_group|"" |csv |count|
| | | |20 |
------------------------------------
Удаление группы производится командой:
remove_cdr_group
Команда служит для удаления определенной группы "cdr_group" из системы.
Путь команды:
domain/<DOMAIN>/cdr/remove_cdr_group
Синтаксис:
remove_cdr_group <NAME>
Параметры:
<NAME> - имя группы.
Пример:
ssw@[mycelium@ecss3]:/#> domain/d.local/cdr/remove_cdr_group TESTER
ok
Изменение параметров группы производится командой:
change_cdr_group
Данной командой производится изменение параметров ранее созданной группы "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>.
Пример:
domain/test/cdr/change_cdr_group test_group prefix ATS23 mode count 1000
ok
domain/test/cdr/change_cdr_group test_group1
ok
domain/test/cdr/change_cdr_group test_group2 prefix ""
ok
domain/test/cdr/change_cdr_group test_group3 prefix mode time 00:00
ok
Добавление абонента и транка в определенную 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 (интерфейс 102@test.domain) в CDR-группу test_cdr на уровне алиаса. Логическая группа, в которую входит абонент с номером 102 - test_group:
Добавление транка
Для добавления вызовов с транка в определенную 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:
Конфигурирование режимов генерации CDR-файла
При создании виртуальной АТС (описание приведено в разделе Создание виртуальной АТС (домена). Порядок настройки) значения параметров "default_format", "default_mode", "default_prefix" устанавливаются в значения по умолчанию:
Просмотреть значения по умолчанию можно командой:
info
Данная команда служит для просмотра информации о настройках функционирования подсистемы генерации CDR для вызовов вне групп (режим сохранения, форматы и префикс).
Путь команды:
domain/<DOMAIN>/cdr/info
Синтаксис:
info
Параметры:
Команда не содержит аргументов.
Пример:
ssw@[mycelium@ecss3]:/#> domain/d.local/cdr/info
-------------------------
| Param | Value |
|--------------+--------|
|default_format|csv |
|default_mode |time |
| |00:00:00|
|default_prefix|"" |
-------------------------
[exec at: 19.10.2011 16:52:27, exec time: 94ms]
Изменить префикс для всей АТС можно командой:
prefix
Данной командой устанавливается значение префикса по умолчанию, которое используется в имени CDR-файла в домене.
Путь команды:
domain/<DOMAIN>/cdr/prefix
Синтаксис:
prefix "<PREFIX>"
Параметры:
<PREFIX> - текстовая строка, которая будет добавлена к имени CDR-файла.
Пример:
ssw@[mycelium@ecss3]:/#> domain/d.local/cdr/prefix "ATS1"
Изменить режим формирования файла для всей АТС можно командой:
mode
Данной командой устанавливается режим закрытия (финализации/ротации) текущего файла.
Путь команды:
domain/<DOMAIN>/cdr/mode
Синтаксис:
mode <MODE>
Параметры:
<MODE> - режим генерации CDR-файлов, принимает значение: count <NUMBER>, period <TIMER>, time <TIME1> [TIMES].
<NUMBER> - количество CDR-записей в файле;
<TIMER> - ограничение на длительность записи в один файл в секундах;
<TIME> - время суток в формате ЧЧ:ММ:СС либо ЧЧ:ММ;
<TIMES> - список времен в сутках разделенных пробелом в формате аналогичном <TIME>.
Пример:
ssw@[mycelium@ecss3]:/#> domain/d.local/cdr/mode count 1000
ssw@[mycelium@ecss3]:/#> domain/d.city/cdr/mode period 60
ssw@[mycelium@ecss3]:/#> domain/d.office/cdr/mode time 00:00
Настройка системы сбора CDR через WEB-конфигуратор
Для работы с CDR-файлами через Web-конфигуратор используется приложение "Cdr Manager" ("Менеджер CDR").
Описание приложения приведено в разделе Управление CDR-файлами (Cdr manager).
Нажмите здесь для раскрытия...
Приложение Web-конфигуратора "Менеджер cdr" ("Cdr manager") позволяет управлять режимами генерации CDR-файлов в рамках определенного домена.
Администратор домена определяет CDR-группы и правила обработки обслуженной нагрузки в определенном домене: формат сохранения CDR-файлов, способ ротации (закрытия) CDR-файла.
В системе поддерживаются сохранения CDR-файлов в формате csv. Это общепринятый формат представления табличных данных. Каждая строка файла — это одна строка таблицы. Первая строка - имена колонок, колонки разделяются определенным разделителем. Далее указываются строки с данными. По умолчанию в качестве разделителя принят символ ";" (точка с запятой), который может быть изменен в конфигурационном файле.
Режимы ротации CDR-файла:
- count - файл закрывается, когда в него записано определенное количество записей;
- period - файл закрывается по истечении определенного времени с момента открытия файла;
- time - файл закрывается по достижении определенного времени суток (устанавливаются моменты закрытия файла в сутках).
Каждому абоненту/транку может быть назначена CDR-группа (cdr_group).
Вызовы в системе группируются в заданные логические группы. Принадлежность вызова к некоторой группе определяется принадлежностью к этой группе вызывающего абонента или транка, с которого поступил вызов.
Подробное описание работы с CDR-файлами для администратора системы приведено в Части 4 Руководство по управлению системой ECSS-10, в разделе Управление системой сбора 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" из системы нажмите на кнопку напротив удаляемой группы.