/domain/<DOMAIN>/calls/ - команды управления историей вызовов
В данном разделе описаны команды для ручного удаления устаревших записей в базе данных вызовов и просмотра истории вызовов, доступные администратору виртуальной АТС.
list
Данной командой выполняется просмотр истории вызовов.
Путь команды:
/domain/<DOMAIN>/calls/list
Синтаксис:
list <FILTER>
Параметры:
<FILTER> - условие отбора записей, опциональный параметр, принимает значения:
- --iface <IFACE> - по интерфейсу абонента А или абонента B, где <IFACE> - имя интерфейса;
- --addr <ADDRESS> - по номеру абонента А или абонента B, где <ADDRESS> - номер абонента;
- --addr-a <AddressA> - по номеру абонента А, где <AddressA> - номер абонента А;
- --addr-b <AddressB> - по номеру абонента B, где <AddressB> - номер абонента B;
- --start <StartDate> - по дате начала вызова - показывает вызовы, совершенные в или после указанного данной опцией время, где <StartDate> - дата начала вызова, задается в формате ДЕНЬ.МЕСЯЦ.ГОД часы:минуты:секунды;
- --release <ReleaseDate> - по дате окончания вызова - показывает вызовы, совершенные до или в указанное данной опцией время, где <ReleaseDate> - дата окончания вызова, задается в формате ДЕНЬ.МЕСЯЦ.ГОД часы:минуты:секунды;
- --active <ACTIVE> - показать только активные в данный момент вызовы (true) или все завершенные вызовы (false), где <ACTIVE> принимает значения: true; false. По умолчанию выводятся все вызовы;
- --limit <N> - вывести только <N> записей, начиная с первой;
- --offset <OFFSET> - выводить записи, начиная с <N>-ой;
- --mode <MODE> - тип вызова(acd | callback | internal | message | mgm | normal | refer | supervise)
- normal - обычный вызов. Вызовы, не относящиеся ни к одной из категорий, упомянутых ниже в этом списке, являются обычными и обладают mode = normal.
- acd (automatic call distribution) - вызов, который инициирует очередь для соединения с оператором.
- callback - обратный вызов, инициируемый одним из сервисов ДВО. Например Alarm, Callback, Custom Callback, Autoredial With Callback.
- internal - служебный вызов, используемый некоторыми сервисами ДВО для внутренних нужд. Данные вызовы не попадают в CDR.
- message - вызов, инициируемый сервисом CSTA SendMessage (ECMA-269 17.1.24 Send Message).
- mgm - управление ДВО, выполняемое с телефонного аппарата.
- refer - вызов, инициируемый SSW, в ответ на сообщение Refer (IETF draft-mahy-sip-remote-cc-05 Remote Call Control in SIP using the REFER method and the session-oriented dialog package).
- supervise - вызов, инициируемый для присоединения к разговору супервизора КЦ.
Пример:
admin@ds1@ecss1:/$ domain/biysk.local/calls/list --limit 5 ┌──────────────────┬───────────────────┬──────────────────────┬──────────┬────────────┬────────────┬────────────┬────────────┬─┬─────────┬─────────────┬─────┬──┬─────────────────────────────────┬─┬──┐ │ Call ID │ CallRef │ Start │ Stage │ Original │ Original │ CgPN │ CdPN │T│Duration │ Internal │ISUP │RI│ Release │A│SS│ │ │ │ │ │ CgPN │ CdPN │ │ │ │ │ cause │cause│ │ description │ │ │ ├──────────────────┼───────────────────┼──────────────────────┼──────────┼────────────┼────────────┼────────────┼────────────┼─┼─────────┼─────────────┼─────┼──┼─────────────────────────────────┼─┼──┤ │064cd77bda5fb1f1 │ 4014626752│ 09.02.2021 21:57:01 │ released │ 9057923670│ 246675│ 9057923670│ 246675│n│ 0s│ normal │ 102 │Cg│Call is cancelled by initiator │N│ │ │064cd7bb71a5fcd5 │ 3988889223│ 09.02.2021 22:13:59 │ released │ 4952215312│ 246453│ 4952215312│ 246453│n│ 0s│ normal │ 16 │Cg│Call is cancelled by initiator │N│ │ │064ce00f51de01f0 │ 1027723552│ 10.02.2021 07:42:29 │ released │ 240466│ 240006│ 240466│ 240006│n│ 25s│ normal │ 16 │S │Destroy by no master │Y│* │ │064ce0108c13ac93 │ 1108084610│ 10.02.2021 07:42:48 │ released │ 240006│ *71#│ 240006│ *71#│n│ 8s│ normal │ 16 │Cg│Call is complete │Y│* │ │064ce00f51de01f0 │4134644638149654885│ 10.02.2021 07:42:49 │ released │ 240466│ *71#│ 240466│ *71#│n│ 8s│ normal │ 16 │S │Destroy by no master │Y│* │ └──────────────────┴───────────────────┴──────────────────────┴──────────┴────────────┴────────────┴────────────┴────────────┴─┴─────────┴─────────────┴─────┴──┴─────────────────────────────────┴─┴──┘ Legend: T - type i - internal n - normal c - callback RI - release initiator Cg - calling side Cd - called side S - system A - is call answered Y - yes, call is answered N - no, call isn't answered SS - supplementary services * - supplementary services is present empty - supplementary service isn't present Selected call processes' records: 5 [exec at: 10.02.2021 07:44:58, exec time: 37ms, nodes: core1@ecss1 v.3.14.7.562]
purge
Данной командой выполняется ручное удаление устаревших записей в базе данных вызова.
Перед завершением команда выдаст сообщение с количеством записей, которые были удалены.
Путь команды:
/domain/<DOMAIN>/calls/purge
Синтаксис:
purge --older <ARG>
Параметры:
--older - время, после которого запись считается устаревшей. Заключение делается на основании даты последнего обновления записи.
<ARG> - аргумент команды может принимать следующие значения:
- <N> day[s]|week[s]|month[s]|year[s]
где <N> - количество дней, недель, месяцев, лет. Все записи, которые старше данного срока, будут удалены;
- <YYYY-MM-DD [HH:MM:SS]> - дата. Все записи, которые старше заданной даты, будут удалены.
Пример:
Удалить все записи виртуальной АТС "biysk.local" старше 1 недели.
admin@ds1@ecss1:/$ domain/biysk.local/calls/purge --older 1 week Successfully removed 698 rows [exec at: 10.02.2021 07:47:11, exec time: 121ms, nodes: core1@ecss1 v.3.14.7.562]
show_ss
Данной командой выполняется просмотр информации об услугах, которые были использованы в рамках вызова.
Путь команды:
/domain/<DOMAIN>/calls/show_ss
Синтаксис:
show_ss --call_id <CallID>
Параметры:
<CallID> - идентификатор вызова, по которому будет показана информация об использованных в рамках вызова услугах.
Пример:
admin@ds1@ecss1:/$ domain/biysk.local/calls/show_ss --call_id 064ce00f51de01f0 ┌───────────────────┬──────────┬──────┬──────┬────────────┬───────────────────┬─────────┬──────────┐ │ CallRef │ Name │ CgPN │ CdPN │Participants│ Activated │Activator│ Action │ ├───────────────────┼──────────┼──────┼──────┼────────────┼───────────────────┼─────────┼──────────┤ │ 1027723552│chold │240466│240006│ │10.02.2021 07:42:36│ 240006│invocation│ │ 1027723552│hole │240466│240006│ │10.02.2021 07:42:43│ 240006│invocation│ │ 1027723552│chold │240466│240006│ │10.02.2021 07:42:47│ 240006│invocation│ │ 1027723552│hole │240466│240006│ │10.02.2021 07:42:49│ 240006│invocation│ │4134644638149654885│conference│240006│240466│ │10.02.2021 07:42:49│ 240006│invocation│ │4134644638149654885│ctr │240006│240466│*71# │10.02.2021 07:42:49│ 240006│invocation│ │ 1027723552│ctr │240006│240466│*71# │10.02.2021 07:42:49│ 240006│invocation│ └───────────────────┴──────────┴──────┴──────┴────────────┴───────────────────┴─────────┴──────────┘ [exec at: 10.02.2021 07:44:03, exec time: 33ms, nodes: core1@ecss1 v.3.14.7.562]
terminate
Команда предназначена для принудительного завершения указанного диалога.
Путь команды:
/domain/<DOMAIN>/calls/terminate
Синтаксис:
Usage: terminate [--addr_a <AddressA>] [--addr_b <AddressB>] [--oaddr_a <OriginalAddressA>] [--oaddr_b <OriginalAddressB>] [--call-id <CallId>] [--force]
Параметры:
- --addr-a <AddressA> - по номеру абонента А, где <AddressA> - номер абонента А;
- --addr-b <AddressB> - по номеру абонента B, где <AddressB> - номер абонента B;
- --oaddr-a <OriginalAddressA> - по номеру абонента А, где <OriginalAddressA> - оригинальный номер абонента А;
- --oaddr-b <OriginalAddressB> - по номеру абонента B, где <OriginalAddressB> - оригинальный номер абонента B;
- --call-id <CallId> - идентификатор вызова;
- --all - все;
- --force - выполнение команды без запроса подтверждения.
Пример:
Терминация вызова по b-номеру:
admin@ds1@ecss1:/$ domain/biysk.local/calls/terminate --addr_b 240101 Terminate correctly: 064ce023ed151455 [exec at: 10.02.2021 07:48:26, exec time: 56ms, nodes: core1@ecss1 v.3.14.7.562]
Терминация всех вызовов:
admin@ds1@ecss1:/$ domain/biysk.local/calls/terminate --all [terminate] You are trying to terminate all active calls in current domain. All calls will b e terminated after execute current command. Are you sure?: [yes]/no ?> yes Terminate correctly: 064ce08c63ec8e16 [exec at: 10.02.2021 08:16:06, exec time: 4s 117ms, nodes: core1@ecss1 v.3.14.7.562]
После применения команды в cdr-записи появится код завершения 31, причина разрыва соединения: "Terminated by system administrator"