В данном разделе описаны команды для ручного удаления устаревших записей в базе данных вызовов и просмотра истории вызовов, доступные администратору виртуальной АТС.

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 - вызов, инициируемый для присоединения к разговору супервизора КЦ.
Если одновременно заданы опции --addr-a и --addr-b, выборка производится по номеру абонента А и по номеру абонента В.

Пример:

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" старше 2 месяца назад.

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> - идентификатор вызова, по которому будет показана информация об использованных в рамках вызова услугах.

Параметр <CallID> можно посмотреть в результате выполнения команды "list", первая колонка.

Пример:

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"