В текущем разделе описываются команды управления режимами генерации CDR в рамках домена.

CDR - Call Detail Record.
Файлы CDR - информация об обслуженной системой нагрузке.

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

Группа cdr назначается на alias. Команды описаны на странице /domain/<DOMAIN>/alias/ - команды управления алиасами

add_cdr_group

Данной командой создается новая группа "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@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]

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>.

Пример:

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]

info

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

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

/domain/<DOMAIN>/cdr/info

Синтаксис:

info

Параметры:

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

Пример:

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]

make_finalize_cdr

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

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

/domain/<DOMAIN>/cdr/make_finalize_cdr

Синтаксис:

make_finalize_cdr [<CDRGroupName>]

Параметры:

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

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cdr/make_finalize_cdr cdr4bsk 
Created file(s): cdrbsk4_20210215_15_28_09_t.csv

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

mode

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

В 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@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]

prefix

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

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

/domain/<DOMAIN>/cdr/prefix

Синтаксис:

prefix "<PREFIX>"

Параметры:

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

Пример:

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]

remove_cdr_group

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

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

/domain/<DOMAIN>/cdr/remove_cdr_group

Синтаксис:

remove_cdr_group <NAME>

Параметры:

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

Пример:

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]

rename_cdr_group

Команда позволяет переименовать существующую CDR-группу.

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

/domain/<DOMAIN>/cdr/rename_cdr_group

Синтаксис:

rename_cdr_group <OldNAME> <NewNAME>

Параметры:

  • <OldNAME> - старое имя группы;
  • <NewNAME> - новое имя группы.

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cdr/rename_cdr_group cdr4bsk testgroup
Group cdr4bsk successfully renamed to testgroup

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

show_cdr_group

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

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

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

/domain/<DOMAIN>/cdr/show_cdr_group

Синтаксис:

show_cdr_group [<NAME>]

Параметры:

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

Пример:

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]

validate

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

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

/domain/<DOMAIN>/cdr/validate

Синтаксис:

validate --line <CDR_Line> | --file <CDR_File_Path>

Параметры:

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

Примечание. Файлы для проверки цифровой подписи необходимо загрузить в папку */var/lib/ecss/cdr/<DOMAIN>/.

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cdr/validate --file ecss1 cdrbsk3_20210215_15_44_08_t.csv
CDR file is valid.

[exec at: 15.02.2021 15:45:48, exec time: 575ms, nodes: core1@ecss1 v.3.14.7.578]


admin@ds1@ecss1:/$ domain/biysk.local/cdr/validate --line Call;2021.02.15 15:43:45;3854416977;240503;;;7;2;0;16;normal;7;240503;;15;0;0;3854416977;;;3545233635206051129;3854240700;;240700;;192.168.2.26;system:ivr;240503@biysk.local;1;;;RPYhVQq33yv1X7V5BHWexlPS3HgRpTlSBNUlC45psdetAKso/b0LgJmhnXiHtPPPrgzXm1U0Dh8Wkd/LwfFkww==                                                                                        CDR line is valid.                                                                                                                   

[exec at: 15.02.2021 15:50:01, exec time: 25ms, nodes: core1@ecss1 v.3.14.7.578]