В данном разделе описываются команды управления сигнальной трассировкой вызова.
Трассировка сигнального трафика в рамках вызова предназначена для проверки корректности сигнализации на всех точках обмена сигнализацией, участвующих в вызове. Трассировка вызова может быть осуществлена как по номеру абонента, так и по интерфейсу, но только в рамках определенной виртуальной АТС. Один абонент одновременно может находиться в нескольких трассировках. При этом запись будет производиться всеми "писателями".
Для администратора системы команды выполняются в разделе /cluster/core/<CLUSTER>/tracer.
<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> — адрес, который будет использовать данную трассировку. Символ "*" используется для указания всех адресов (трассировка выполняется по интерфейсу)
<Name> — имя трассировки;
<Lifetime> — время жизни данного трейсера, в часах. По истечении данного времени трейсер будет автоматически удален.
<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 │ └────────┴───────────┴───────────┴─────┴───────┴──────────┴─────────┴────────────────────┘
Добавить комментарий