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

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

## Метод calls

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

![](/files/-MIL2TiAtqVo78lYLyw-)

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

| **Название**            | **Описание**                                                                      |
| ----------------------- | --------------------------------------------------------------------------------- |
| 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 файл)

![](/files/-MIL2y2P7fiU-_h869h6)

| **Название**                           | **Описание**                                                                                                                                                                                                                                                                         |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Сallid для сбора логов                 | callid по которому происходит поиск соответствий trn                                                                                                                                                                                                                                 |
| Список CallID для которых собрать логи | список callid по которому происходит поиск соответствий и сбор trn-логов всех звонков                                                                                                                                                                                                |
| Формат ответа                          | <ul><li>SVG диаграмма – страница содержащая plantuml диаграмма в формате svg.</li><li>файл в формате plantuml - текстовый файл формата UML для дальнейшего построения диаграммы</li><li>zip-архив trn-логов - сбор файлов лога, упаковка в zip-архив и загрузка в браузер.</li></ul> |

{% hint style="info" %}
На SVG-диаграмме при нажатии на время пакета отображается текст SIP-пакета.
{% endhint %}

## Метод scripts

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

![](/files/-MIL3KB9aavsBYUwYnf2)

| **Название**        | **Описание**                                                                                                                                                                 |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Тип сценария        | <p>Тип сценария по которому необходимо собрать логи.<br>Возможные значения:</p><ul><li>IVR - сбор логов по IVR сценариям</li><li>SVC - сбор логов по SVC сценариям</li></ul> |
| Начало (мин. назад) | С какого момента начать сбор логов (количество минут в прошлое от текущего момента)                                                                                          |
| Продолжительность   | <p>Продолжительность лога для сборки в минутах. <br>Возможные значения от 1 до 1440.</p>                                                                                     |
| Код сценария        | <p>Код сценария по которому необходимо собрать логи. <br>Если не указан, то сбор по всем сценариям указанного типа</p>                                                       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.axatel.by/administrirovanie-telefonnoi-stancii/pr-monitoring/trassirovka-zvonkov-i-scenariev.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.