/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
┌───────────────┬──────────────────┬────────┬──────────┬──────────┬──────────┬──────────┬─┬─────┬───────────┬──┬─┬───────────────────────────┬─┬─┐
│ CallRef │ Start │ Stage │ Original │ Original │ CgPN │ CdPN │T│Durat│ Internal │IS│R│ Release │A│S│
│ │ │ │ CgPN │ CdPN │ │ │ │ ion │ cause │UP│I│ description │ │S│
│ │ │ │ │ │ │ │ │ │ │ca│ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │us│ │ │ │ │
│ │ │ │ │ │ │ │ │ │ │e │ │ │ │ │
├───────────────┼──────────────────┼────────┼──────────┼──────────┼──────────┼──────────┼─┼─────┼───────────┼──┼─┼───────────────────────────┼─┼─┤
│ 3758601696│26.02.2019 09:49:3│released│3832843034│ 246768│3832843034│ 246768│n│ 0s│notReachabl│18│S│termination side not respon│N│ │
│ │ 6 │ │ │ │ │ │ │ │ e │ │ │se │ │ │
│ 3938997342│26.02.2019 09:50:1│released│3832843034│ 246768│3832843034│ 246768│n│ 0s│ normal │16│C│Call is cancelled by initia│N│ │
│ │ 9 │ │ │ │ │ │ │ │ │ │g│tor │ │ │
│ 4140364133│26.02.2019 09:51:0│released│3854430486│ 245000│3854430486│ 245000│n│ 0s│ normal │16│C│Call is cancelled by initia│N│ │
│ │ 7 │ │ │ │ │ │ │ │ │ │g│tor │ │ │
│ 1736579392│26.02.2019 09:58:3│released│ 240101│ 058│3854240101│ 058│n│ 3s│ normal │16│C│Call is complete │Y│ │
│ │ 8 │ │ │ │ │ │ │ │ │ │g│ │ │ │
│ 1812626036│26.02.2019 09:58:5│released│3854416977│ 240101│3854416977│ 240101│n│ 20s│ normal │16│C│ISUP call is complete │Y│ │
│ │ 6 │ │ │ │ │ │ │ │ │ │g│ │ │ │
└───────────────┴──────────────────┴────────┴──────────┴──────────┴──────────┴──────────┴─┴─────┴───────────┴──┴─┴───────────────────────────┴─┴─┘
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: 26.02.2019 09:59:46, exec time: 92ms, nodes: core1@ecss1]
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 2 month Successfully removed 29 rows [exec at: 26.02.2019 10:34:21, exec time: 324ms, nodes: core1@ecss2]
show_ss
Данной командой выполняется просмотр информации об услугах, которые были использованы в рамках вызова.
Путь команды:
/domain/<DOMAIN>/calls/show_ss
Синтаксис:
show_ss --call_id <CallID>
Параметры:
<CallID> - идентификатор вызова, по которому будет показана информация об использованных в рамках вызова услугах.
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/calls/show_ss --call_id 440993490 ┌─────────┬─────┬──────┬────┬────────────┬───────────────────┬─────────┬──────────┐ │ CallRef │Name │ CgPN │CdPN│Participants│ Activated │Activator│ Action │ ├─────────┼─────┼──────┼────┼────────────┼───────────────────┼─────────┼──────────┤ │440993490│chold│240101│ │ │26.02.2019 10:27:41│ 240474│invocation│ └─────────┴─────┴──────┴────┴────────────┴───────────────────┴─────────┴──────────┘ [exec at: 26.02.2019 10:31:09, exec time: 75ms, nodes: core1@ecss1]
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 240502 Terminate correctly: 86ce07b3a031ae07 [exec at: 26.02.2019 11:01:27, exec time: 75ms, nodes: core1@ecss2]
Терминация всех вызовов:
admin@mycelium1@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: 0620d770a97b011f
[exec at: 19.09.2019 15:40:57, exec time: 7s 470ms, nodes: core1@ecss2]
После применения команды в cdr-записи повится код завершения 31, причина разрыва соединения: "Terminated by system administrator"