Понятия, определения

• CDR (Call Detail Record) — детальная запись о параметрах вызова (номера телефонов, время начала разговора, продолжительность разговора и другое).

• CDR-файл — файл с записями о вызовах, используется подсистемой TTS на кластере Core для предоставления информации об обслуженной системой нагрузке оператору системы.

• CDR-группа — имя группы для записи CDR-файлов, логическая группировка в определенной виртуальной АТС.

• Core – кластер системы ECSS-10, отвечающий за управление обслуживанием телефонных вызовов и предоставление услуг. Состоит из подсистем обслуживания телефонных вызовов и предоставления услуг.

• АСР — автоматизированная система расчетов (биллинговая система). Эта система на базе информации из CDR осуществляет расчет стоимости вызовов и выставляет счета абонентам.

Описание принципа работы

Принцип работы TTS

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

1. ct_trike_tts_server — базовый сервис, занимающийся накоплением и обработкой первичной информации, формированием CDR-записей и записью их в БД;
2. ct_trike_cdr_server — сервис занимается генерацией CDR-файлов на основе сформированных подсистемой ct_trike_tts_server-записей;
3. tts_ftp_server — FTP-сервер, использующий БД PostgreSQL в качестве файловой системы. Это приложение предоставляет доступ к файлам CDR, сгенерированным приложением "ct_trike_cdr_server" по протоколу FTP.

База данных TTS содержит следующие объекты:

• tolltickets — таблица с расширенной информацией о вызовах, используется для показа истории вызовов;
• ss — таблица с информацией об использованных в рамках вызова услугах;
• cdr — таблица CDR-записей;
• tree — таблица со структурой файлов и каталогов (виртуальное представление файловой системы CDR);
• inodes — таблица с мета-информацией об объектах виртуальной файловой системы CDR (тип, режим доступа, владельца, время создания, размер);
• data — таблица с данными, связанными с файлами в виртуальной файловой системе CDR;
• tree_view — представление полных сведений о виртуальной файловой системе, информация получена из таблиц tree, inodes и data;
• counters — таблица с системной информацией, необходимой для формирования CDR-файлов типа "counter";
• различные хранимые функции и процедуры для работы с виртуальной файловой системой.

Команды управления сервисом TTS приведены в разделах:

Принцип работы системы сбора CDR

Как правило, по результату обслуживания вызова системой TTS формируется один пакет информации в CDR-файле с полной информацией о вызове. 

Если вызов находится продолжительное время в фазе разговора, осуществляется формирование промежуточных записей (partial cdr). Формирование промежуточных записей производится согласно спецификации ITU-T Q.825 B.1.2 Partial records. Промежуточная CDR-запись формируется с периодичностью, задаваемой параметром "partial_cdr_timeout", по умолчанию составляет 5 минут и может быть изменена, подробное описание приведено в разделе Команды управления сервисом TTS. 

В случае формирования Partial CDR в поле "rec_seq" в первой Partial CDR будет записана цифра 1, у второй — цифра 2 и так далее. В тот момент, как вызов завершится, и будет сформирована финальная запись CDR, в поле "rec_seq" будет записан 0 — это служит признаком, что данный вызов завершен. При этом у каждой Partial CDR будет собственная длительность вызова, поле "datetime" у каждой последующей Partial CDR будет равно времени формирования предыдущей Partial CDR (cоответствующие временные метки должны применяться к отдельным частичным записям, а не к вызову в целом, т. е. временная метка "end" (StartTimeStamp + длительность) записи должна совпадать с временной меткой "start" следующей записи).

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

Если во время звонка абоненты пользовались услугами, формируется запись, у которой поле "type" соответствует "service", в поле "actsusb" будет записан вид услуг, которое было использовано.

Более подробное описание поля CDR в случае использования услуг приведено в разделе Управление системой CDR.

Группировка CDR, структура папок и файлов

CDR-файлы сохраняются на файловой системе в следующей древовидной структуре:

domain
 ├─ some_domain_1
    ├─ default
    │  └─ csv
    ├─ some_group_1
    │  └─ csv
    │  ...
    └─ some_group_n
       └─ csv

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

Информация о вызове записывается в БД PostgreSQL с именем ecss_calls_db в таблицу cdr. 
Сформированные CDR-файлы хранятся на виртуальной файловой системе, которая также хранится в БД PostgreSQL, доступ до которой осуществляется по протоколу FTP.

Имя CDR-файла имеет следующую структуру:

• для режимов "time", "period":
  cdr<Prefix>_<TimeStamp>_<F>.csv

