В данном разделе описываются команды управления сигнальной трассировкой вызова.
Трассировка сигнального трафика в рамках вызова предназначена для проверки корректности сигнализации на всех точках обмена сигнализацией, участвующих в вызове. Трассировка вызова может быть осуществлена как по номеру абонента, так и по интерфейсу, но только в рамках определенной виртуальной АТС. Один абонент одновременно может находиться в нескольких трассировках. При этом запись будет производиться всеми "писателями".
Для администратора виртуальной АТС команды выполняются в разделе /domain/<DOMAIN>/tracer и применяются только для определенной виртуальной АТС.
Для администратора системы команды выполняются в разделе cluster/core/<CORE>/tracer/.
<CLUSTER> - имя кластера с ролью CORE.
declare
Данной командой создается новая трассировка вызова, которая будет выполнятся для вызовов заданной виртуальной АТС.
Путь команды:
domain/<DOMAIN>/tracer/declare
Синтаксис:
declare <NODE> <IFACE> | * <ADDRESS> | * <NAME> <LIFETIME> <TYPE_1> <ARGS_1> [<TYPE_2> <ARGS_2> ...]
Параметры:
<DOMAIN> - имя виртуальной АТС;
<NODE> - имя ноды кластера CORE, на которой будет выполняться данная трассировка (файл с трассировкой будет создан на заданной ноде);
<IFACE> - интерфейс, который будет использовать данную трассировку. Символ "*" используется для указания всех интерфейсов (трассировка выполняется по номеру абонента);
<ADDRESS> - адрес, который будет использовать данную трассировку. Символ "*" используется для указания всех адресов (трассировка выполняется по интерфейсу);
<NAME> - имя трассировки;
<LIFETIME> - время жизни данного трейсера, в часах. По истечении данного времени трейсер будет автоматически удален.
<TYPE> - тип N-го "писателя" трассировок:
- file - трассировка записывается в файл;
- UDP - трассировка передается в UDP-потоке;
- MySQL - трассировка передается в MySQL базу данных;
- XMPP - трассировка передается Jabber-клиенту.
<ARGS> - настройка N-го "писателя" данной трассировки. В зависимости от того, какой тип записи трассировки используется <TYPE>, параметры его инициализации будут различаться:
| <TYPE> | <ARGS> | Описание |
|---|---|---|
| file | <FILE> <MODE> | <FILE> - имя файла, в который будет записываться трассировка; <MODE> - тип перезаписи файла, если файл уже существует при старте трассировки: - write - режим переписывает существующий файл при перезапуске tts; - append - режим дописывает новые записи в конец файла. |
| 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> - имя БД, в которую будет записываться трассировка вызова. |
| XMPP | JID: <USER>@<HOST> | <USER> - имя пользователя Jabber-клиента; <HOST> - хост Jabber-клиента. |
Пример:
Создание трассировки номера 710 в домене p.city, и записи его в файл 710_trace.txt и в UDP поток.
ssw@[mycelium@ecss3]:/$> cluster/core/core1/tracer/declare p.city tts@ryabkov * 710 710_trace 2 UDP localhost:9999 file /var/log/710_trace.txt write Trace successfully declared. [exec at: 10.11.2011 15:15:37, exec time: 151ms]
remove
Данной командой удаляется созданная ранняя трассировка вызова.
Путь команды:
domain/<DOMAIN>/tracer/remove
Синтаксис:
remove <NAME>
Параметры:
<DOMAIN> - имя виртуальной АТС, в котором определена трассировка;
<NAME> - имя удаляемой трассировки.
Пример:
Удаление трассировки "710_trace".
ssw@[mycelium@ecss3]:/$> cluster/tts/tts3/tracer/remove p.city 710_trace Trace 710_trace successfully removed. [exec at: 10.11.2011 15:33:56, exec time: 108ms]
show
Данной командой можно просмотреть список созданных трассировок вызова и настройку их параметров.
Путь команды:
domain/<DOMAIN>/tracer/show
Синтаксис:
show [<NAME>]
Параметры:
<DOMAIN> - имя виртуальной АТС, в котором определена трассировка;
<NAME> - имя трассировки, опциональный параметр.
Пример:
Просмотр всех трассировок в домене p.city:
ssw@[mycelium@ecss3]:/$> cluster/core/core1/tracer/show p.city ------------------------------------------------------------------------------------------------- | Name | Node |Domain|Iface|Address| Create |Lifetime | Data providers | |---------+------------+------+-----+-------+----------+---------+------------------------------| |711_trace|сore@ryabkov|p.city|* | 711|19.03.2012|infinity |UDP data provider: | | | | | | |11:24:38 | | host: localhost | | | | | | | | | port: 8888 | |710_trace|core@ryabkov|p.city|* | 710|19.03.2012|2 hour(s)|File data provider: | | | | | | |11:25:06 | | path: /var/log/710_trace.txt| | | | | | | | | mode: write | | | | | | | | |UDP data provider: | | | | | | | | | host: localhost | | | | | | | | | port: 9999 | ------------------------------------------------------------------------------------------------- [exec at: 10.11.2011 15:35:10, exec time: 75ms]