Трассировка звонков и сценариев

На этой странице

Данный объект предназначен для сбора логов по звонкам и сценариям.
Для звонков возможен сбор логов в форматах SVG, PlantUML, zip-архив. Сбор логов осуществляется по любому звонку, последний SIP пакет в котором был менее 10 минут назад. Система автоматически включает в выборку все связанные звонки (правое/левое плечо, переводы и т.д.)

Метод calls

Данные отображаются по всем звонкам (активным и завершенным), в рамках которых за последние 10 минут были SIP пакеты. Это основной метод получения информации по звонкам от системы, вне зависимости от того, был звонок успешным (разговор абонента А с абонентом B состоялся) или неуспешным.

Рис. 1. Метод calls

В ответе выводятся данные по каждой ноде, которая обслуживает звонок. Основные ключи Результата:

Название

Описание

srvidx

Идентификатор роли (roleid).

role

Тип роли.

node

Нода на которой запущена роль.

addr

Адрес ноды.

online

Доступность ноды для сбора статистики.

calls

Плечи звонков обслуживаемые ролью.

calls.callid

callid стороны А. Поле часто используется для последующего сбора логов по звонку.

calls.from

uri стороны А

calls.remoteip

Адрес стороны Б.

calls.tick

Timestamp (в мс) получения запроса.

calls.time

Время получения запроса.

calls.to

uri стороны Б.

calls.media

Данные об использовании медиа.

calls.media.mgc

Ключ роли mgc обслуживающей стороны звонка

calls.media.mgc_srvidx

Идентификатор роли (roleid) mgc.

calls.media.mgc_node

Нода mgc.

calls.media.mg

Ключ используемой роли mg.

calls.media.msid

Идентификатор sip-владельца медиа.

calls.media.ctx

Номер контекста.

Метод clear

Очистка таблиц звонков.

Используется для очистки таблиц перед совершением тестового звонка. Помогает быстро делать последующую выборку интересующего CallID из Метод calls

Метод closure

Отображение всех связанных CallID и ролей обслуживания с целевым.

Название

Описание

callid

Callid по которому происходит поиск соответствий

Список callID

Список Callid по которому происходит поиск соответствий (через ,)

Целевые показатели в ответе:

srvidx

Идентификатор роли (roleid).

role

Тип роли.

node

Нода на которой запущена роль.

addr

Адрес ноды.

online

Доступность ноды для сбора статистики.

closure

Список связанных callid в рамках роли.

Метод closure_total

Поиск связанных callid по всем sip-ролям системы, сгруппированные в один список

Название

Описание

callid

callid по которому происходит поиск соответствий

callids

Список callid по которому происходит поиск соответствий

Сайт

Фильтр по указанному сайту

Сервер

Фильтр по указанной роли. Возможные значения:

  • Id роли (целое число). Например, server=32 Адрес на котором поднята роль. Например, server=192.168.0.84

  • Полное имя ролевой ноды (RoleNodeName@IpAddr). Например, server=ws1@192.168.0.84

  • Имя ролевой ноды (RoleNodeName). Например, server=ws1

Серверы

Фильтр по указанным ролям. Возможные значения - * Id ролей (целое число). Например, server=32,33,34

Метод trn

Собирает все SIP пакеты по звонку (все форки и плечи звонка).
Основной метод получения лог-файлов по звонкам от системы.
Результат может быть выведен в:

  • zip-архив

  • визуальную диаграмму uml (SVG файл)

  • uml файл (plantUml файл)

Рис. 2. Метод trn

Название

Описание

Сallid для сбора логов

callid по которому происходит поиск соответствий trn

Список CallID для которых собрать логи

список callid по которому происходит поиск соответствий и сбор trn-логов всех звонков

Формат ответа

  • SVG диаграмма – страница содержащая plantuml диаграмма в формате svg

  • файл в формате plantuml - текстовый файл формата UML для дальнейшейго построения диаграммы

  • zip-архив trn логов - сбор файлов лога, упаковка в zip-архив и загрузка в браузер

На SVG диаграмме при нажатии на время пакета отображается текст SIP-пакета.

Метод trn_sec

Возвращает zip-архив содержащий TRN-логи по указанному CallId или списку со всех SIP ролей за последние N секунд.

Рис. 3. Метод trn_sec

Название

Описание

Глубина сбора trn-логов(сек)

Целое число секунд. Возможные значения: от 0 до 3600. По умолчанию: 0

Сallid для сбора логов

callid по которому происходит поиск соответствий trn

Список CallID для которых собрать логи

список callid по которому происходит поиск соответствий и сбор trn-логов всех звонков

Метод scripts

Сбор логов по сценариям указанного типа с ролей на текущем сайте.

Рис. 4. Метод scripts

Название

Описание

Тип сценария

Тип сценария по которому необходимо собрать логи. Возможные значения:

  • IVR - сбор логов по IVR сценариям

  • SVC - сбор логов по SVC сценариям

Начало (мин. назад)

С какого момента начать сбор логов (количество минут в прошлое от текущего момента)

Продолжительность

Продолжительность лога для сборки в минутах. Возможные значения от 1 до 1440

Код сценария

Код сценария по которому необходимо собрать логи. Если не указан, то сбор по всем сценариям указанного типа