• для режима "counter":
  cdr<Prefix>_<TimeStamp>_<FileNumber>_<F>.csv
  где
  • <Prefix> — префикс имени файла;
  • <TimeStamp> — метка времени создания файла в формате (ГГГГММДД_ЧЧ_ММ_ДД);
  • <FileNumber> — монотонно возрастающий счетчик. Начинается с 1. Для каждого времени формирования CDR типа "counter" свой счетчик;
  • <F> — флаг режима файла, значения описаны в главе "Режимы генерации CDR-файлов".

Примеры имен файлов:

cdrAts23_20150925_11_15_00_p.csv
cdrAts23_20150925_17_00_00_1_с.csv

Формат CDR-файлов

В системе поддерживается формат сохранения файлов с CDR-записями — csv. Это стандартный формат представления данных в табличной форме.

Первая строка в файле — список с именами колонок, которые разделяются символом разделителем (по умолчанию точка с запятой ";").
Каждая следующая строка соответствует одной CDR. В строке перечислены значения полей, разделенные символом разделителем.
Состав полей и названия колонок можно настраивать.

Файлы в этом формате имеют расширение .csv.

Кроме того, система ECSS-10 поддерживает возможность цифровой подписи СDR файлов. В этом случае в CDR-файл добавляется колонка sign, которая содержит подпись данной CDR-записи/файла. Подробнее про цифровую подпись CDR-файлов написано в главе Цифровая подпись СDR файлов, описание полей файлов см. Описание полей CSV-файла.

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

В ECSS-10 поддерживаются следующие режимы сохранения CDR-файлов: "count", "period", "time".

Режим "count"

Режим "count" позволяет сохранять файлы с определенным количеством записей. В этом режиме CDR-файл будет формироваться в момент, когда количество несохраненных в CDR-файл записей типа "count" в базе достигнет заданное значение.

CDR-файлы с типом записей "count" формируются не чаще одного раза в минуту. К имени CDR-файла привязан номер сгенерированного файла. Так, например, если за 1 минуту было сформировано CDR для трех файлов, их имена будут следующие:
cdr_count_20150925_11_15_00_1_c.csv
cdr_count_20150925_11_15_00_2_c.csv
cdr_count_20150925_11_15_00_3_c.csv

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

В имени файлов данного режима присутствует суффикс "c", указывающий на режим "count".

Режим "period"

В режиме "period" CDR-файлы формируются каждые <N> секунд. При этом начало интервала выравнено по 01.01.1970 г. Этот режим позволяет сохранять файлы с ограничением по времени.

Для режима "period" актуально замечание о возможности разнесения записей длительных вызовов (вызовов по услугам) в разные файлы. В имени файлов данного режима присутствует суффикс "p", указывающий на режим "period".

Режим "time"

В этом режиме CDR записываются в текущий файл, пока не наступит очередной заданный момент времени в сутках, по которому происходит закрытие текущего файла и открытие нового. Этот режим позволяет делать "нарезку" файлов в определенные моменты времени в течение суток (например, закрывать файл в 00:00).

Можно задать несколько моментов закрытия файла за сутки, они могут указываться с точностью до секунды (если секунды опущены, то они считаются равными нулю). В имени файлов данного режима присутствует суффикс "t", указывающий на режим "time".

Цифровая подпись СDR-файлов

Система ECSS-10 может производить цифровую подпись CDR-файлов и отдельных записей в рамках CDR-файлов. Для этого необходимо включить цифровую подпись CDR-файлов командой:

/domain/<DOMAIN>/tts/properties/set sign_cdr_enabled true

где

• <DOMAIN> — имя виртуальной АТС.

Если включена подпись CDR-файла, то в CDR-файл добавляется колонка с именем SIGN, в которую для каждой записи будет записана её цифровая подпись. Кроме того, в CDR-файле будет создана CDR-запись типа "final", все поля которой, кроме "SIGN", будут пустыми. В поле "SIGN" у данной записи будет подпись всего CDR-файла.

Проверка цифровой подписи СDR-файла:

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

/domain/<DOMAIN>/cdr/validate --line <CDR_Line> | --file <CDR_File_Path>

где

• --line <CDR_Line> — опция для проверки подписи CDR-записи, где <CDR_Line> — имя CDR-записи;
• --file <CDR_File_Path> — опция для проверки подписи CDR-файла, где <CDR_File_Path> — имя CDR-файла.

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

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

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

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

admin@ds1@ecss1:/$ domain/biysk.local/cdr/add_cdr_group cdr4bsk mode time 00:30 prefix bsk4
ok

[exec at: 15.02.2021 15:26:29, exec time: 56ms, nodes: core1@ecss1 v.3.14.7.578]

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

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

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

[exec at: 15.02.2021 15:32:55, exec time: 32ms, nodes: core1@ecss1 v.3.14.7.578]

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

