В данном разделе описаны команды, позволяющие просматривать и сохранять в файл трассировки вызовов.
Трассировка вызова - список сохраненных сообщений/событий, связанных с определенным вызовом. Одному вызову соответствует одна трассировка, которая состоит из множества сообщений (все связанные вызовы, если они есть, трассируются отдельно). |
Команда предназначена для просмотра списка вызовов на ECSS-10, для которых есть трассировка.
Путь команды:
/domain/<DOMAIN>/trace/list
Синтаксис:
list [--id <EndOfDialogID>] [--mode <MODE>] [–addr <NUMBER>] [--addr-a <NUMBER>] [--addr-b <NUMBER>] [--limit <LIMIT>]
Параметры:
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/list --limit 10
┌────────┬──────────┬───────────────────┬────────┬───────────┬───────────┬───────────┬──────────┬─┬────────┬────────────┬───────┬─┐
│Short ID│ CallRef │ Start │ Stage │ Original │ Original │ CgPN │ CdPN │M│Duration│ Release │ ISUP │F│
│ │ │ │ │ CgPN │ CdPN │ │ │ │ │ │release│ │
├────────┼──────────┼───────────────────┼────────┼───────────┼───────────┼───────────┼──────────┼─┼────────┼────────────┼───────┼─┤
│7b9590d4│2848689430│01.03.2021 20:54:47│released│79296786432│ 240696│79296786432│ 240696│n│ 0s│notReachable│ 20/0 │ │
│c87b4ca1│2869457863│01.03.2021 20:54:52│released│79296786432│ 240696│79296786432│ 240696│n│ 0s│notReachable│ 20/0 │ │
│38b7a5ae│2898833640│01.03.2021 20:54:59│released│79296786432│ 240696│79296786432│ 240696│n│ 0s│notReachable│ 20/0 │ │
│91189dd0│2923500032│01.03.2021 20:55:05│released│79296786432│ 240696│79296786432│ 240696│n│ 0s│notReachable│ 20/0 │ │
│e27f7f73│2944563368│01.03.2021 20:55:10│released│79296786432│ 240696│79296786432│ 240696│n│ 0s│notReachable│ 20/0 │ │
│d0a3655e│2940246997│01.03.2021 21:12:13│released│ 9017574612│ 246052│ 9017574612│ 246052│n│ 23s│normal │ 31/0 │ │
│f19b8c8e│3015806800│01.03.2021 21:12:31│released│ 240475│ 419145│ 3854240475│ 419145│n│ 5s│normal │ 16/0 │ │
│2c721e0a│3096209101│01.03.2021 21:12:50│released│ 240475│89913699011│ 3854240475│9913699011│n│ 15s│normal │ 16/0 │ │
│a49917a6│3666119754│01.03.2021 21:15:06│released│ 240475│89913699011│ 3854240475│9913699011│n│ 27s│normal │ 16/0 │ │
│33363890│3032690560│01.03.2021 21:29:39│offhook │ 9250210858│ 245866│ 9250210858│ 245866│n│ 10s│ │ │ │
└────────┴──────────┴───────────────────┴────────┴───────────┴───────────┴───────────┴──────────┴─┴────────┴────────────┴───────┴─┘
Legend:
M - mode
i - internal
n - normal
c - callback
s - supervise
a - acd
m - message
r - refer
F - flag show is call-process failed or not
* - call-procss failed
[empty] - call-procss active or successfully finished
Total call processes' records: 123
Selected call processes' records: 10
[exec at: 01.03.2021 21:29:49, exec time: 48ms, nodes: core1@ecss1 v.3.14.7.620] |
Пример 2.
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/list --id bcd769ee --release-description
┌────────┬──────────┬───────────────────┬────────┬──────────┬────────┬──────────┬──────┬─┬────────┬───────┬───────┬──────────────────────────────┬─┐
│Short ID│ CallRef │ Start │ Stage │ Original │Original│ CgPN │ CdPN │M│Duration│Release│ ISUP │ Release │F│
│ │ │ │ │ CgPN │ CdPN │ │ │ │ │ │release│ description │ │
├────────┼──────────┼───────────────────┼────────┼──────────┼────────┼──────────┼──────┼─┼────────┼───────┼───────┼──────────────────────────────┼─┤
│bcd769ee│2597113878│24.02.2021 20:34:35│released│4959664510│ 245452│4959664510│245452│n│ 24s│normal │ 16/0 │Call is cancelled by initiator│ │
└────────┴──────────┴───────────────────┴────────┴──────────┴────────┴──────────┴──────┴─┴────────┴───────┴───────┴──────────────────────────────┴─┘
Legend:
M - mode
i - internal
n - normal
c - callback
s - supervise
a - acd
m - message
r - refer
F - flag show is call-process failed or not
* - call-procss failed
[empty] - call-procss active or successfully finished
Total call processes' records: 4
Selected call processes' records: 1
[exec at: 24.02.2021 22:17:54, exec time: 24ms, nodes: core1@ecss1 v.3.14.7.617]
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/list --release-description --addr-a 4959664510
┌────────┬──────────┬───────────────────┬────────┬──────────┬────────┬──────────┬──────┬─┬────────┬───────┬───────┬──────────────────────────────┬─┐
│Short ID│ CallRef │ Start │ Stage │ Original │Original│ CgPN │ CdPN │M│Duration│Release│ ISUP │ Release │F│
│ │ │ │ │ CgPN │ CdPN │ │ │ │ │ │release│ description │ │
├────────┼──────────┼───────────────────┼────────┼──────────┼────────┼──────────┼──────┼─┼────────┼───────┼───────┼──────────────────────────────┼─┤
│bcd769ee│2597113878│24.02.2021 20:34:35│released│4959664510│ 245452│4959664510│245452│n│ 24s│normal │ 16/0 │Call is cancelled by initiator│ │
└────────┴──────────┴───────────────────┴────────┴──────────┴────────┴──────────┴──────┴─┴────────┴───────┴───────┴──────────────────────────────┴─┘
Legend:
M - mode
i - internal
n - normal
c - callback
s - supervise
a - acd
m - message
r - refer
F - flag show is call-process failed or not
* - call-procss failed
[empty] - call-procss active or successfully finished
Total call processes' records: 4
Selected call processes' records: 1
[exec at: 24.02.2021 22:20:53, exec time: 24ms, nodes: core1@ecss1 v.3.14.7.617]
|
Команда предназначена для просмотра медиа трассировок.
Путь команды:
/domain/<DOMAIN>/trace/media-topology
Синтаксис:
media-topology [<PARAMETERS>]
Параметры:
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/media-topology --Tl 1
-------------------------------------------------------------------------------------
TraceId: <<"METADATA">>
First message time: 01.01.1970 07:00:00
-------------------------------------------------------------------------------------
290. in: timer_rebuild_topology_awake 14:49:27:227 (2021/03/01 21:49:27:227)
-------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------
357. in: timer_rebuild_topology_awake 14:49:27:259 (2021/03/01 21:49:27:259)
-------------------------------------------------------------------------------------
┌──────────┐ ┌────────────────────┐ ┌───────────────┐
│ <player> │ │ <connection> │ │ <detector> │
│ CFC │ ──> │ o-leg: 79299541235 │ ──> │ DTMF detector │
└──────────┘ └────────────────────┘ └───────────────┘
∧
│
│
┌────────────────────┐
│ <player> │
└────────────────────┘
-------------------------------------------------------------------------------------
360. in: timer_rebuild_topology_awake 14:49:27:291 (2021/03/01 21:49:27:291)
-------------------------------------------------------------------------------------
┌──────────┐ ┌────────────────────┐ ┌───────────────┐
│ <player> │ │ <connection> │ │ <detector> │
│ CFC │ ──> │ o-leg: 79299541235 │ ──> │ DTMF detector │
└──────────┘ └────────────────────┘ └───────────────┘
∧
│
│
┌────────────────────┐
│ <player> │
└────────────────────┘
-------------------------------------------------------------------------------------
366. in: timer_rebuild_topology_awake 14:49:27:330 (2021/03/01 21:49:27:330)
-------------------------------------------------------------------------------------
┌──────────┐ ┌────────────────────┐ ┌───────────────┐
│ <player> │ │ <connection> │ │ <detector> │
│ CFC │ ──> │ o-leg: 79299541235 │ ──> │ DTMF detector │
└──────────┘ └────────────────────┘ └───────────────┘
∧
│
│
┌────────────────────┐
│ <player> │
└────────────────────┘
-------------------------------------------------------------------------------------
373. in: timer_rebuild_topology_awake 14:49:27:370 (2021/03/01 21:49:27:370)
-------------------------------------------------------------------------------------
┌──────────┐ ┌────────────────────┐ ┌───────────────┐
│ <player> │ │ <connection> │ │ <detector> │
│ CFC │ ──> │ o-leg: 79299541235 │ ──> │ DTMF detector │
└──────────┘ └────────────────────┘ └───────────────┘
∧
│
│
┌────────────────────┐
│ <player> │
└────────────────────┘
-------------------------------------------------------------------------------------
417. in: timer_rebuild_topology_awake 14:49:30:602 (2021/03/01 21:49:30:602)
-------------------------------------------------------------------------------------
┌──────────┐
│ <player> │
│ CFC │
└──────────┘
┌──────────┐
│ <player> │
└──────────┘
-------------------------------------------------------------------------------------
425. in: service_cp <<"064e94f7722e1a33">> 14:49:30:605 (2021/03/01 21:49:30:605)
-------------------------------------------------------------------------------------
{monitor_awake,service_cp,'biysk.local',<<"064e94f7722e1a33">>,
{dialog_monitor,{'biysk.local',service_cp,<<"064e94f7722e1a33">>}},
normal}
-------------------------------------------------------------------------------------
426. in: timer_rebuild_topology_awake 14:49:30:633 (2021/03/01 21:49:30:633)
-------------------------------------------------------------------------------------
┌──────────┐
│ <player> │
│ CFC │
└──────────┘
┌──────────┐
│ <player> │
└──────────┘
-------------------------------------------------------------------------------------
438. in: timer_rebuild_topology_awake 14:49:30:668 (2021/03/01 21:49:30:668)
-------------------------------------------------------------------------------------
┌──────────┐
│ <player> │
│ CFC │
└──────────┘
┌──────────┐
│ <player> │
└──────────┘
OK
[exec at: 01.03.2021 22:46:11, exec time: 621ms, nodes: core1@ecss1 v.3.14.7.620]
|
Команда предназначена для подчистки завершенных вызовов на ECSS-10. Команда удаляет трассировки ядра вне зависимости от текущего бэкэнда. Будут удалены трассировки соответствующие условиям как в режиме ETS так и в режиме DETS (Удаляются только те dets трассировки, которые лежат по стандартным путям и имеют расширение .dets).
Открытые ETS трассировки игнорируются. Открытые Dets трассировки будут удалены.
| Команда не запрашивает подтверждение на удаление! |
Путь команды:
/domain/<DOMAIN>/trace/purge
Чтобы не удалять все трассировки, существуют определенные флаги:
Параметры:
При указании флагов --Te и --Tb вместе, поиск нужной трассировки осуществляется по шаблону <Template Begin>*<Template End>. Другими словами, если значения флагов пересекаются (к примеру указано полное имя трассировки в каждом флаге), то трассировка найдена не будет.
Остальные флаги полностью совместимы друг с другом. Ввод одного флага лишь включает соответствующий ему фильтр.
Значение флагов --t и --c не может быть отрицательным.
--с считает все трассировки (включая открытые) и Dets-трассировки расположенные по корректным путям (ручное сохранение трассировок, если оно не попадает под каноничный формат, игнорируется).
Для флага --t, время ETS трассировки - время её закрытия (release_time). Для Dets, если её нет в Actuals calls list - час создания (start_time)
| Start -> --Te / --Tb -> --r -> --t -> --c -> Purge |
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/purge --Te 5988fd89 Successfully removed records: 1 [exec at: 24.02.2021 22:46:28, exec time: 28ms, nodes: core1@ecss1 v.3.14.7.617] |
Команда предназначена для просмотра трассировок маршрутизации вызова.
Путь команды:
/domain/<DOMAIN>/trace/route
Синтаксис:
route [--Te <TemplateEnd> | --Tl <TraceNumber> | --file <Node> <Filename>]
Параметры:
Примеры:
Вывод трассировки маршрутизации последнего вызова:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/route --Tl 1 |
Вывод трассировки маршрутизации вызова из dets файла:
|
Команда предназначена для сохранения сигнальной трассировки вызова в файл.
Путь команды:
/domain/<DOMAIN>/trace/save-trace
Синтаксис:
save-trace [--Tb <BeginPattern>| --Te <EndPattern> | --Tl <CallNumber>] | [--text | --dets] --file <host> <filename> [--force]
Параметры:
|
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/save-trace --dets --Te 33363890 --file ecss1 2021_03_01/21-00/trace2.dets ok [exec at: 01.03.2021 21:41:43, exec time: 60ms, nodes: core1@ecss1 v.3.14.7.620] |
Команда предназначена для сохранения медиа трассировки вызова в файл.
Путь команды:
/domain/<DOMAIN>/trace/save-media
Синтаксис:
save-media --Te <EndPattern> [--filename <host> <filename>]
Параметры:
Примечание. Сохранение медиа трассировки в файл производится по пути: {DATA-ROOT}/cp/<DOMAIN>>/traces. По умолчанию - /var/lib/ecss/cp/<DOMAIN>/traces/. |
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/save-media --Te a49917a6 --file ecss1 240475_media.dets Trace saved succesfull. [exec at: 01.03.2021 21:44:13, exec time: 149ms, nodes: core1@ecss1 v.3.14.7.620] |
Команда предназначена для сохранения всех сигнальных и/или медиа трассировок вызовов в директорию или архив.
Путь команды:
/domain/<DOMAIN>/trace/dump
Синтаксис:
dump [<Filename>] [-a | --archive|-d|--directory] [-m|--with-media] [-u|--uncompress] [-n <Node>] [–force]
Параметры:
Примечание 1. Сохранение дампа трассировок в архив/директорию производится по пути: {DATA-ROOT}/cp/<DOMAIN>>/traces/<Filename>. По умолчанию - /var/lib/ecss/cp/<DOMAIN>/traces/<Filename>. |
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/dump -u -m -u <<"064e94e956ff4254">> OK [1/2] Saving media trace... <<"064e94e956ff4254">> OK [2/2] DONE Traces has been saved in "/var/lib/ecss/cp/biysk.local/traces/dump_2021_03_01_21_47_02" Media traces has been saved in "/var/lib/ecss/cp/biysk.local/traces/dump_2021_03_01_21_47_02/media" [exec at: 01.03.2021 21:47:02, exec time: 277ms, nodes: core1@ecss1 v.3.14.7.620] |
Пример 2:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/dump -a -u -m -u <<"064e94e956ff4254">> OK [1/2] Saving media trace... <<"064e94e956ff4254">> OK [2/2] DONE Traces has been saved in "/var/lib/ecss/cp/biysk.local/traces/dump_2021_03_01_21_47_56.tar" [exec at: 01.03.2021 21:47:56, exec time: 431ms, nodes: core1@ecss1 v.3.14.7.620] |
Данной командой выполняется просмотр трассировки по вызовам на ECSS-10.
Путь команды:
/domain/<DOMAIN>/trace/show
Синтаксис:
show [--Te <TemplateEnd> | --Tl <TraceNumber> | --file <Node> <Filename>] [--amqp | --trike | --ccp <Module> | --all] [--Bid <BranchId> | --Oid <ObjectId>] [--payload | --short-payload [--show-sdp | --timers]] [--desired all | <Number>] [--condition <Condition>]
Параметры:
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/trace/show --short-payload --Tl 1 --timers
Current release: 3.14.7.620
Trace id: <<"064e94e956ff4254">>
First message time: 2021/03/01 21:45:41
1. 0 00:00:00:000 891508 i SetupInd smg-4 A:9264374787,B:245888,sdp_o
2. 0 00:00:00:005 n Notification {branch_next,main}
3. 0 00:00:00:006 o Timer start o_heartbeat_send 1h
4. 0 00:00:00:006 o Timer start o_heartbeat_receive 1h 6m
5. 0 00:00:00:006 891508 o SetupIndAck smg-4
6. 0 00:00:00:008 o Timer start fill_seizure_timeout 2s
7. 0 00:00:00:011 n Notification {{leg,o},call_id,<<"1614-609970-893632">>}
8. 0 00:00:00:011 n Notification {{leg,o},{zone,"default"},{site,"local"},{profile,"default"}}
9. 0 00:00:00:012 n Notification o dtmf transmit type: transit
10. 0 00:00:00:012 n Notification o dtmf receive type: auto
11. 0 00:00:00:018 o Timer cancel fill_seizure_timeout 0s
12. 0 00:00:00:020 o Timer start router_resp_timeout 5s
13. 0 00:00:00:061 o Timer cancel router_resp_timeout 0s
14. 0 00:00:00:078 n Notification t dtmf receive type: auto
15. 0 00:00:00:078 n Notification t dtmf transmit type: transit
16. 0 00:00:00:080 n Notification {{leg,t},{zone,"default"},{site,"local"},{profile,"default"}}
17. 0 00:00:00:080 o Timer start o_no_answer_timeout 5m
18. 0 00:00:00:080 o Timer start no_answer_timeout 1m
19. 0 00:00:00:114 n Notification {{leg,t},contact,bh,"bond1.2@192.168.2.21?22abcd"}
20. 0 00:00:00:122 n Notification {{leg,t},invite_bh_answer}
21. 0 00:00:00:133 o Timer start bh_timeout 200ms
22. 0 00:00:00:133 o Timer start response_ack_timeout 6s
23. 0 00:00:00:133 891508 o SetupReq ems1 A:9264374787,B:245888,sdp_o
24. 0 00:00:00:146 891508 i SetupReqAck ems1
25. 0 00:00:00:156 o Timer start t_heartbeat_send 1h
26. 0 00:00:00:156 o Timer start t_heartbeat_receive 1h 6m
27. 0 00:00:00:156 o Timer cancel response_ack_timeout 0s
28. 0 00:00:00:156 o Timer start response_timeout 25s
29. 0 00:00:00:334 i Timer awake bh_timeout 200ms
[exec at: 01.03.2021 21:45:44, exec time: 129ms, nodes: core1@ecss1 v.3.14.7.620] |
Все трассировки находятся в хранилищах трассировок. Количество хранилищ однозначно не регламентировано, и может варьироваться вместе с масштабированием ядра ESCC-1.