> For the complete documentation index, see [llms.txt](https://help.axatel.by/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.axatel.by/administrirovanie-telefonnoi-stancii/pr-monitoring/trassirovka-zvonkov-i-scenariev.md).
# Трассировка звонков и сценариев
Данный объект предназначен для сбора логов по звонкам и сценариям.\
Для звонков возможен сбор логов в форматах SVG, PlantUML, ZIP архив. Сбор логов осуществляется по любому звонку, последний SIP пакет в котором был менее 10 минут назад. Система автоматически включает в выборку все связанные звонки (правое/левое плечо, переводы и т.д.)
## Метод calls
Данные отображаются по всем звонкам (активным и завершенным), в рамках которых **за последние 10 минут** были SIP пакеты. Это основной метод получения информации по звонкам от системы, вне зависимости от того, был звонок успешным (разговор абонента А с абонентом B состоялся) или неуспешным.
В ответе выводятся данные по каждой ноде, которая обслуживает звонок. Основные ключи Результата:
| **Название** | **Описание** |
| ----------------------- | --------------------------------------------------------------------------------- |
| 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 | Номер контекста. |
## Метод trn
Собирает все SIP пакеты по звонку (все форки и плечи звонка).\
Основной метод получения лог-файлов по звонкам от системы.\
Результат может быть выведен в:
* zip архив
* визуальную диаграмму uml (SVG файл)
* uml файл (plantUml файл)
| **Название** | **Описание** |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Сallid для сбора логов | callid по которому происходит поиск соответствий trn |
| Список CallID для которых собрать логи | список callid по которому происходит поиск соответствий и сбор trn-логов всех звонков |
| Формат ответа | - SVG диаграмма – страница содержащая plantuml диаграмма в формате svg.
- файл в формате plantuml - текстовый файл формата UML для дальнейшего построения диаграммы
- zip-архив trn-логов - сбор файлов лога, упаковка в zip-архив и загрузка в браузер.
|
{% hint style="info" %}
На SVG-диаграмме при нажатии на время пакета отображается текст SIP-пакета.
{% endhint %}
## Метод scripts
Сбор логов по сценариям указанного типа с ролей на текущем сайте.
| **Название** | **Описание** |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Тип сценария | Тип сценария по которому необходимо собрать логи.
Возможные значения:
- IVR - сбор логов по IVR сценариям
- SVC - сбор логов по SVC сценариям
|
| Начало (мин. назад) | С какого момента начать сбор логов (количество минут в прошлое от текущего момента) |
| Продолжительность | Продолжительность лога для сборки в минутах.
Возможные значения от 1 до 1440.
|
| Код сценария | Код сценария по которому необходимо собрать логи.
Если не указан, то сбор по всем сценариям указанного типа
|