admin@ds1@ecss1:/$ domain/biysk.local/cdr/remove_cdr_group testgroup    
ok

[exec at: 15.02.2021 16:12:18, exec time: 58ms, nodes: core1@ecss1 v.3.14.7.578]

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

admin@ds1@ecss1:/$ domain/biysk.local/cdr/add_cdr_group cdr4bsk mode time 00:30 prefix bsk4
ok

[exec at: 15.02.2021 15:26:29, exec time: 56ms, nodes: core1@ecss1 v.3.14.7.578]

Добавление абонента и транка в определенную 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:

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-файла

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

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

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

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

[exec at: 15.02.2021 15:27:09, exec time: 31ms, nodes: core1@ecss1 v.3.14.7.578]

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

admin@ds1@ecss1:/$ domain/biysk.local/cdr/prefix bsk4
ok

[exec at: 15.02.2021 15:29:08, exec time: 51ms, nodes: core1@ecss1 v.3.14.7.578]

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

admin@ds1@ecss1:/$ domain/biysk.local/cdr/mode time 01:00
ok

[exec at: 15.02.2021 15:28:37, exec time: 46ms, nodes: core1@ecss1 v.3.14.7.578]

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

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

Система переименования колонок CDR

Механизм позволяет переименовывать колонки в выгружаемых файлах CDR.

Установить новое значение имени колонки:

domain/test.ats/tts/properties/set cdr_columns_name <FIXED_COLUMN_NAME> <NEW_COLUMN_NAME>
Пример использования:

domain/test.ats/tts/properties/set cdr_columns_name actsusb test_actsusb
Property "cdr_columns_name" successfully changed from: 
actsusb = call
kod_a = vcd
port_a = cxz
port_b = asd
t_dba = answer
   to
actsusb = test_actsusb
kod_a = vcd
port_a = cxz
port_b = asd
t_dba = answer.

Просмотр выставленных значений:

domain/test.ats/tts/properties/info cdr_columns_name
Пример выполнения команды:

domain/test.ats/tts/properties/info cdr_columns_name
┌────────────────┬────────┬──────────────────────┐
│    Property    │ Domain │        Value         │
├────────────────┼────────┼──────────────────────┤
│cdr_columns_name│test.ats│actsusb = test_actsusb│
│                │        │kod_a = vcd           │
│                │        │port_a = cxz          │
│                │        │port_b = asd          │
│                │        │t_dba = answer        │
└────────────────┴────────┴──────────────────────┘

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

domain/test.ats/tts/properties/clean cdr_columns_name <FIXED_COLUMN_NAME>
Пример выполнения команды:

domain/test.ats/tts/properties/clean cdr_columns_name actsusb      
Property cdr_columns_name values successfully updated

Установить значение по умолчанию для всех колонок:

domain/test.ats/tts/properties/clean cdr_columns_name
Пример выполнения команды:

domain/test.ats/tts/properties/clean cdr_columns_name
Property cdr_columns_name values successfully restored

Описание полей CSV-файла

Таблица 2 — Список полей CSV-файла

Примеры формата записей в случае услуг

CFU

Таблица 3 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса CFU

Для остальных видов переадресации (CFNR, CFB, CFT, CFOS, CFU_Type2, CFNR_Type2, FollowMe, FollowMeNR, FindMe, FindMeNR) записи аналогичны.

CHOLD/HOLE

Таблица 4 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса CHOLD

CTR

Таблица 5 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса CTR

В случае сервиса передачи вызова в CDR формируется 2 записи типа call (звонок с А на B, с B на С), одна запись типа Service с SERVINDIC = CTR.

3WAY

Таблица 6 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса 3WAY

PICKUP

Таблица 7 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса PICKUP

CW

Таблица 8 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса CW

MCID

Таблица 9 — Описание полей сервисной записи CDR, которая сохраняется при активации сервиса MALICIOUS_CALL

MGM (Управление услугами с телефонного аппарата)

Таблица 10 — Описание полей сервисной записи CDR, которая сохраняется при использовании сервиса MGM

Alarm

Таблица 11 — Описание полей сервисной записи CDR, которая сохраняется при использовании сервиса Alarm

CallBack

Таблица 12 — Описание полей сервисной записи CDR, которая сохраняется при использовании сервиса CallBack

CHUNT

Таблица 13 — Описание полей сервисной записи CDR, которая сохраняется при использовании сервиса CHUNT

Conference

При работе сервиса Conference при добавлении каждого участника в конференцию формируется Service запись. Запись у которой KOD_A, KOD_B совпадают — относится к добавлению мастера в конференцию.

Таблица 14 — Описание полей сервисной записи CDR, которая сохраняется при добавлении очередного участника в конференцию (сервис Conference)

Примеры CDR