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

Трассировка сигнального трафика в рамках вызова предназначена для проверки корректности сигнализации на всех точках обмена сигнализацией, участвующих в вызове. Трассировка вызова может быть осуществлена как по номеру абонента, так и по интерфейсу, но только в рамках определенной виртуальной АТС. Один абонент одновременно может находиться в нескольких трассировках. При этом запись будет производиться всеми "писателями".

Для администратора системы команды выполняются в разделе /cluster/core/<CLUSTER>/tracer.

<DOMAIN> — имя виртуальной АТС.
<CLUSTER> — имя кластера с ролью CORE.


Трассировка вызова является ресурсоемкой операцией. Не забывайте выключать трассировку, когда она не используется.

declare

Данной командой создается новая трассировка вызова, которая будет выполнятся для вызовов заданной виртуальной АТС.

Путь команды:

/cluster/core/<CLUSTER>/tracer/declare

Синтаксис:

declare <DOMAIN> <NODE> <IFACE> | * <ADDRESS> | * <NAME> <LIFETIME> <TYPE_1> <ARGS_1> [<TYPE_2> <ARGS_2> ...]

./declare <Domain> <Node> <Iface> | * <Address> | * <Name> <Lifetime> <DataProviderType_1> <DataProviderArgs_1> [<DataProviderType_2> <DataProviderArgs_2> ...]

Параметры:

<Domain> — имя виртуальной АТС;
<Node> — имя ноды кластера CORE, на которой будет выполняться данная трассировка (файл с трассировкой будет создан на заданной ноде);
<Iface> — интерфейс, который будет использовать данную трассировку. Символ "*" используется для указания всех интерфейсов (трассировка выполняется по номеру абонента);
<Address> — адрес, который будет использовать данную трассировку. Символ "*" используется для указания всех адресов (трассировка выполняется по интерфейсу)

В одной трассировке только один из параметров <IFACE>, <ADDRESS> может принимать значение "*".

<Name> — имя трассировки;
<Lifetime> — время жизни данного трейсера, в часах. По истечении данного времени трейсер будет автоматически удален.

Параметр может принимать значение infinity — трейсер не будет автоматически удаляться, но если он будет "жить" более одного дня, будет сгенерировано информационное сообщение.

<DataProviderType> — тип N-го "писателя" трассировок:

  • file — трассировка записывается в файл;
  • homer — трассировка передается в homer;
  • UDP — трассировка передается в UDP-потоке;
  • MySQL — трассировка передается в MySQL базу данных.

<DataProviderArgs> — настройка N-го "писателя" данной трассировки. В зависимости от того, какой тип записи трассировки используется <TYPE>, параметры его инициализации будут различаться:

Таблица 1. Виды "писателей" трассировок

<TYPE><ARGS>Описание
file<FILE> <MODE><FILE> — имя файла, в который будет записываться трассировка;
<MODE> — тип перезаписи файла, если файл уже существует при старте трассировки:
- write — режим переписывает существующий файл при перезапуске tts;
- append — режим дописывает новые записи в конец файла.
homer<HOST>:<PORT>

<HOST> — имя хоста, на котором запущен homer;

<PORT> — имя порта, на котором запущен homer;

Homer — сервер, принимающий данные по протоколу HEP

UDP<HOST>:<PORT><HOST> — имя хоста, на котором поднят UDP-слушатель;
<PORT> — имя порта, на котором поднят UDP-слушатель;
UDP-слушателя на "localhost" можно поднять командой: socat - udp-listen:<Port>,reuseaddr,fork
MySQL<NAME> <PASSWD> <HOST>:<PORT> <DB><USER> — имя пользователя, под которым будут производиться записи в БД;
<PASSWD> — пароль пользователя, под которым будут производиться записи в БД;
<HOST> — хост, на котором поднята MySQL БД;
<PORT> — порт, на котором поднята MySQL БД;
<DB> — имя БД, в которую будет записываться трассировка вызова.




Пример:

Создание трассировки номера 240101 в домене biysk.local, и записи его в  UDP поток.

admin@mycelium1@ecss1:/$ cluster/core/core1/tracer/declare biysk.local core1@ecss1 * 240101 trace101 1 UDP 192.168.1.12:9999
Trace successfully declared.

remove

Данной командой удаляется созданная ранняя трассировка вызова.

Путь команды:

/cluster/core/<CLUSTER>/tracer/remove

Синтаксис:

remove <DOMAIN> <NAME>

Параметры:

<DOMAIN> — имя виртуальной АТС, в котором определена трассировка;
<NAME> — имя удаляемой трассировки.

Пример:

Удаление трассировки "trace101":

admin@mycelium1@ecss1:/$ cluster/core/core1/tracer/remove biysk.local trace101
Trace trace101 successfully removed.

show

Данной командой можно просмотреть список созданных трассировок вызова и настройку их параметров.

Путь команды:

/cluster/core/<CLUSTER>/tracer/show

Синтаксис:

show [<DOMAIN> [<NAME>]]

Параметры:

<DOMAIN> — имя виртуальной АТС, в котором определена трассировка;
<NAME> — имя трассировки, опциональный параметр.

Пример:

Просмотр всех трассировок во всех доменах:

admin@mycelium1@ecss1:/$ cluster/core/core1/tracer/show                                                                                  
┌────────┬───────────┬───────────┬─────┬───────┬──────────┬─────────┬────────────────────┐
│  Name  │   Node    │  Domain   │Iface│Address│  Create  │Lifetime │   Data providers   │
├────────┼───────────┼───────────┼─────┼───────┼──────────┼─────────┼────────────────────┤
│trace101│core1@ecss1│biysk.local│*    │ 240101│10.03.2021│1 hour(s)│UDP data provider:  │
│        │           │           │     │       │10:36:07  │         │  host: 192.168.1.12│
│        │           │           │     │       │          │         │  port: 9999        │
└────────┴───────────┴───────────┴─────┴───────┴──────────┴─────────┴────────────────────┘