Call Storage (callstore)

Описание

Хранилище активных звонков и их контекстов.

Накапливает и агрегирует события жизненного цикла звонка.
Отслеживает диалоги и дополняет поток событий в случае падения процесса или сервера, обслуживающего диалог.
Формирует и сохраняет комплексную CDR в коллекцию модели данных `cdr/COPM3_dialogs` мастер-домена.
Путем доработки может быть дополнена сохранением данных, например, об инициированных звонках (invites), вызовах (forks), удержаниях (holds) и расширенных диалогах и связях между ними.

Разделена на микросервисы по доменам. Данные автоматически синхронизируются между сайтами, обслуживающими домен.
Резервируется в режиме Active-Passive. Масштабируется разделением доменного дерева.

Table 1. Системные характеристики

Код

callstore

Режим работы

Хранилище

Режим резервирования

Active-Passive

Типы сайтов

Любые

Слой

Бизнес-логика

Размещение

Внутренний

Сохранение и восстановление состояния при перезагрузке

Да

Приложение

era_callstore

Собственное хранилище

ODB Mnesia

Параметры

Описание столбцов в таблице

Table 2. Параметры
Имя Тип Умолчание Описание

name

str

required

Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.

roletype

str

required

Тип роли. Возможные значения: "callstore".

iface

str

required

Алиас сетевого интерфейса сервера, на котором будет происходить внутреннее взаимодействие ролей между собой.

ext

json

empty

Дополнительные опции роли. Содержит json объект или список.

enabled

bool

empty

Флаг активности роли. При установке в false роль не участвует в валидации и не запускается.

group

int

required

Номер группы.
В рамках горизонтального масштабирования роль может быть разделена на несколько групп на сайте, в каждой из которых активен только один экземпляр, остальные зарезервированы.
Ответственность между группами разделяется по доменным множествам. Вместе все группы обслуживают полное доменное множество. Все роли одной группы должны иметь одинаковую ответственность.
Целое число от 1 до 9999999.

order

int

required

Порядок экземпляра роли в рамках группы.
Определяет в каком порядке будет происходить перетекание в режиме Active-Passive.

include_domains

array<str>

empty

Список имен доменов, которые обслуживает данная группа.
Может быть указан любой домен любого уровня. Указание домена приводит к тому, что дерево его поддоменов будет обслуживаться на этой группе и не будет обслуживаться на других группах роли, исключая только те ветви, которые упомянуты в других группах.
В совокупности все группы роли на сайте обслуживают полное дерево доменов.

cdr_enabled

bool

true

Выключатель режима отслеживания CDR всех вызовов.
Режим позволяет:

  • мониторить доступность диалогов всех звонков, а в случае их сбоев генерировать события о падении, следить за активностью RTP и своевременно отправлять команду на микширование записи ставшего недоступным диалога.

  • готовить комплексную информацию по вызовам - одну для каждого вызова - для дальнейшего размещения в коллекции 'cdr/COPM3/dialogs'.

sorm3_enabled

bool

false

Выключатель операции создания и размещения в коллекции 'cdr/COPM3/dialogs' агрегированной информации по каждому вызову.
Имеет значимость только при включенном режиме 'cdr_enabled'.

sip_restore_enabled

bool

false

Выключатель режима восстановления SIP-диалогов при обнаружении недоступности внутренних SIP-серверов.
Режим работает через функции callmanager, организовывая вызов с подменой (INVITE+Replaces) обоим абонентам.
В случае неудачи производится несколько попыток вызова плеча.
Если от абонента получен ответ 481 (отказ от подмены по причине отсутствия подменяемого диалога), осуществляется новый вызов абонента в режиме Intercom.
В результате восстановления формируется новый диалог.

Необходима включенная опция 'cdr_enabled'.
Необходимо наличие в конфигурации альтернативных активных экземпляров недоступных микросервисов.
Необходима настроенная конфигурация с переподключением SIP-устройств к альтернативным активным экземплярам SG.
Необходима настроенная конфигурация, одновременно поддержанная устройством аплинка (SBC), с перетеканием обслуживания учетной записи провайдера на резервный экземпляр ESG.

В случае, если оказывается недоступен связанный со звонком микросервис ESG, то при наличии резервного в сторону аплинка (за учетной записью провайдера) также отпраляется INVITE+Replaces.
Учетная запись провайдера при этом может ограничивать опцией opts.sip_restore_mode режимы переподключения абонента путем отправки INVITE в сторону аплинка.

mnesia_storage_mode

str

disc "Режим работы объектного хранилища.

Возможные варианты:

* disc - полный режим

в оперативной памяти с сохранением на диск на всех экземплярах группы.

  • ram - только в оперативной памяти (с поддержкой распределенности

транзакций). При одновременной перезагрузке/выключении всех экземпляров группы данные теряются.

Пример конфигурации

Управление конфигурацией производится в приложении, доступном для администраторов мастер-домена. Приложение скрывает полное содержание конфигурации, однако тем не менее оно доступно через API.

Конфигурация содержит раздел для описания всех экземпляров всех ролей. Параметры определяются для каждого конкретного экземпляра роли.

Пример узла
{
  "name": "callstore1",
  "roletype": "callstore",

  "group": 11010,
  "order": 1,

  "include_domains": []
}

См. также

  • Персонализация
  • Увеличить шрифт
  • Уменьшить шрифт