/domain/<DOMAIN>/cdr/ - команды управления режимами генерации CDR
В текущем разделе описываются команды управления режимами генерации CDR в рамках домена.
Файлы 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@[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]
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@[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]
info
Данная команда служит для просмотра информации о настройках функционирования подсистемы генерации 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]
make_finalize_cdr
Команда позволяет сделать выгрузку текущих данных о вызовах в CDR-файл. Если параметры не заданы, то CDR-файл формируется для CDR-группы по умолчанию.
Путь команды:
/domain/<DOMAIN>/cdr/make_finalize_cdr
Синтаксис:
make_finalize_cdr [<CDRGroupName>]
Параметры:
- <CDRGroupName> - имя CDR-группы.
Пример:
admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/make_finalize_cdr barnaul Created file(s): cdrbsk4_20190223_17_54_31_t.csv [exec at: 23.02.2019 17:54:31, exec time: 133ms, nodes: core1@ecss2]
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@[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]
prefix
Данной командой устанавливается значение префикса по умолчанию, которое используется в имени 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]
remove_cdr_group
Команда служит для удаления определенной группы "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]
rename_cdr_group
Команда позволяет переименовать существующую CDR-группу.
Путь команды:
/domain/<DOMAIN>/cdr/rename_cdr_group
Синтаксис:
rename_cdr_group <OldNAME> <NewNAME>
Параметры:
- <OldNAME> - старое имя группы;
- <NewNAME> - новое имя группы.
Пример:
admin@[sip1@ecss1]:/$ domain/biysk.local/cdr/rename_cdr_group cdr4brn barnaul Group cdr4brn successfully renamed to barnaul [exec at: 23.02.2019 17:51:56, exec time: 146ms, nodes: core1@ecss2]
show_cdr_group
Команда для просмотра информации о настройках группы (всех групп) "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]
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@[core1@ecss1]:/$ domain/biysk.local/cdr/validate --file ecss1 cdrbsk3_20190305_09_00_00_p.csv CDR file is valid. [exec at: 05.03.2019 09:45:11, exec time: 725ms, nodes: core1@ecss1] admin@[core1@ecss1]:/$ domain/biysk.local/cdr/validate --line Call;2019.03.05 09:26:51;8353632751;246682;biysk.local.smg.gr.trunk.autoname;biysk.local.ssw.gr.trunk.autoname;0;0;11;16;normal;1;246682;;228;1;0;8353632751;;Call is cancelled by initiator;717751315;;;;192.168.2.8;;smg-4;ems2;0;;PCMA,PCMU,G729,telephone-event;5jhhgUEkuIif2nCnSW7kQLyIttmjD/bPhp2+AKDVEtXmIfB5DzLSvarlPAbqmRb2iYz+hS28RWNv02XzRKo3TQ== CDR line is valid. [exec at: 05.03.2019 09:47:13, exec time: 177ms, nodes: core1@ecss1]